chrome.system.display

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie die system.display API, um angezeigte Metadaten abzufragen.

Berechtigungen

system.display

Typen

ActiveState

Chrome 117 oder höher

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

Chrome 53 und höher

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

Chrome 52 oder 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

    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öher

    Die Aktualisierungsrate des Anzeigemodus in Hertz.

  • uiScale

    number optional

    Seit Chrome 70 eingestellt

    „displayZoomFactor“ verwenden

    Der 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 boundsOriginY angewendet. Wenn nicht festgelegt und boundsOriginY festgelegt 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 mit getInfo abgerufen 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öher

    Wenn 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öher

    Wenn 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., isUnified kann festgelegt sein, der Ursprung der Begrenzungen jedoch nicht).

  • isUnified

    Boolesch optional

    Chrome 59 oder höher

    Nur 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 eingestellt

    Verwenden 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

  • activeState
    Chrome 117 oder höher

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

  • availableDisplayZoomFactors

    number[]

    Chrome 67 oder höher

    Eine Liste der Zoomfaktorwerte, die für das Display festgelegt werden können.

  • bounds

    Die logischen Grenzen des Displays.

  • displayZoomFactor

    Zahl

    Chrome 65 oder höher

    Das 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öher

    HINWEIS: 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 enableUnifiedDesktop ansehen

  • mirroringDestinationIds

    String[]

    Chrome 64 oder höher

    Nur 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. mirroringSourceId darf 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).

  • Modi
    Chrome 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

Chrome 67 oder höher

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

Chrome 59 oder höher

Attribute

  • singleUnified

    Boolesch optional

    Wenn diese Richtlinie auf „true“ gesetzt ist, wird im Unified Desktop-Modus (siehe enableUnifiedDesktop) nur ein einzelnes DisplayUnitInfo von getInfo zurü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

Chrome 53 und höher

Layoutposition, d.h. Rand des übergeordneten Elements, an dem das Display angebracht ist.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 oder höher

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

Chrome 65 oder höher

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

Chrome 57 oder höher

Attribute

  • x

    Zahl

    Die X-Koordinate des Punkts.

  • y

    Zahl

    Die Y-Koordinate des Punkts.

TouchCalibrationPair

Chrome 57 oder höher

Attribute

  • displayPoint

    Die Koordinaten des Anzeigepunkts.

  • touchPoint

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

TouchCalibrationPairQuad

Chrome 57 oder höher

Attribute

  • Für die Touch-Kalibrierung ist ein erstes Paar aus Berührungs- und Anzeigepunkt erforderlich.

  • Für die Touch-Kalibrierung ist ein zweites Paar von Berührungs- und Anzeigepunkten erforderlich.

  • Für die Touch-Kalibrierung ist ein drittes Paar aus Berührungs- und Anzeigepunkt erforderlich.

  • Viertes Paar aus Berührungs- und Anzeigepunkt für die Berührungskalibrierung erforderlich.

Methoden

clearTouchCalibration()

Chrome 57 oder höher
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 57 oder höher
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

  • Die Punktpaare, die zum Kalibrieren des Displays verwendet werden.

  • bounds

    Grenzen des Displays, als die Touch-Kalibrierung durchgeführt wurde. Die Werte bounds.left und bounds.top werden ignoriert.

enableUnifiedDesktop()

Chrome 46 oder höher
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()

Promise Chrome 53 und höher
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

Ausgabe

  • Promise<DisplayLayout[]>

    Chrome 91 oder höher

    Promise, 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()

Promise
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öher

    Optionen, die sich darauf auswirken, wie die Informationen zurückgegeben werden.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    (displayInfo: DisplayUnitInfo[]) => void

Ausgabe

  • Promise<DisplayUnitInfo[]>

    Chrome 91 oder höher

    Promise, 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 53 und höher
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 53 und höher
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 53 und höher
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 53 und höher
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()

Promise Chrome 53 und höher
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 callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promise, 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()

Promise
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.

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

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promise, 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()

Promise Chrome 65 oder höher
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

  • Die Informationen des Spiegelmodus, die auf den Anzeigemodus angewendet werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promise, 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()

Promise Chrome 57 und höher
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 callback sieht so aus:

    (success: boolean) => void

    • Erfolg

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 91 oder höher

    Promise, 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 57 oder höher
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 callback sieht so aus:

    () => void