chrome.system.display

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

  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 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 wird das Layout neu erstellt und das Bild neu gerendert. Das Ergebnis ist ein Zoom mit besserer Qualität als bei einer einfachen pixelweisen Vergrößerung.

• isPrimary

  Boolesch 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

  Boolesch optional

  Chrome 59 und höher

  Nur ChromeOS Wenn diese Richtlinie auf „true“ gesetzt ist, 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 angegeben, darf „mirroringSourceId“ nicht angegeben werden und 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

  Insets 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 der Anzeige.

• 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 Kennung des gespiegelten Displays, wenn die Spiegelung aktiviert ist. Andernfalls 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

  Einzüge

  Die Einzüge 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

  Boolesch 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 verbundenen 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 Spiegellungsquellbildschirms. 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

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

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

• pair4

  TouchCalibrationPair

  Für die Touch-Kalibrierung ist das vierte Touch- 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 mit dem Display verknüpften Touch-Kalibrierungsdaten gelöscht werden.

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 vor dem Aufrufen dieser Methode auf. Wenn bereits eine andere Touch-Kalibrierung läuft, wird ein Fehler ausgegeben.

Parameter

• Paare

  TouchCalibrationPairQuad

  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 bzw. deaktiviert die Unified Desktop-Funktion. Wenn der Unified Desktop-Modus aktiviert ist, während die Spiegelung aktiv ist, wird der Desktopmodus erst geändert, wenn die Spiegelung deaktiviert wird. Andernfalls wird der Desktopmodus 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()

Chrome 53 und höher

chrome.system.display.getDisplayLayout(): 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.

Ausgabe

• Promise<DisplayLayout[]>

  Chrome 91 und höher

  Promise, das mit den Ergebnissen aufgelöst wird.

getInfo()

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
): 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.

Ausgabe

• Promise<DisplayUnitInfo[]>

  Chrome 91 und höher

  Promise, das mit den Ergebnissen aufgelöst wird.

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 das Display entweder 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

  Einzüge

  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 Anpassungen für Overscan 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. 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 ID des Displays.

setDisplayLayout()

Chrome 53 und höher

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

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

Ausgabe

• Promise<void>

  Chrome 91 und höher

  Promise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.

setDisplayProperties()

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): 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.

• Info

  DisplayProperties

  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.

Ausgabe

• Promise<void>

  Chrome 91 und höher

  Promise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.

setMirrorMode()

Chrome 65 oder höher

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): 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

• Info

  MirrorModeInfo

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

Ausgabe

• Promise<void>

  Chrome 91 und höher

  Promise, das aufgelöst wird, wenn die Funktion abgeschlossen ist.

showNativeTouchCalibration()

Chrome 57 und höher

chrome.system.display.showNativeTouchCalibration(
  id: string,
): 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.

Ausgabe

• Promise<boolean>

  Chrome 91 und höher

  Promise, das aufgelöst wird, um den Anrufer darüber zu informieren, dass die Touch-Kalibrierung beendet wurde. Der boolesche Wert gibt an, ob die Abstimmung erfolgreich war.

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