Beschreibung
Verwenden Sie die system.display
API, um Anzeigemetadaten abzufragen.
Berechtigungen
system.display
Typen
ActiveState
Ein Enum-Wert, der angibt, ob der Bildschirm vom System erkannt und verwendet wird. Das Display gilt als „inaktiv“, wenn es vom System nicht erkannt wird (z. B. nicht verbunden oder aufgrund des Schlafmodus als nicht verbunden angesehen). Dieser Status wird verwendet, um einen vorhandenen Bildschirm beizubehalten, wenn alle Bildschirme getrennt sind, z. B.
Enum
"aktiv"
"inaktiv"
Bounds
Attribute
-
Höhe
Zahl
Die Höhe der Anzeige in Pixeln.
-
links
Zahl
Die X-Koordinate der linken oberen Ecke.
-
oben
Zahl
Die Y-Koordinate der linken oberen Ecke.
-
Breite
Zahl
Die Breite des Bildschirms in Pixeln.
DisplayLayout
Attribute
-
id
String
Die eindeutige Kennung des Displays.
-
kompensiert
Zahl
Der Versatz des Displays entlang der verbundenen Kante. 0 bedeutet, dass die obere oder die äußerste linke Ecke ausgerichtet ist.
-
parentId
String
Die eindeutige ID des übergeordneten Bildschirms. Leer, wenn dies der Stamm ist.
-
position
Die Layoutposition dieser Anzeige relativ zum übergeordneten Element. Dies wird für das Stammverzeichnis ignoriert.
DisplayMode
Attribute
-
deviceScaleFactor
Zahl
Der Skalierungsfaktor des Geräts im Anzeigemodus.
-
Höhe
Zahl
Die Höhe im Anzeigemodus in geräteunabhängigen (für 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 nicht angegeben.
-
isNative
boolean
„True“, wenn der Modus der native Modus des Displays ist.
-
isSelected
boolean
„True“, wenn der Anzeigemodus derzeit ausgewählt ist.
-
refreshRate
Zahl
Chrome 67 und höherDie Aktualisierungsrate im Anzeigemodus in Hertz.
-
uiScale
Zahl optional
<ph type="x-smartling-placeholder"></ph> Seit Chrome 70 verworfen„
displayZoomFactor
“ verwendenSkalierungsfaktor der Benutzeroberfläche für den Anzeigemodus
-
Breite
Zahl
Die Breite des Anzeigemodus in geräteunabhängigen (für Nutzer sichtbaren) Pixeln.
-
widthInNativePixels
Zahl
Die Breite des Anzeigemodus in nativen Pixeln.
DisplayProperties
Attribute
-
boundsOriginX
Zahl optional
Wenn dieser Wert festgelegt ist, wird der Ursprung der logischen Begrenzungen der Anzeige entlang der x-Achse aktualisiert. Wird zusammen mit
boundsOriginY
angewendet. Wenn kein Wert festgelegt ist undboundsOriginY
festgelegt ist, wird standardmäßig der aktuelle Wert verwendet. Beachten Sie, dass beim Aktualisieren des angezeigten Ursprungs einige Einschränkungen angewendet werden, sodass der endgültige Ursprung der Grenzen möglicherweise vom festgelegten Ursprung abweicht. Die endgültigen Grenzen können mitgetInfo
abgerufen werden. Der Ursprung der Grenzen kann auf der primären Anzeige nicht geändert werden. -
boundsOriginY
Zahl optional
Aktualisiert den logischen Begrenzungsursprung der Anzeige entlang der Y-Achse, wenn dieser Wert festgelegt ist. Weitere Informationen finden Sie in der Dokumentation zum Parameter
boundsOriginX
. -
displayMode
DisplayMode optional
Chrome 52 und höherAktualisiert den Anzeigemodus auf den Modus, der diesem Wert entspricht. Sind andere Parameter ungültig, wird dies nicht angewendet. Wenn der Anzeigemodus ungültig ist, wird er nicht angewendet und ein Fehler angezeigt. Andere Eigenschaften werden aber trotzdem angewendet.
-
displayZoomFactor
Zahl optional
Chrome 65 und höherAktualisiert den mit der Anzeige verknüpften Zoom. Bei diesem Zoom wird das Layout neu gestaltet und die Darstellung angepasst, was zu einer besseren Zoomqualität führt als nur eine Pixel-für-Pixel-Streckvergrößerung.
-
istprimär
Boolescher Wert optional
Wenn die Richtlinie auf „true“ gesetzt ist, wird die Anzeige als primär festgelegt. Managementfrei, wenn auf „false“ gesetzt. Hinweis: Wenn dies festgelegt ist, wird die Anzeige bei allen anderen Properties als primäre Anzeige angesehen, d.h.,
isUnified
kann festgelegt werden und der Grenzübersprung nicht. -
isUnified
Boolescher Wert optional
Chrome 59 und höherNur ChromeOS Wenn die Richtlinie auf „true“ gesetzt ist, wird der Anzeigemodus in Unified Desktop geändert. Weitere Informationen finden Sie unter
enableUnifiedDesktop
. Wenn die Richtlinie auf „false“ gesetzt ist, wird der Unified Desktop-Modus deaktiviert. Dies gilt nur für den primären Bildschirm. Wenn angegeben, darf mirroringSourceId nicht angegeben werden. Andere Attribute werden ignoriert. Ohne Angabe hat dies keine Auswirkungen. -
mirroringSourceId
String optional
<ph type="x-smartling-placeholder"></ph> Eingestellt seit Chrome 68Verwenden 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. Sie darf nicht mit der an „setDisplayProperties“ übergebenen ID übereinstimmen. Wenn festgelegt, kann keine andere Property festgelegt werden.
-
Overscan
Einsätze optional
Wenn festgelegt, werden die Overscan-Einsätze der Anzeige auf die angegebenen Werte festgelegt. Beachten Sie, dass Overscan-Werte nicht negativ oder größer als die Hälfte des Bildschirms sein dürfen. Der Overscan kann auf dem internen Monitor nicht geändert werden.
-
Rotation
Zahl optional
Aktualisiert die Drehung der Anzeige. Die zulässigen Werte sind [0, 90, 180, 270]. Die Drehung erfolgt im Uhrzeigersinn relativ zur vertikalen Position des Bildschirms.
DisplayUnitInfo
Attribute
-
activeStateChrome 117 oder höher
Aktiv, wenn das Display vom System erkannt und verwendet wird.
-
availableDisplayZoomFactors
Zahl[]
Chrome 67 und höherEine Liste der Zoomfaktorwerte, die für die Anzeige festgelegt werden können.
-
Grenzen
Die logischen Grenzen der Anzeige.
-
displayZoomFactor
Zahl
Chrome 65 und höherDas Verhältnis zwischen dem aktuellen und dem Standardzoom der Anzeige. Beispiel: Wert 1 entspricht 100% Zoom und Wert 1,5 entspricht 150% Zoom.
-
dpiX
Zahl
Die Anzahl der Pixel pro Zoll entlang der X-Achse.
-
dpiY
Zahl
Die Anzahl der Pixel pro Zoll entlang der Y-Achse.
-
EID
Edid optional
Chrome 67 und höherHINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
-
hasTouchSupport
boolean
Chrome 57 und höher"True", wenn diesem Display ein Touch-Eingabegerät zugeordnet ist.
-
id
String
Die eindeutige Kennung des Displays.
-
isEnabled
boolean
„True“, wenn diese Anzeige aktiviert ist.
-
istprimär
boolean
„True“, wenn dies der primäre Bildschirm ist.
-
isUnified
boolean
Chrome 59 und höher„True“ für alle Displays im Unified Desktop-Modus. Siehe Dokumentation zu
enableUnifiedDesktop
. -
mirroringDestinationIds
String[]
Chrome (ab Version 64)Nur ChromeOS IDs der Bildschirme, auf denen die Quellanzeige gespiegelt wird. Leer, wenn keine Bildschirme gespiegelt werden. Dieser wird für alle Bildschirme 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 ist das Feld leer. Diese Einstellung wird für alle Bildschirme festgelegt, auch für den gespiegelten Bildschirm.
-
ModiChrome 52 und höher
Die Liste der verfügbaren Anzeigemodi. Im aktuellen Modus ist isSelected=true. Nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf ein leeres Array festgelegt.
-
Name
String
Der nutzerfreundliche Name (z.B. "HP LCD-Monitor").
-
Overscan
Die Einfügungen des Bildschirms innerhalb der Bildschirmgrenzen. Derzeit nur unter ChromeOS verfügbar. Sie werden auf anderen Plattformen auf leere Einsätze festgelegt.
-
Rotation
Zahl
Die Drehung des Bildschirms im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf „0“ gesetzt. Ein Wert von -1 wird als automatisches Drehen interpretiert, wenn sich das Gerät im Tablet-Status befindet.
-
workArea
Der nutzbare Arbeitsbereich der Anzeige innerhalb der Anzeigegrenzen. Der Arbeitsbereich schließt für das Betriebssystem reservierte Bereiche des Bildschirms aus, z. B. die Taskleiste und den Launcher.
Edid
Attribute
-
manufacturerId
String
Dreistelliger Herstellercode. Siehe Abschnitt 3.4.1 Seite 21. In v1.4 erforderlich.
-
productId
String
2 Byte vom Hersteller zugewiesener Code, Sek. 3.4.2 Seite 21. In v1.4 erforderlich.
-
yearOfManufacture
Zahl
Jahr des Herstellers, Sek. 3.4.4 Seite 22. In v1.4 erforderlich.
GetInfoFlags
Attribute
-
singleUnified
Boolescher Wert optional
Wenn die Richtlinie auf „true“ gesetzt ist, wird im Unified Desktop-Modus nur ein einzelnes
DisplayUnitInfo
vongetInfo
zurückgegeben (sieheenableUnifiedDesktop
). 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
Layoutposition, d. h. Rand des übergeordneten Elements, an dem der Bildschirm angebracht ist
Enum
"top"
"rechts"
"bottom"
"links"
MirrorMode
Spiegelmodus, d.h. verschiedene Möglichkeiten, wie ein Display auf andere Displays gespiegelt wird.
Enum
"off"
Gibt den Standardmodus an (erweiterter Modus oder Unified Desktop).
"normal"
Gibt an, dass die Standard-Quellanzeige auf allen anderen Bildschirmen gespiegelt wird.
"mixed"
Gibt an, dass die angegebene Quellanzeige auf den angegebenen Zieldisplays gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.
MirrorModeInfo
Attribute
-
mirroringDestinationIds
string[] optional
Die IDs der gespiegelten Zielobjekte. Dies gilt nur für „gemischt“.
-
mirroringSourceId
String optional
Die ID der gespiegelten Quellanzeige. Dies gilt nur für „gemischt“.
-
Modus
Der festzulegende Spiegelmodus.
Point
Attribute
-
x
Zahl
Die X-Koordinate des Punkts.
-
y
Zahl
Die Y-Koordinate des Punkts.
TouchCalibrationPair
Attribute
-
displayPoint
Die Koordinaten des Anzeigepunkts.
-
touchPoint
Die Koordinaten des Berührungspunkts, der dem Anzeigepunkt entspricht.
TouchCalibrationPairQuad
Attribute
-
pair1
Für die Touch-Kalibrierung ist das erste Paar Touch- und Displaypunkt erforderlich.
-
pair2
Für die Touch-Kalibrierung ist ein zweites Paar Touch- und Displaypunkt erforderlich.
-
pair3
Für die Touch-Kalibrierung ist ein drittes Paar Touch- und Displaypunkt erforderlich.
-
pair4
Für die Touch-Kalibrierung ist das vierte Paar Touch- und Displaypunkt erforderlich.
Methoden
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Setzt die Touch-Kalibrierung des Displays zurück und bringt es auf den Standardzustand zurück, indem alle Touch-Kalibrierungsdaten gelöscht werden, die mit dem Display verknüpft sind.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Legt die Kalibrierungspaare für Touchscreens für einen Bildschirm fest. Diese pairs
werden verwendet, um den Touchscreen für das Display mit id
zu kalibrieren, der in „startCustomTouchCalibration()“ aufgerufen wird. Rufen Sie immer startCustomTouchCalibration
auf, bevor Sie diese Methode aufrufen. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.
Parameter
-
Paare
Die Zugangspunkte, die zur Kalibrierung des Displays verwendet werden.
-
Grenzen
Grenzen des Displays bei Durchführung der Touch-Kalibrierung. Die Werte
bounds.left
undbounds.top
werden ignoriert.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
Aktiviert/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 wechselt der Desktopmodus sofort in den vereinheitlichten Modus. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
Parameter
-
aktiviert
boolean
„True“, wenn Unified Desktop aktiviert werden soll.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
Fordert die Layoutinformationen für alle Bildschirme an. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(layouts: DisplayLayout[]) => void
-
Layouts
-
Returns
-
Promise<DisplayLayout[]>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.
Parameter
-
flags
GetInfoFlags optional
Chrome 59 und höherOptionen, die beeinflussen, wie die Informationen zurückgegeben werden.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Returns
-
Promise<DisplayUnitInfo[]>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Passt die aktuellen Overscan-Einsätze für eine Anzeige an. In der Regel wird die Anzeige dabei entweder entlang einer Achse verschoben (z.B. hat links + rechts den gleichen Wert) oder sie wird entlang einer Achse skaliert (z.B. haben oben und unten entgegengesetzte Werte). Jeder Anpassungsanruf wird mit den vorherigen Anrufen seit dem Start gezählt.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
delta
Der Wert, um den die Overscan-Einsätze geändert werden sollen.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Schließen Sie die Overscan-Anpassungen für eine Anzeige ab, indem Sie die aktuellen Werte speichern und das Overlay ausblenden.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Setzt die Overscan-Einsätze für eine Anzeige auf den zuletzt gespeicherten Wert (d. h. vor Aufruf des Starts) zurück.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
Startet die Overscan-Kalibrierung für einen Bildschirm. Dadurch wird ein Overlay auf dem Bildschirm angezeigt, das die aktuellen Overscan-Einsätze anzeigt. Wenn eine Overscan-Kalibrierung für das Display „id
“ ausgeführt wird, wird die Kalibrierung zurückgesetzt.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
Lege das Layout für alle Bildschirme fest. Alle nicht enthaltenen Displays verwenden das Standardlayout. Wenn sich ein Layout überschneidet 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 Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
Parameter
-
Layouts
Die Layoutinformationen, die für alle Bildschirme außer dem primären Bildschirm erforderlich sind.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Versprechen<void>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
setDisplayProperties()
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 Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
Info
Die Informationen zu Anzeigeeigenschaften, die geändert werden sollen. Eine Eigenschaft wird nur geändert, wenn in
info
ein neuer Wert dafür angegeben ist. -
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Versprechen<void>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Legt den Anzeigemodus auf den angegebenen Spiegelmodus fest. Bei jedem Aufruf wird der Status vorheriger Aufrufe zurückgesetzt. Der Aufruf von „setDisplayProperties()“ schlägt für die Anzeigeziele des Spiegelungsziels fehl. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.
Parameter
-
Info
Die Informationen zum Spiegelungsmodus, der auf den Anzeigemodus angewendet werden soll.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Versprechen<void>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Zeigt die UX für die native Touch-Kalibrierung für den Bildschirm mit id
als Display-ID an. Nun erscheint auf dem Bildschirm ein Overlay mit einer Anleitung zum weiteren Vorgehen. Der Callback wird nur im Fall einer erfolgreichen Kalibrierung aufgerufen. Wenn die Kalibrierung fehlschlägt, wird ein Fehler ausgegeben.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Returns
-
Promise<boolean>
Chrome 91 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Startet die benutzerdefinierte Touch-Kalibrierung für einen Bildschirm. Diese 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.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
Ereignisse
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich etwas an der Anzeigekonfiguration ändert.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:() => void