chrome.system.display

Beschreibung

Verwenden Sie die system.display API, um Anzeigemetadaten abzufragen.

Berechtigungen

system.display

Typen

ActiveState

Chrome 117 oder höher

Ein Enum-Wert, der angibt, ob die Anzeige vom System erkannt und verwendet wird. Das Display gilt als „inaktiv“, wenn es vom System nicht erkannt wird (möglicherweise getrennt oder aufgrund des Ruhemodus als getrennt angesehen). Dieser Status wird verwendet, um beispielsweise den vorhandenen Bildschirm beizubehalten, wenn alle Bildschirme getrennt sind.

Enum

Bounds

Attribute

  • Höhe

    Zahl

    Die Höhe der Anzeige in Pixeln.

  • links

    Zahl

    Die X-Koordinate der oberen linken Ecke.

  • oben

    Zahl

    Die Y-Koordinate der oberen linken Ecke.

  • Breite

    Zahl

    Die Breite der Anzeige in Pixeln.

DisplayLayout

Chrome 53 und höher

Attribute

  • id

    String

    Die eindeutige ID der Anzeige.

  • kompensiert

    Zahl

    Der Abstand der Anzeige entlang der verbundenen Kante. 0 bedeutet, dass die obere bzw. linke Ecke aufeinander ausgerichtet ist.

  • parentId

    String

    Die eindeutige ID der übergeordneten Anzeige. Leer, wenn dies der Stamm ist.

  • position

    Die Layoutposition dieser Anzeige relativ zur übergeordneten Datei. Dies wird für den Stamm ignoriert.

DisplayMode

Chrome 52 und höher

Attribute

  • deviceScaleFactor

    Zahl

    Der Skalierungsfaktor des Geräts im Anzeigemodus.

  • Höhe

    Zahl

    Die Höhe des Anzeigemodus in geräteunabhängigen (für den Nutzer sichtbaren) Pixeln.

  • heightInNativePixels

    Zahl

    Die Höhe des Anzeigemodus in nativen Pixeln.

  • isInterlaced

    Boolescher Wert optional

    Chrome 74 und höher

    „True“, wenn dieser Modus verschachtelt ist, „false“, wenn er nicht angegeben ist.

  • isNative

    boolean

    Dieser Wert ist „True“, wenn es sich um den nativen Modus der Anzeige handelt.

  • isSelected

    boolean

    „True“, wenn derzeit der Anzeigemodus ausgewählt ist.

  • refreshRate

    Zahl

    Chrome 67 oder höher

    Die Aktualisierungsrate des Anzeigemodus in Hertz.

  • uiScale

    Nummer optional

    Seit Chrome 70 eingestellt

    displayZoomFactor“ verwenden

    Der Skalierungsfaktor der Benutzeroberfläche im Anzeigemodus.

  • Breite

    Zahl

    Die Breite des Anzeigemodus in geräteunabhängigen (für den Nutzer sichtbaren) Pixeln.

  • widthInNativePixels

    Zahl

    Die Breite des Anzeigemodus in nativen Pixeln.

DisplayProperties

Attribute

  • boundsOriginX

    Nummer optional

    Aktualisiert den Ursprung der logischen Grenzen der Anzeige entlang der X-Achse. Gemeinsam mit boundsOriginY angewendet. Wenn kein Wert festgelegt und boundsOriginY festgelegt ist, wird standardmäßig der aktuelle Wert verwendet. Beachten Sie, dass beim Aktualisieren des Anzeigeursprungs einige Einschränkungen angewendet werden, sodass der Ursprung der endgültigen Grenzen von dem einen Satz abweichen kann. Die endgültigen Grenzen können mithilfe von getInfo abgerufen werden. Der Ursprung des Bereichs kann in der primären Anzeige nicht geändert werden.

  • boundsOriginY

    Nummer optional

    Aktualisiert den Ursprung der logischen Grenzen der Anzeige entlang der Y-Achse. Weitere Informationen zum Parameter boundsOriginX finden Sie in der Dokumentation.

  • displayMode

    DisplayMode optional

    Chrome 52 und höher

    Wenn festgelegt, wird der Anzeigemodus auf den Modus aktualisiert, der diesem Wert entspricht. Wenn andere Parameter ungültig sind, wird diese Einstellung nicht angewendet. Wenn der Anzeigemodus ungültig ist, wird er nicht angewendet und es wird ein Fehler ausgegeben. Andere Eigenschaften werden aber trotzdem angewendet.

  • displayZoomFactor

    Nummer optional

    Chrome 65 und höher

    Wenn festgelegt, wird der Zoom des Displays aktualisiert. Bei diesem Zoom werden das Layout und die Darstellung neu gezeichnet, was zu einer besseren Zoomqualität führt als die bloße Streckvergrößerung (Pixel für Pixel).

  • isPrimary

    Boolescher Wert optional

    Ist die Richtlinie auf „true“ gesetzt, wird das Display als primär dargestellt. No-Op, wenn auf „false“ gesetzt. Hinweis: Wenn diese Richtlinie festgelegt ist, wird die Anzeige für alle anderen Properties als primär eingestuft. Das heißt, isUnified kann festgelegt sein und der Ursprung des begrenzten Bereichs nicht.

  • isUnified

    Boolescher Wert optional

    Chrome 59 und höher

    Nur ChromeOS. Ist die Richtlinie auf „true“ gesetzt, wird der Anzeigemodus in „Unified Desktop“ geändert. Weitere Informationen finden Sie unter enableUnifiedDesktop. Ist sie auf „false“ gesetzt, wird der Unified Desktop-Modus deaktiviert. Dies gilt nur für das Hauptdisplay. Falls angegeben, darf mirroringSourceId nicht angegeben werden. Andere Attribute werden ignoriert. Wird kein Wert angegeben, hat dies keine Auswirkungen.

  • mirroringSourceId

    String optional

    Seit Chrome 68 eingestellt

    Verwenden Sie setMirrorMode.

    Nur ChromeOS. Wenn festgelegt und nicht leer, wird die Spiegelung nur für diese Anzeige aktiviert. Andernfalls wird die Spiegelung für alle Bildschirme deaktiviert. Dieser Wert sollte die ID der zu spiegelnden Quellanzeige angeben, die nicht mit der ID übereinstimmen darf, die an „setDisplayProperties“ übergeben wird. Wenn festgelegt, kann keine andere Eigenschaft festgelegt werden.

  • Overscan

    Einsätze optional

    Falls festgelegt, werden die Overscan-Einsätze der Anzeige auf die angegebenen Werte gesetzt. Overscan-Werte dürfen nicht negativ oder größer als die Hälfte der Bildschirmgröße sein. Overscan kann auf dem internen Monitor nicht geändert werden.

  • Drehung

    Nummer optional

    Wenn festgelegt, wird die Displaydrehung aktualisiert. Zulässige Werte sind [0, 90, 180, 270]. Die Drehung wird relativ zur vertikalen Position des Displays im Uhrzeigersinn eingestellt.

DisplayUnitInfo

Attribute

  • activeState
    Chrome 117 oder höher

    Aktiv, wenn das Display vom System erkannt und verwendet wird.

  • availableDisplayZoomFactors

    Nummer[]

    Chrome 67 oder höher

    Eine Liste von Zoomfaktorwerten, die für die Anzeige festgelegt werden können.

  • Grenzen

    Die logischen Grenzen der Anzeige.

  • displayZoomFactor

    Zahl

    Chrome 65 und höher

    Das Verhältnis zwischen dem aktuellen und dem Standardzoom des Displays. Beispielsweise entspricht der Wert 1 einer Zoomstufe von 100% und der Wert 1,5 einer Zoomstufe von 150 %.

  • dpiX

    Zahl

    Die Anzahl der Pixel pro Zoll entlang der X-Achse.

  • dpiY

    Zahl

    Die Anzahl der Pixel pro Zoll entlang der y-Achse.

  • Edid

    Edid optional

    Chrome 67 oder höher

    HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

  • hasTouchSupport

    boolean

    Chrome 57 und höher

    „True“, wenn diesem Display ein Gerät zur Eingabe per Berührung zugeordnet ist.

  • id

    String

    Die eindeutige ID der Anzeige.

  • isEnabled

    boolean

    „True“, wenn dieses Display aktiviert ist.

  • isPrimary

    boolean

    „True“, wenn dies der primäre Bildschirm ist.

  • isUnified

    boolean

    Chrome 59 und höher

    „True“ für alle Bildschirme im Unified Desktop-Modus. Weitere Informationen finden Sie in der Dokumentation zu enableUnifiedDesktop.

  • mirroringDestinationIds

    String[]

    Chrome 64 und höher

    Nur ChromeOS. IDs der Bildschirme, auf denen die Quellanzeige gespiegelt wird. Leer, wenn keine Bildschirme gespiegelt werden. Dieser wird für alle Displays auf denselben Wert festgelegt. mirroringSourceId darf nicht enthalten sein.

  • mirroringSourceId

    String

    Nur ChromeOS. ID des Bildschirms, der gespiegelt wird, wenn die Spiegelung aktiviert ist, andernfalls leer. Diese Einstellung wird für alle Displays festgelegt (einschließlich des gespiegelten Displays).

  • modes
    Chrome 52 und höher

    Die Liste der verfügbaren Anzeigemodi. Der aktuelle Modus lautet „isSelected=true“. Nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf ein leeres Array festgelegt.

  • name

    String

    Der benutzerfreundliche Name (z. B. „HP LCD-Monitor“)

  • Overscan

    Die Einfügungen des Bildschirms innerhalb der Bildschirmgrenzen. Derzeit nur unter ChromeOS verfügbar. Auf anderen Plattformen werden leere Werte verwendet.

  • Drehung

    Zahl

    Die Drehung des Displays im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Auf anderen Plattformen auf 0 gesetzt. Ein Wert von -1 wird als automatisches Drehen interpretiert, wenn sich das Gerät im Zustand eines Tablets befindet.

  • workArea

    Der nutzbare Arbeitsbereich der Anzeige innerhalb der Anzeigegrenzen. Der Arbeitsbereich schließt Bereiche des Bildschirms aus, die für das Betriebssystem reserviert sind, z. B. die Taskleiste und der Launcher.

Edid

Chrome 67 oder höher

Attribute

  • manufacturerId

    String

    3-stelliger Herstellercode. Siehe Abschnitt 3.4.1, Seite 21. Erforderlich in Version 1.4.

  • productId

    String

    2-Byte-Code vom Hersteller, Abschnitt 3.4.2, Seite 21. Erforderlich in Version 1.4.

  • yearOfManufacture

    Zahl

    Herstellerjahr, Abschnitt 3.4.4, Seite 22. Erforderlich in Version 1.4.

GetInfoFlags

Chrome 59 und höher

Attribute

  • singleUnified

    Boolescher Wert optional

    Wird die Richtlinie auf „true“ gesetzt, wird im Unified Desktop-Modus nur ein einzelnes DisplayUnitInfo-Element von getInfo zurückgegeben (siehe enableUnifiedDesktop). Die Standardeinstellung ist „false“.

Insets

Attribute

  • unten

    Zahl

    Der Abstand der Y-Achse von der unteren Grenze.

  • links

    Zahl

    Der Abstand der x-Achse von der linken Grenze.

  • rechts

    Zahl

    Der Abstand der x-Achse von der rechten Grenze.

  • oben

    Zahl

    Der Abstand der y-Achse von der oberen Grenze.

LayoutPosition

Chrome 53 und höher

Layoutposition, d.h. der Rand des übergeordneten Elements, an dem der Bildschirm befestigt ist.

Enum

MirrorMode

Chrome 65 und höher

Spiegelmodus, d.h. verschiedene Möglichkeiten, wie ein Bildschirm mit anderen Displays gespiegelt wird.

Enum

"off"
Gibt den Standardmodus an (erweiterter oder Unified Desktop-Modus).

"normal"
Gibt an, dass die standardmäßige Quellanzeige auf allen anderen Displays gespiegelt wird.

"mixed"
Gibt an, dass die angegebene Quellanzeige auf den bereitgestellten Zielbildschirmen gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.

MirrorModeInfo

Chrome 65 und höher

Attribute

  • mirroringDestinationIds

    string[] optional

    Die IDs des Spiegelungsziels werden angezeigt. Dies gilt nur für „gemischt“.

  • mirroringSourceId

    String optional

    Die ID der Anzeige der gespiegelten Quelle. Dies gilt nur für „gemischt“.

  • Modus

    Der Spiegelungsmodus, der festgelegt werden soll.

Point

Chrome 57 und höher

Attribute

  • x

    Zahl

    Die X-Koordinate des Punkts.

  • y

    Zahl

    Die Y-Koordinate des Punkts.

TouchCalibrationPair

Chrome 57 und höher

Attribute

  • displayPoint

    Die Koordinaten des Anzeigepunkts.

  • touchPoint

    Die Koordinaten des Berührungspunkts, der dem Anzeigepunkt entspricht.

TouchCalibrationPairQuad

Chrome 57 und höher

Attribute

  • Für die Touch-Kalibrierung sind das erste Touch- und der Displaypunkt-Paar erforderlich.

  • Für die Touch-Kalibrierung ist ein zweites Paar Touch- und Displaypunkt erforderlich.

  • Für die Touch-Kalibrierung ist ein drittes Paar Touch- und Displaypunkt erforderlich.

  • Ein viertes Paar Touch- und Displaypunkt für die Touch-Kalibrierung.

Methoden

clearTouchCalibration()

Chrome 57 und höher
chrome.system.display.clearTouchCalibration(
  id: string,
)

Setzt die Touch-Kalibrierung für das Display zurück und setzt es auf den Standardzustand zurück, indem alle zugehörigen Daten zur Touch-Kalibrierung gelöscht werden.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

completeCustomTouchCalibration()

Chrome 57 und höher
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

Legt die Touch-Kalibrierungspaare für ein Display fest. Mit diesen pairs wird der Touchscreen für die Anzeige kalibriert, wobei in startCustomTouchCalibration() die Methode „id“ aufgerufen wird. Rufe vor dem Aufruf dieser Methode immer startCustomTouchCalibration auf. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.

Parameters

  • Die Zugangspunktpaare, die zur Kalibrierung des Displays verwendet werden.

  • Grenzen

    Grenzen des Displays bei der Touch-Kalibrierung. Die Werte bounds.left und bounds.top werden ignoriert.

enableUnifiedDesktop()

Chrome 46 und höher
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

Aktiviert bzw. deaktiviert die Unified Desktop-Funktion. Wenn diese Option aktiviert ist, während die Spiegelung aktiv ist, ändert sich der Desktopmodus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wird der Desktopmodus sofort in den Modus „Einheitlich“ geändert. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameters

  • aktiviert

    boolean

    „True“, wenn Unified Desktop aktiviert werden soll.

getDisplayLayout()

Versprechen Chrome 53 oder höher
chrome.system.display.getDisplayLayout(
  callback?: function,
)

Fordert die Layoutinformationen für alle Displays an. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameters

Rückgaben

  • Promise<DisplayLayout[]>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getInfo()

Versprechen
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.

Parameters

  • flags

    GetInfoFlags optional

    Chrome 59 und höher

    Optionen, die beeinflussen, wie die Informationen zurückgegeben werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    (displayInfo: DisplayUnitInfo[])=>void

Rückgaben

  • Promise<DisplayUnitInfo[]>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

overscanCalibrationAdjust()

Chrome 53 und höher
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

Passt die aktuellen Overscan-Einsätze für eine Anzeige an. In der Regel sollte die Anzeige dadurch entweder entlang einer Achse verschoben (z.B. haben links und rechts denselben Wert) oder sie entlang einer Achse skaliert werden (z.B. haben oben und unten unterschiedliche Werte). Die Werte von Adjust werden mit den vorangegangenen Anrufen seit Beginn kumuliert.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

  • Delta

    Wert zum Ändern der Overscan-Einsätze.

overscanCalibrationComplete()

Chrome 53 und höher
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

Schließen Sie Overscan-Anpassungen für eine Anzeige ab, indem Sie die aktuellen Werte speichern und das Overlay ausblenden.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

overscanCalibrationReset()

Chrome 53 und höher
chrome.system.display.overscanCalibrationReset(
  id: string,
)

Setzt die Overscan-Einsätze für eine Anzeige auf den zuletzt gespeicherten Wert zurück (d. h., bevor Start aufgerufen wurde).

Parameters

  • id

    String

    Die eindeutige ID des Displays.

overscanCalibrationStart()

Chrome 53 und höher
chrome.system.display.overscanCalibrationStart(
  id: string,
)

Startet die Overscan-Kalibrierung für einen Bildschirm. Daraufhin wird ein Overlay auf dem Bildschirm eingeblendet, das die aktuellen Overscan-Einsätze angibt. Wenn die Overscan-Kalibrierung für das Display id läuft, wird dadurch die Kalibrierung zurückgesetzt.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

setDisplayLayout()

Versprechen Chrome 53 oder höher
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

Legen Sie das Layout für alle Bildschirme fest. Für alle Bildschirme, die nicht enthalten sind, wird das Standardlayout verwendet. Falls sich ein Layout überlappen würde oder anderweitig ungültig wäre, wird es an ein gültiges Layout angepasst. Nachdem das Layout aufgelöst wurde, wird ein onDisplayChanged-Ereignis ausgelöst. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameters

  • Layouts

    Die Layoutinformationen, die für alle Bildschirme außer dem Hauptbildschirm erforderlich sind.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setDisplayProperties()

Versprechen
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

Aktualisiert die Eigenschaften für die durch id angegebene Anzeige gemäß den Informationen in info. Bei einem Fehler wird runtime.lastError festgelegt. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

  • Die Informationen zu Anzeigeeigenschaften, die geändert werden sollten. Ein Attribut wird nur geändert, wenn in info ein neuer Wert dafür angegeben wird.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setMirrorMode()

Versprechen Chrome 65 oder höher
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

Legt den Anzeigemodus auf den angegebenen Spiegelmodus fest. Bei jedem Aufruf wird der Status der vorherigen Aufrufe zurückgesetzt. Der Aufruf von „setDisplayProperties()“ schlägt für die Zielbildschirme für die Spiegelung fehl. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameters

  • Die Informationen zum Spiegelungsmodus, die auf den Anzeigemodus angewendet werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

showNativeTouchCalibration()

Versprechen Chrome 57 oder höher
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Zeigt die UX der nativen Touch-Kalibrierung für das Display mit id als Anzeige-ID an. Daraufhin wird ein Overlay auf dem Bildschirm mit den erforderlichen Schritten angezeigt. Der Callback wird nur im Fall einer erfolgreichen Kalibrierung aufgerufen. Wenn die Kalibrierung fehlschlägt, wird ein Fehler ausgegeben.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    (success: boolean)=>void

    • Erfolgreich

      boolean

Rückgaben

  • Promise<boolean>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

startCustomTouchCalibration()

Chrome 57 und höher
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

Startet die benutzerdefinierte Touch-Kalibrierung für ein Display. Dies sollte aufgerufen werden, wenn eine benutzerdefinierte UX zum Erfassen von Kalibrierungsdaten verwendet wird. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.

Parameters

  • id

    String

    Die eindeutige ID des Displays.

Veranstaltungen

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich die Anzeigekonfiguration ändert

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus:

    ()=>void