refresh date: 2026-09-25 robots: noindex
Beschreibung
Verwenden Sie die system.display API, um angezeigte Metadaten abzufragen.
Berechtigungen
system.displayTypen
ActiveState
Ein Enum, das angibt, ob das Display vom System erkannt und verwendet wird. Das Display gilt als „inaktiv“, wenn es vom System nicht erkannt wird (z. B. weil es nicht verbunden ist oder aufgrund des Ruhemodus als nicht verbunden gilt). Dieser Status wird verwendet, um das vorhandene Display beizubehalten, wenn beispielsweise alle Displays getrennt sind.
Enum
"active"
"inactive"
Bounds
Attribute
-
Höhe
Zahl
Die Höhe des Displays in Pixeln.
-
links
Zahl
Die x-Koordinate der oberen linken Ecke.
-
oben
Zahl
Die Y-Koordinate der oberen linken Ecke.
-
Breite
Zahl
Die Breite des Displays 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 obersten oder am weitesten links liegenden Ecken ausgerichtet sind.
-
parentId
String
Die eindeutige Kennung des übergeordneten Displays. Leer, wenn dies das Stammverzeichnis ist.
-
position
Die Layoutposition dieses Displays im Verhältnis 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 des Anzeigemodus in geräteunabhängigen (für den Nutzer sichtbaren) Pixeln.
-
heightInNativePixels
Zahl
Die Höhe des Anzeigemodus in nativen Pixeln.
-
isInterlaced
Boolesch optional
Chrome 74 oder höher„True“, wenn dieser Modus interlaced 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 oder höherDie Aktualisierungsrate des Anzeigemodus in Hertz.
-
uiScale
number optional
Seit Chrome 70 eingestellt„
displayZoomFactor“ verwendenDer Skalierungsfaktor der Benutzeroberfläche für den 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
number optional
Wenn festgelegt, wird der Ursprung der logischen Grenzen des Displays entlang der x-Achse aktualisiert. Wird zusammen mit
boundsOriginYangewendet. Wenn nicht festgelegt undboundsOriginYfestgelegt ist, wird standardmäßig der aktuelle Wert verwendet. Beachten Sie, dass beim Aktualisieren des Display-Ursprungs einige Einschränkungen gelten. Der endgültige Ursprung der Begrenzungen kann sich daher von dem von Ihnen festgelegten unterscheiden. Die endgültigen Grenzen können mitgetInfoabgerufen werden. Der Ursprung der Begrenzung kann auf dem primären Display nicht geändert werden. -
boundsOriginY
number optional
Wenn festgelegt, wird der Ursprung der logischen Grenzen des Displays entlang der Y-Achse aktualisiert. Weitere Informationen finden Sie in der Dokumentation zum Parameter
boundsOriginX. -
displayMode
DisplayMode optional
Chrome 52 oder höherWenn festgelegt, wird der Anzeigemodus auf den Modus aktualisiert, der diesem Wert entspricht. Wenn andere Parameter ungültig sind, wird dieser nicht angewendet. Wenn der Anzeigemodus ungültig ist, wird er nicht angewendet und es wird ein Fehler ausgegeben. Andere Properties werden jedoch weiterhin angewendet.
-
displayZoomFactor
number optional
Chrome 65 oder höherWenn diese Option festgelegt ist, wird der mit dem Display verknüpfte Zoom aktualisiert. Bei diesem Zoom werden Layout und Darstellung neu berechnet, was zu einer besseren Zoomqualität führt als bei einer einfachen Pixel-für-Pixel-Vergrößerung.
-
isPrimary
Boolesch optional
Wenn diese Option auf „true“ gesetzt ist, wird das Display als primär festgelegt. Keine Aktion, wenn auf „false“ gesetzt. Hinweis: Wenn diese Option festgelegt ist, wird das Display für alle anderen Properties als primär betrachtet (d.h.,
isUnifiedkann festgelegt sein, der Ursprung der Begrenzungen jedoch nicht). -
isUnified
Boolesch optional
Chrome 59 oder höherNur ChromeOS. Wenn die Richtlinie auf „true“ gesetzt ist, wird der Anzeigemodus in „Einheitlicher 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 das primäre Display. Wenn angegeben, darf „mirroringSourceId“ nicht angegeben werden und andere Attribute werden ignoriert. Dies hat keine Auswirkungen, wenn es nicht angegeben ist. -
mirroringSourceId
String optional
Seit Chrome 68 eingestelltVerwenden Sie
setMirrorMode.Nur ChromeOS. Wenn die Richtlinie konfiguriert und nicht leer ist, wird die Spiegelung nur für dieses Display aktiviert. Andernfalls wird die Spiegelung für alle Displays deaktiviert. Dieser Wert sollte die ID des zu spiegelnden Quelldisplays angeben, die nicht mit der an setDisplayProperties übergebenen ID übereinstimmen darf. Wenn diese Option festgelegt ist, darf keine andere Property festgelegt werden.
-
Overscan
Insets optional
Wenn diese Option festgelegt ist, werden die Overscan-Insets des Displays 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.
-
rotation
number optional
Wenn festgelegt, wird die Drehung des Displays aktualisiert. Gültige Werte sind [0, 90, 180, 270]. Die Drehung wird im Uhrzeigersinn relativ zur vertikalen Position des Displays festgelegt.
DisplayUnitInfo
Attribute
-
activeStateChrome 117 oder höher
Aktiv, wenn das Display vom System erkannt und verwendet wird.
-
availableDisplayZoomFactors
number[]
Chrome 67 oder höherEine Liste der Zoomfaktorwerte, die für das Display festgelegt werden können.
-
bounds
Die logischen Grenzen des Displays.
-
displayZoomFactor
Zahl
Chrome 65 oder höherDas Verhältnis zwischen dem aktuellen und dem Standardzoom des Displays. Der Wert 1 entspricht beispielsweise einem Zoom von 100 % und der Wert 1,5 einem Zoom 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öherHINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar.
-
hasTouchSupport
boolean
Chrome 57 oder höher„True“, wenn diesem Display ein Eingabegerät per Berührung zugeordnet ist.
-
id
String
Die eindeutige Kennung des Displays.
-
isEnabled
boolean
„True“, wenn dieses Display aktiviert ist.
-
isPrimary
boolean
„True“, wenn dies das primäre Display ist.
-
isUnified
boolean
Chrome 59 oder höher„True“ für alle Displays im Unified-Desktop-Modus. Dokumentation für
enableUnifiedDesktopansehen -
mirroringDestinationIds
String[]
Chrome 64 oder höherNur ChromeOS. Kennungen der Displays, auf die das Quelldisplay gespiegelt wird. Leer, wenn keine Displays gespiegelt werden. Dieser Wert wird für alle Displays auf denselben Wert festgelegt.
mirroringSourceIddarf nicht enthalten sein. -
mirroringSourceId
String
Nur ChromeOS. ID des Displays, das gespiegelt wird, wenn die Spiegelung aktiviert ist, andernfalls leer. Diese Einstellung wird für alle Displays festgelegt (einschließlich des gespiegelten Displays).
-
ModiChrome 52 oder höher
Die Liste der verfügbaren Anzeigemodi. Der aktuelle Modus hat „isSelected=true“. Nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf ein leeres Array gesetzt.
-
name
String
Der nutzerfreundliche Name (z.B. „HP LCD-Monitor“).
-
Overscan
Die Einzüge des Displays innerhalb der Bildschirmgrenzen. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf leere Insets gesetzt.
-
rotation
Zahl
Die Drehung des Displays im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf 0 gesetzt. Der Wert „-1“ wird als „Automatisch drehen“ interpretiert, wenn sich das Gerät im physischen Tablet-Zustand befindet.
-
workArea
Der nutzbare Arbeitsbereich des Displays innerhalb der Displaygrenzen. Der Arbeitsbereich umfasst keine Bereiche des Displays, die für das Betriebssystem reserviert sind, z. B. die Taskleiste und den Launcher.
Edid
Attribute
-
manufacturerId
String
Herstellercode mit drei Zeichen. Siehe Abschnitt 3.4.1, Seite 21. Erforderlich in v1.4.
-
productId
String
Vom Hersteller zugewiesener 2-Byte-Code, Abschnitt 3.4.2, Seite 21. Erforderlich in v1.4.
-
yearOfManufacture
Zahl
Herstellungsjahr, Abschnitt 3.4.4, Seite 22. Erforderlich in v1.4.
GetInfoFlags
Attribute
-
singleUnified
Boolesch optional
Wenn diese Richtlinie auf „true“ gesetzt ist, wird im Unified Desktop-Modus (siehe
enableUnifiedDesktop) nur ein einzelnesDisplayUnitInfovongetInfozurückgegeben. Der Standardwert 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 das Display angebracht ist.
Enum
"top"
"right"
"bottom"
"left"
MirrorMode
Spiegelungsmodus, d.h. verschiedene Möglichkeiten, wie ein Display auf andere Displays gespiegelt wird.
Enum
"off"
Gibt den Standardmodus an (erweiterter oder einheitlicher Desktop).
"normal"
Gibt an, dass die Standardanzeige der Quelle auf alle anderen Displays gespiegelt wird.
"mixed"
Gibt an, dass das angegebene Quelldisplay auf die angegebenen Zieldisplays gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.
MirrorModeInfo
Attribute
-
mirroringDestinationIds
string[] optional
Die IDs der Displays, auf die gespiegelt wird. Dies gilt nur für „mixed“.
-
mirroringSourceId
String optional
Die ID des gespiegelten Quelldisplays. Dies gilt nur für „mixed“.
-
Modus
Der Spiegelmodus, der festgelegt werden soll.
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 ein erstes Paar aus Berührungs- und Anzeigepunkt erforderlich.
-
pair2
Für die Touch-Kalibrierung ist ein zweites Paar von Berührungs- und Anzeigepunkten erforderlich.
-
pair3
Für die Touch-Kalibrierung ist ein drittes Paar aus Berührungs- und Anzeigepunkt erforderlich.
-
pair4
Viertes Paar aus Berührungs- und Anzeigepunkt für die Berührungskalibrierung erforderlich.
Methoden
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Setzt die Touch-Kalibrierung für das Display zurück und stellt den Standardzustand wieder her, indem alle mit dem Display verknüpften Touch-Kalibrierungsdaten gelöscht werden.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Legt die Touch-Kalibrierungspaare für ein Display fest. Diese pairs werden verwendet, um den Touchscreen für das Display mit id zu kalibrieren, das in startCustomTouchCalibration() aufgerufen wird. Rufe immer startCustomTouchCalibration auf, bevor du diese Methode aufrufst. Wenn bereits eine andere Touch-Kalibrierung ausgeführt wird, wird ein Fehler ausgegeben.
Parameter
-
Paare
Die Punktpaare, die zum Kalibrieren des Displays verwendet werden.
-
bounds
Grenzen des Displays, als die Touch-Kalibrierung durchgeführt wurde. Die Werte
bounds.leftundbounds.topwerden ignoriert.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Aktiviert/deaktiviert die Funktion „Einheitlicher Desktop“. Wenn die Richtlinie aktiviert wird, während die Spiegelung aktiv ist, ändert sich der Desktopmodus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wechselt der Desktopmodus sofort zu „Unified“.
Parameter
-
aktiviert
boolean
„True“, wenn der einheitliche Desktop aktiviert werden soll.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
): Promise<DisplayLayout[]>
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Fordert die Layoutinformationen für alle Displays an.
Parameter
-
callback
function optional
Der Parameter
callbacksieht so aus:(layouts: DisplayLayout[]) => void
-
Layouts
-
Ausgabe
-
Promise<DisplayLayout[]>
Chrome 91 oder höherPromise, das mit den Ergebnissen aufgelöst wird.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
): Promise<DisplayUnitInfo[]>
Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.
Parameter
-
flags
GetInfoFlags optional
Chrome 59 oder höherOptionen, die sich darauf auswirken, wie die Informationen zurückgegeben werden.
-
callback
function optional
Der Parameter
callbacksieht so aus:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Ausgabe
-
Promise<DisplayUnitInfo[]>
Chrome 91 oder höherPromise, das mit den Ergebnissen aufgelöst wird.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Passt die aktuellen Overscan-Insets für ein Display an. In der Regel sollte dadurch entweder die Anzeige entlang einer Achse verschoben (z.B. links und rechts haben denselben Wert) oder entlang einer Achse skaliert werden (z.B. oben und unten haben entgegengesetzte Werte). Jeder Adjust-Aufruf ist kumulativ mit vorherigen Aufrufen seit Start.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
Delta
Der Betrag, um den die Overscan-Insets geändert werden sollen.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Schließen Sie die Overscan-Anpassungen für ein Display 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,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Setzt die Overscan-Insets für ein Display auf den zuletzt gespeicherten Wert zurück (d. h. vor dem Aufruf von „Start“).
Parameter
-
id
String
Die eindeutige Kennung des Displays.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Startet die Overscan-Kalibrierung für ein Display. Dadurch wird ein Overlay auf dem Bildschirm angezeigt, das die aktuellen Overscan-Insets angibt. Wenn die Overscan-Kalibrierung für das Display „id“ gerade läuft, wird sie dadurch zurückgesetzt.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
): Promise<void>
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Legen Sie das Layout für alle Displays fest. Für alle nicht enthaltenen Displays wird das Standardlayout verwendet. Wenn sich ein Layout überschneidet oder anderweitig ungültig ist, wird es an ein gültiges Layout angepasst. Nachdem das Layout aufgelöst wurde, wird ein onDisplayChanged-Ereignis ausgelöst.
Parameter
-
Layouts
Die Layoutinformationen, die für alle Displays außer dem primären Display erforderlich sind.
-
callback
function optional
Der Parameter
callbacksieht so aus:() => void
Ausgabe
-
Promise<void>
Chrome 91 oder höherPromise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
): Promise<void>
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Aktualisiert die Attribute für das durch id angegebene Display gemäß den in info angegebenen Informationen. Bei einem Fehler wird runtime.lastError festgelegt.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
Info
Die Informationen zu den Anzeigeeigenschaften, die geändert werden sollen. Ein Attribut wird nur geändert, wenn in
infoein neuer Wert dafür angegeben ist. -
callback
function optional
Der Parameter
callbacksieht so aus:() => void
Ausgabe
-
Promise<void>
Chrome 91 oder höherPromise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
): Promise<void>
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Legt den Anzeigemodus auf den angegebenen Spiegelmodus fest. Bei jedem Aufruf wird der Status aus vorherigen Aufrufen zurückgesetzt. Der Aufruf von „setDisplayProperties()“ schlägt für die gespiegelten Displays fehl.
Parameter
-
Info
Die Informationen des Spiegelmodus, die auf den Anzeigemodus angewendet werden sollen.
-
callback
function optional
Der Parameter
callbacksieht so aus:() => void
Ausgabe
-
Promise<void>
Chrome 91 oder höherPromise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
): Promise<boolean>
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Zeigt die native Touch-Kalibrierung für das Display mit der Display-ID id an. Daraufhin wird auf dem Bildschirm ein Overlay mit einer Anleitung angezeigt, wie Sie vorgehen müssen. Der Callback wird nur bei erfolgreicher Kalibrierung aufgerufen. Wenn die Kalibrierung fehlschlägt, wird ein Fehler ausgegeben.
Parameter
-
id
String
Die eindeutige Kennung des Displays.
-
callback
function optional
Der Parameter
callbacksieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Ausgabe
-
Promise<boolean>
Chrome 91 oder höherPromise, das aufgelöst wird, um den Aufrufer darüber zu informieren, dass die Touch-Kalibrierung beendet wurde. Der boolesche Wert gibt an, ob die Kalibrierung erfolgreich war oder nicht.
Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
): void
HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps verfügbar. Startet die benutzerdefinierte Touch-Kalibrierung für ein Display. Diese Methode sollte aufgerufen werden, wenn eine benutzerdefinierte UX zum Erfassen von Kalibrierungsdaten verwendet wird. Wenn bereits eine andere Touch-Kalibrierung ausgefü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
callbacksieht so aus:() => void