chrome.system.display

Aktualisierungsdatum: 2026-09-25 robots: noindex

Beschreibung

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

Berechtigungen

system.display

Typen

ActiveState

Chrome 117 und 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 (möglicherweise getrennt oder aufgrund des Ruhemodus als getrennt betrachtet wird). 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 gibt an, dass die oberen oder linken Ecken ausgerichtet sind.

  • parentId

    String

    Die eindeutige Kennung des übergeordneten Displays. Leer, wenn dies das Stammverzeichnis ist.

  • position

    Die Layoutposition dieser Anzeige relativ zum übergeordneten Element. Dies wird für den Stamm ignoriert.

DisplayMode

Chrome 52 und höher

Attribute

  • deviceScaleFactor

    Zahl

    Der Skalierungsfaktor des Geräts für den 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 und höher

    „True“, wenn dieser Modus verschachtelt ist, andernfalls „false“.

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

    Die Aktualisierungsrate des Anzeigemodus in Hertz.

  • uiScale

    number optional

    Seit Chrome 70 eingestellt

    „displayZoomFactor“ verwenden

    Der Skalierungsfaktor für die Benutzeroberfläche des 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. Wurde zusammen mit boundsOriginY angewendet. Wird standardmäßig auf den aktuellen Wert gesetzt, wenn er nicht festgelegt ist und boundsOriginY festgelegt ist. Beim Aktualisieren des Ursprungs der Anzeige werden einige Einschränkungen angewendet. Der endgültige Ursprung der Grenzen kann sich daher vom festgelegten Ursprung unterscheiden. Die endgültigen Grenzen können mit getInfo abgerufen werden. Der Ursprung der Grenzen 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 und höher

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

  • displayZoomFactor

    number optional

    Chrome 65 und höher

    Wenn festgelegt, wird der Zoom aktualisiert, der mit dem Display verknüpft ist. Bei diesem Zoom werden Layout und Darstellung neu berechnet, was zu einem Zoom mit besserer Qualität führt als bei einer einfachen pixelweisen Vergrößerung.

  • isPrimary

    Boolesch optional

    Wenn diese Richtlinie auf „true“ gesetzt ist, wird das Display zum primären Display. Wird nicht ausgeführt, wenn „false“ festgelegt ist. Hinweis: Wenn diese Option festgelegt ist, gilt das Display als primär für alle anderen Properties. Das bedeutet, dass isUnified festgelegt sein kann, der Ursprung der Grenzen jedoch nicht.

  • isUnified

    Boolesch optional

    Chrome 59 und höher

    Nur ChromeOS. Wenn diese Richtlinie auf „true“ gesetzt ist, wird der Anzeigemodus in den einheitlichen Desktop geändert (siehe 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 Eigenschaften werden ignoriert. Hat keine Auswirkungen, wenn nicht angegeben.

  • mirroringSourceId

    String optional

    Seit Chrome 68 eingestellt

    Verwenden Sie setMirrorMode.

    Nur ChromeOS. Wenn diese Option festgelegt und nicht leer ist, wird die Spiegelung nur für dieses Display aktiviert. Andernfalls wird das Spiegeln für alle Displays deaktiviert. Dieser Wert sollte die ID des Quellbildschirms angeben, der gespiegelt werden soll. Er darf nicht mit der ID übereinstimmen, die an setDisplayProperties übergeben wird. Wenn diese Option festgelegt ist, darf keine andere Property festgelegt werden.

  • Overscan

    Einzüge optional

    Wenn festgelegt, werden die Overscan-Insets des Displays auf die angegebenen Werte gesetzt. Die Overscan-Werte dürfen nicht negativ sein und nicht mehr als die Hälfte der Bildschirmgröße betragen. Overscan kann auf dem internen Monitor nicht geändert werden.

  • Drehung

    number optional

    Wenn festgelegt, wird die Drehung des Displays aktualisiert. Gültige Werte sind [0, 90, 180, 270]. Die Drehung erfolgt im Uhrzeigersinn relativ zur vertikalen Position des Displays.

DisplayUnitInfo

Attribute

  • activeState
    Chrome 117 und höher

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

  • availableDisplayZoomFactors

    number[]

    Chrome 67 und höher

    Eine Liste der Zoomfaktoren, die für die Anzeige festgelegt werden können.

  • Grenzwerte

    Die logischen Grenzen des Displays.

  • displayZoomFactor

    Zahl

    Chrome 65 und höher

    Das Verhältnis zwischen dem aktuellen und dem Standardzoom des Displays. Beispiel: Der Wert 1 entspricht 100% Zoom und der 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.

  • edid

    Edid optional

    Chrome 67 und höher

    HINWEIS: Diese Option ist nur für ChromeOS-Kiosk-Apps 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 dieses Display aktiviert ist.

  • isPrimary

    boolean

    „true“, wenn dies das primäre Display ist.

  • isUnified

    boolean

    Chrome 59 und höher

    Gilt für alle Displays im Unified Desktop-Modus. enableUnifiedDesktop-Dokumentation ansehen

  • mirroringDestinationIds

    String[]

    Chrome 64 und 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. Kennung des Displays, das gespiegelt wird, wenn die Spiegelung aktiviert ist. Andernfalls leer. Diese Einstellung wird für alle Displays festgelegt, auch für das gespiegelte Display.

  • Modi
    Chrome 52 und höher

    Die Liste der verfügbaren Anzeigemodi. Für den aktuellen Modus gilt „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 Grenzen des Bildschirms. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf leere Insets gesetzt.

  • Drehung

    Zahl

    Die Drehung des Displays im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Auf anderen Plattformen wird der Wert auf 0 gesetzt. Ein Wert von -1 wird als „automatisch drehen“ interpretiert, wenn sich das Gerät in einem physischen Tablet-Zustand befindet.

  • workArea

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

Edid

Chrome 67 und höher

Attribute

  • manufacturerId

    String

    Herstellercode mit drei Zeichen. Siehe Abschnitt 3.4.1 auf Seite 21. Erforderlich in Version 1.4.

  • productId

    String

    Vom Hersteller zugewiesener 2-Byte-Code, Abschnitt 3.4.2, Seite 21. In Version 1.4 erforderlich.

  • yearOfManufacture

    Zahl

    Herstellungsjahr, Abschnitt 3.4.4, Seite 22. In Version 1.4 erforderlich.

GetInfoFlags

Chrome 59 und höher

Attribute

  • singleUnified

    Boolesch optional

    Wenn auf „true“ gesetzt, wird von getInfo im Unified Desktop-Modus (siehe enableUnifiedDesktop) nur ein einzelnes DisplayUnitInfo zurückgegeben. Der Standardwert ist „false“.

Insets

Attribute

  • unten

    Zahl

    Der Abstand der Y-Achse von der Untergrenze.

  • links

    Zahl

    Der Abstand der X-Achse vom linken Rand.

  • rechts

    Zahl

    Der Abstand der X-Achse vom rechten Rand.

  • oben

    Zahl

    Der Abstand der Y-Achse von der oberen Grenze.

LayoutPosition

Chrome 53 und höher

Layoutposition, d.h. Kante des übergeordneten Elements, an der das Display angebracht ist.

Enum

"top"

„right“

„bottom“

"left"

MirrorMode

Chrome 65 und 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 Standardquellenanzeige auf alle anderen Displays gespiegelt wird.

mixed
Gibt an, dass die angegebene Quellanzeige auf die angegebenen Zielanzeigen gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.

MirrorModeInfo

Chrome 65 und höher

Attribute

  • mirroringDestinationIds

    string[] optional

    Die IDs der Spiegelungsziele werden angezeigt. Dies gilt nur für „mixed“.

  • mirroringSourceId

    String optional

    Die ID des Spieglungsquellbildschirms. Dies gilt nur für „mixed“.

  • Modus

    Der Spiegelmodus, 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 Touchpoints, der dem Anzeigepunkt entspricht.

TouchCalibrationPairQuad

Chrome 57 und höher

Attribute

  • Für die Touch-Kalibrierung ist das erste Touch- und Display-Paar erforderlich.

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

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

  • Für die Touch-Kalibrierung ist das vierte Touch- und Display-Punkt-Paar erforderlich.

Methoden

clearTouchCalibration()

Chrome 57 und 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 und 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 die Anzeige mit id zu kalibrieren, die in startCustomTouchCalibration() aufgerufen wird. Rufen Sie immer startCustomTouchCalibration auf, bevor Sie diese Methode aufrufen. Wenn bereits eine andere Touch-Kalibrierung läuft, wird ein Fehler ausgegeben.

Parameter

  • Die zum Kalibrieren des Displays verwendeten Punktpaare.

  • Grenzwerte

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

enableUnifiedDesktop()

Chrome 46 und 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 Funktion aktiviert wird, während die Spiegelung aktiv ist, ändert sich der Desktopmodus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wird der Desktopmodus sofort in „Vereinheitlicht“ geändert.

Parameter

  • aktiviert

    boolean

    Wahr, 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 und 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 und höher

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    (displayInfo: DisplayUnitInfo[]) => void

Ausgabe

  • Promise<DisplayUnitInfo[]>

    Chrome 91 und 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-Einzüge für ein Display an. Normalerweise sollte dadurch die Anzeige entlang einer Achse verschoben werden (z.B. haben „left“ und „right“ denselben Wert) oder entlang einer Achse skaliert werden (z.B. haben „top“ und „bottom“ entgegengesetzte Werte). Jeder Adjust-Aufruf ist kumulativ mit vorherigen Aufrufen seit dem Start.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

  • Delta

    Der Betrag, um den die Overscan-Einzüge 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 Anpassungen für den Overscan eines Displays 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. Auf dem Bildschirm wird ein Overlay mit den aktuellen Overscan-Einzügen angezeigt. Wenn die Overscan-Kalibrierung für Display id 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 Displays, die nicht enthalten sind, wird das Standardlayout verwendet. Wenn sich ein Layout überschneiden oder anderweitig ungültig sein sollte, wird es an ein gültiges Layout angepasst. Nachdem das Layout festgelegt wurde, wird das Ereignis „onDisplayChanged“ ausgelöst.

Parameter

  • Layouts

    Die Layoutinformationen, die für alle Displays außer dem primären Display erforderlich sind.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und 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 die Anzeige, die durch id angegeben wird, gemäß den in info bereitgestellten 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. Eine Property wird nur geändert, wenn in info ein neuer Wert dafür angegeben ist.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und 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 Spiegelungsziele fehl.

Parameter

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und 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+
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-Kalibrierungs-Benutzeroberfläche für das Display mit id als Display-ID an. Auf dem Bildschirm wird ein Overlay mit der erforderlichen Anleitung angezeigt. 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

    Funktion optional

    Der Parameter callback sieht so aus:

    (success: boolean) => void

    • Erfolg

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 91 und 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 und 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 Benutzeroberfläche zum Erfassen von Kalibrierungsdaten verwendet wird. Wenn bereits eine andere Touch-Kalibrierung läuft, 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 Displaykonfiguration ändert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus:

    () => void