chrome.system.display

Beschreibung

Verwenden Sie die system.display API, um Display-Metadaten 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 (z. B. weil es getrennt wurde oder aufgrund des Ruhemodus als getrennt 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 ID 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 ID des übergeordneten Displays. Leer, wenn es sich um den Stamm handelt.

  • position

    LayoutPosition

    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 Geräteskalierungsfaktor 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

    boolean 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 UI-Skalierungsfaktor 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 Ursprungs der Anzeige einige Einschränkungen gelten. 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 festgelegt, 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 oder höher

    Wenn festgelegt, wird der mit der Anzeige verknüpfte Zoom aktualisiert. 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

    boolean optional

    Wenn diese Richtlinie auf „true“ gesetzt ist, wird das Display zum primären Display. Hat keine Auswirkungen, wenn der Wert auf „false“ gesetzt ist. Hinweis: Wenn diese Option festgelegt ist, gilt die Anzeige als primär für alle anderen Eigenschaften. Das bedeutet, dass isUnified festgelegt werden kann, der Ursprung der Grenzen jedoch nicht.

  • isUnified

    boolean optional

    Chrome 59 und höher

    Nur ChromeOS Bei der Einstellung „true“ wird der Anzeigemodus in „Unified 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 „mirroringSourceId“ angegeben ist, darf „mirroringSourceId“ nicht angegeben werden. Andere Attribute werden ignoriert. Dies hat keine Auswirkungen, wenn es nicht angegeben wird.

  • mirroringSourceId

    String optional

    Seit Chrome 68 eingestellt

    Verwenden Sie setMirrorMode.

    Nur ChromeOS Wenn festgelegt und nicht leer, wird die Spiegelung nur für dieses Display aktiviert. Andernfalls wird das Spiegeln für alle Displays deaktiviert. Dieser Wert sollte die ID des zu spiegelnden Quelldisplays angeben. Diese 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 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 erfolgt im Uhrzeigersinn relativ zur vertikalen Position des Displays.

DisplayUnitInfo

Attribute

  • activeState

    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

    Grenzen

    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 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 Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.

  • hasTouchSupport

    boolean

    Chrome 57 und höher

    „True“, wenn diesem Display ein Touch-Eingabegerät zugeordnet ist.

  • id

    String

    Die eindeutige ID des Displays.

  • isEnabled

    boolean

    „True“, wenn dieser Bildschirm 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. Weitere Informationen finden Sie in der Dokumentation zu enableUnifiedDesktop.

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

  • Modi

    DisplayMode[]

    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

    Insets

    Die Insets des Displays innerhalb der Grenzen des Bildschirms. 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. Ein Wert von -1 wird als „Automatisch drehen“ interpretiert, wenn sich das Gerät in einem physischen Tablet-Zustand befindet.

  • workArea

    Grenzen

    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

    Dreistelliger Herstellercode. Siehe Abschnitt 3.4.1, Seite 21. In Version 1.4 erforderlich.

  • productId

    String

    2-Byte-Code, der vom Hersteller zugewiesen wird, 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

    boolean optional

    Wenn auf „true“ gesetzt, wird von getInfo im einheitlichen Desktopmodus (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 Y-Achsen-Abstand von der oberen Grenze.

LayoutPosition

Chrome 53 und höher

Layoutposition, d.h. Kante 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 Unified 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 angeschlossenen Displays werden erweitert.

MirrorModeInfo

Chrome 65 oder höher

Attribute

  • mirroringDestinationIds

    string[] optional

    Die IDs der Spiegelungszielbildschirme. Dies gilt nur für „mixed“.

  • mirroringSourceId

    String optional

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

  • Modus

    MirrorMode

    Der Spiegelmodus, der eingestellt 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

    Punkt

    Die Koordinaten des Anzeigepunkts.

  • touchPoint

    Punkt

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

TouchCalibrationPairQuad

Chrome 57 und höher

Attribute

  • Erstes Paar von Berührungs- und Anzeigepunkten, das für die Touch-Kalibrierung erforderlich ist.

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

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

  • Für die Touch-Kalibrierung ist das vierte Berührungs- und Anzeigepunktpaar erforderlich.

Methoden

clearTouchCalibration()

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

Setzt die Touch-Kalibrierung für das Display zurück und stellt den Standardzustand wieder her, indem alle Touch-Kalibrierungsdaten gelöscht werden, die mit dem Display verknüpft sind.

Parameter

  • id

    String

    Die eindeutige ID des Displays.

completeCustomTouchCalibration()

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

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 startCustomTouchCalibration immer 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

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

enableUnifiedDesktop()

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

Aktiviert/deaktiviert die Funktion „Unified Desktop“. Wenn der Unified-Desktop-Modus aktiviert ist, während die Spiegelung aktiv ist, ändert sich der Desktop-Modus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wird der Desktop-Modus sofort auf „Unified“ umgestellt. HINWEIS: Diese Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.

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[]>

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

Parameter

Ausgabe

  • Promise<DisplayLayout[]>

    Chrome 91 und höher

    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

    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

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 ID des Displays.

  • delta

    Insets

    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

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 ID des Displays.

overscanCalibrationReset()

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

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 ID des Displays.

overscanCalibrationStart()

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

Startet die Overscan-Kalibrierung für ein Display. Dadurch wird ein Overlay auf dem Bildschirm angezeigt, das die aktuellen Overscan-Einzüge angibt. Wenn die Overscan-Kalibrierung für Display id läuft, wird die Kalibrierung dadurch zurückgesetzt.

Parameter

  • id

    String

    Die eindeutige ID des Displays.

setDisplayLayout()

Promise Chrome 53 und höher 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

Legen Sie das Layout für alle Displays fest. Für alle anderen 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 das Ereignis „onDisplayChanged“ ausgelöst. HINWEIS: Diese Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameter

  • Layouts

    DisplayLayout[]

    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

    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>

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. HINWEIS: Diese Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameter

  • id

    String

    Die eindeutige ID des Displays.

  • Die Informationen zu den 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

Ausgabe

  • Promise<void>

    Chrome 91 und höher

    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>

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 Spiegelungszielbildschirme fehl. HINWEIS: Diese Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.

Parameter

  • Die Informationen zum 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

    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>

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 ID des Displays.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (success: boolean) => void

    • Erfolg

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 91 und höher

    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

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 ID 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