Beschreibung
Verwenden Sie die system.display
API, um Anzeigemetadaten abzufragen.
Berechtigungen
system.display
Typen
ActiveState
Ein Enum-Wert, der angibt, ob die Anzeige 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 angesehen). Dieser Status wird verwendet, um beispielsweise den vorhandenen Bildschirm beizubehalten, wenn alle Bildschirme getrennt sind.
Enum
Bounds
Attribute
-
Höhe
Zahl
Die Höhe der Anzeige in Pixeln.
-
links
Zahl
Die X-Koordinate der oberen linken Ecke.
-
oben
Zahl
Die Y-Koordinate der oberen linken Ecke.
-
Breite
Zahl
Die Breite der Anzeige in Pixeln.
DisplayLayout
Attribute
-
id
String
Die eindeutige ID der Anzeige.
-
kompensiert
Zahl
Der Abstand der Anzeige entlang der verbundenen Kante. 0 bedeutet, dass die obere bzw. linke Ecke aufeinander ausgerichtet ist.
-
parentId
String
Die eindeutige ID der übergeordneten Anzeige. Leer, wenn dies der Stamm ist.
-
position
Die Layoutposition dieser Anzeige relativ zur übergeordneten Datei. Dies wird für den Stamm 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
Boolescher Wert optional
Chrome 74 und höher„True“, wenn dieser Modus verschachtelt ist, „false“, wenn er nicht angegeben ist.
-
isNative
boolean
Dieser Wert ist „True“, wenn es sich um den nativen Modus der Anzeige handelt.
-
isSelected
boolean
„True“, wenn derzeit der Anzeigemodus ausgewählt ist.
-
refreshRate
Zahl
Chrome 67 oder höherDie Aktualisierungsrate des Anzeigemodus in Hertz.
-
uiScale
Nummer optional
Seit Chrome 70 eingestellt„
displayZoomFactor
“ verwendenDer Skalierungsfaktor der Benutzeroberfläche im 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
Nummer optional
Aktualisiert den Ursprung der logischen Grenzen der Anzeige entlang der X-Achse. Gemeinsam mit
boundsOriginY
angewendet. Wenn kein Wert festgelegt undboundsOriginY
festgelegt ist, wird standardmäßig der aktuelle Wert verwendet. Beachten Sie, dass beim Aktualisieren des Anzeigeursprungs einige Einschränkungen angewendet werden, sodass der Ursprung der endgültigen Grenzen von dem einen Satz abweichen kann. Die endgültigen Grenzen können mithilfe vongetInfo
abgerufen werden. Der Ursprung des Bereichs kann in der primären Anzeige nicht geändert werden. -
boundsOriginY
Nummer optional
Aktualisiert den Ursprung der logischen Grenzen der Anzeige entlang der Y-Achse. Weitere Informationen zum Parameter
boundsOriginX
finden Sie in der Dokumentation. -
displayMode
DisplayMode optional
Chrome 52 und höherWenn festgelegt, wird der Anzeigemodus auf den Modus aktualisiert, der diesem Wert entspricht. Wenn andere Parameter ungültig sind, wird diese Einstellung nicht angewendet. Wenn der Anzeigemodus ungültig ist, wird er nicht angewendet und es wird ein Fehler ausgegeben. Andere Eigenschaften werden aber trotzdem angewendet.
-
displayZoomFactor
Nummer optional
Chrome 65 und höherWenn festgelegt, wird der Zoom des Displays aktualisiert. Bei diesem Zoom werden das Layout und die Darstellung neu gezeichnet, was zu einer besseren Zoomqualität führt als die bloße Streckvergrößerung (Pixel für Pixel).
-
isPrimary
Boolescher Wert optional
Ist die Richtlinie auf „true“ gesetzt, wird das Display als primär dargestellt. No-Op, wenn auf „false“ gesetzt. Hinweis: Wenn diese Richtlinie festgelegt ist, wird die Anzeige für alle anderen Properties als primär eingestuft. Das heißt,
isUnified
kann festgelegt sein und der Ursprung des begrenzten Bereichs nicht. -
isUnified
Boolescher Wert optional
Chrome 59 und höherNur ChromeOS. Ist die Richtlinie auf „true“ gesetzt, wird der Anzeigemodus in „Unified Desktop“ geändert. Weitere Informationen finden Sie unter
enableUnifiedDesktop
. Ist sie auf „false“ gesetzt, wird der Unified Desktop-Modus deaktiviert. Dies gilt nur für das Hauptdisplay. Falls angegeben, darf mirroringSourceId nicht angegeben werden. Andere Attribute werden ignoriert. Wird kein Wert angegeben, hat dies keine Auswirkungen. -
mirroringSourceId
String optional
Seit Chrome 68 eingestelltVerwenden Sie
setMirrorMode
.Nur ChromeOS. Wenn festgelegt und nicht leer, wird die Spiegelung nur für diese Anzeige aktiviert. Andernfalls wird die Spiegelung für alle Bildschirme deaktiviert. Dieser Wert sollte die ID der zu spiegelnden Quellanzeige angeben, die nicht mit der ID übereinstimmen darf, die an „setDisplayProperties“ übergeben wird. Wenn festgelegt, kann keine andere Eigenschaft festgelegt werden.
-
Overscan
Einsätze optional
Falls festgelegt, werden die Overscan-Einsätze der Anzeige 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.
-
Drehung
Nummer optional
Wenn festgelegt, wird die Displaydrehung aktualisiert. Zulässige Werte sind [0, 90, 180, 270]. Die Drehung wird relativ zur vertikalen Position des Displays im Uhrzeigersinn eingestellt.
DisplayUnitInfo
Attribute
-
activeStateChrome 117 oder höher
Aktiv, wenn das Display vom System erkannt und verwendet wird.
-
availableDisplayZoomFactors
Nummer[]
Chrome 67 oder höherEine Liste von Zoomfaktorwerten, die für die Anzeige festgelegt werden können.
-
Grenzen
Die logischen Grenzen der Anzeige.
-
displayZoomFactor
Zahl
Chrome 65 und höherDas Verhältnis zwischen dem aktuellen und dem Standardzoom des Displays. Beispielsweise entspricht der Wert 1 einer Zoomstufe von 100% und der Wert 1,5 einer Zoomstufe 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 Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
-
hasTouchSupport
boolean
Chrome 57 und höher„True“, wenn diesem Display ein Gerät zur Eingabe per Berührung zugeordnet ist.
-
id
String
Die eindeutige ID der Anzeige.
-
isEnabled
boolean
„True“, wenn dieses Display aktiviert ist.
-
isPrimary
boolean
„True“, wenn dies der primäre Bildschirm ist.
-
isUnified
boolean
Chrome 59 und höher„True“ für alle Bildschirme im Unified Desktop-Modus. Weitere Informationen finden Sie in der Dokumentation zu
enableUnifiedDesktop
. -
mirroringDestinationIds
String[]
Chrome 64 und höherNur ChromeOS. IDs der Bildschirme, auf denen die Quellanzeige gespiegelt wird. Leer, wenn keine Bildschirme gespiegelt werden. Dieser wird für alle Displays auf denselben Wert festgelegt.
mirroringSourceId
darf nicht enthalten sein. -
mirroringSourceId
String
Nur ChromeOS. ID des Bildschirms, der gespiegelt wird, wenn die Spiegelung aktiviert ist, andernfalls leer. Diese Einstellung wird für alle Displays festgelegt (einschließlich des gespiegelten Displays).
-
modesChrome 52 und höher
Die Liste der verfügbaren Anzeigemodi. Der aktuelle Modus lautet „isSelected=true“. Nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf ein leeres Array festgelegt.
-
name
String
Der benutzerfreundliche Name (z. B. „HP LCD-Monitor“)
-
Overscan
Die Einfügungen des Bildschirms innerhalb der Bildschirmgrenzen. Derzeit nur unter ChromeOS verfügbar. Auf anderen Plattformen werden leere Werte verwendet.
-
Drehung
Zahl
Die Drehung des Displays im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Auf anderen Plattformen auf 0 gesetzt. Ein Wert von -1 wird als automatisches Drehen interpretiert, wenn sich das Gerät im Zustand eines Tablets befindet.
-
workArea
Der nutzbare Arbeitsbereich der Anzeige innerhalb der Anzeigegrenzen. Der Arbeitsbereich schließt Bereiche des Bildschirms aus, die für das Betriebssystem reserviert sind, z. B. die Taskleiste und der Launcher.
Edid
Attribute
-
manufacturerId
String
3-stelliger Herstellercode. Siehe Abschnitt 3.4.1, Seite 21. Erforderlich in Version 1.4.
-
productId
String
2-Byte-Code vom Hersteller, Abschnitt 3.4.2, Seite 21. Erforderlich in Version 1.4.
-
yearOfManufacture
Zahl
Herstellerjahr, Abschnitt 3.4.4, Seite 22. Erforderlich in Version 1.4.
GetInfoFlags
Attribute
-
singleUnified
Boolescher Wert optional
Wird die Richtlinie auf „true“ gesetzt, wird im Unified Desktop-Modus nur ein einzelnes
DisplayUnitInfo
-Element vongetInfo
zurückgegeben (sieheenableUnifiedDesktop
). Die Standardeinstellung 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. der Rand des übergeordneten Elements, an dem der Bildschirm befestigt ist.
Enum
MirrorMode
Spiegelmodus, d.h. verschiedene Möglichkeiten, wie ein Bildschirm mit anderen Displays gespiegelt wird.
Enum
"off"
Gibt den Standardmodus an (erweiterter oder Unified Desktop-Modus).
"normal"
Gibt an, dass die standardmäßige Quellanzeige auf allen anderen Displays gespiegelt wird.
"mixed"
Gibt an, dass die angegebene Quellanzeige auf den bereitgestellten Zielbildschirmen gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.
MirrorModeInfo
Attribute
-
mirroringDestinationIds
string[] optional
Die IDs des Spiegelungsziels werden angezeigt. Dies gilt nur für „gemischt“.
-
mirroringSourceId
String optional
Die ID der Anzeige der gespiegelten Quelle. Dies gilt nur für „gemischt“.
-
Modus
Der Spiegelungsmodus, 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 sind das erste Touch- und der Displaypunkt-Paar erforderlich.
-
pair2
Für die Touch-Kalibrierung ist ein zweites Paar Touch- und Displaypunkt erforderlich.
-
pair3
Für die Touch-Kalibrierung ist ein drittes Paar Touch- und Displaypunkt erforderlich.
-
pair4
Ein viertes Paar Touch- und Displaypunkt für die Touch-Kalibrierung.
Methoden
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Setzt die Touch-Kalibrierung für das Display zurück und setzt es auf den Standardzustand zurück, indem alle zugehörigen Daten zur Touch-Kalibrierung gelöscht werden.
Parameters
-
id
String
Die eindeutige ID des Displays.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Legt die Touch-Kalibrierungspaare für ein Display fest. Mit diesen pairs
wird der Touchscreen für die Anzeige kalibriert, wobei in startCustomTouchCalibration() die Methode „id
“ aufgerufen wird. Rufe vor dem Aufruf dieser Methode immer startCustomTouchCalibration
auf. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.
Parameters
-
Paare
Die Zugangspunktpaare, die zur Kalibrierung des Displays verwendet werden.
-
Grenzen
Grenzen des Displays bei der Touch-Kalibrierung. Die Werte
bounds.left
undbounds.top
werden ignoriert.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
Aktiviert bzw. deaktiviert die Unified Desktop-Funktion. Wenn diese Option aktiviert ist, während die Spiegelung aktiv ist, ändert sich der Desktopmodus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wird der Desktopmodus sofort in den Modus „Einheitlich“ geändert. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
Parameters
-
aktiviert
boolean
„True“, wenn Unified Desktop aktiviert werden soll.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
Fordert die Layoutinformationen für alle Displays an. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
Parameters
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(layouts: DisplayLayout[]) => void
-
Layouts
-
Rückgaben
-
Promise<DisplayLayout[]>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.
Parameters
-
flags
GetInfoFlags optional
Chrome 59 und höherOptionen, die beeinflussen, wie die Informationen zurückgegeben werden.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Rückgaben
-
Promise<DisplayUnitInfo[]>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Passt die aktuellen Overscan-Einsätze für eine Anzeige an. In der Regel sollte die Anzeige dadurch entweder entlang einer Achse verschoben (z.B. haben links und rechts denselben Wert) oder sie entlang einer Achse skaliert werden (z.B. haben oben und unten unterschiedliche Werte). Die Werte von Adjust werden mit den vorangegangenen Anrufen seit Beginn kumuliert.
Parameters
-
id
String
Die eindeutige ID des Displays.
-
Delta
Wert zum Ändern der Overscan-Einsätze.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Schließen Sie Overscan-Anpassungen für eine Anzeige ab, indem Sie die aktuellen Werte speichern und das Overlay ausblenden.
Parameters
-
id
String
Die eindeutige ID des Displays.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Setzt die Overscan-Einsätze für eine Anzeige auf den zuletzt gespeicherten Wert zurück (d. h., bevor Start aufgerufen wurde).
Parameters
-
id
String
Die eindeutige ID des Displays.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
Startet die Overscan-Kalibrierung für einen Bildschirm. Daraufhin wird ein Overlay auf dem Bildschirm eingeblendet, das die aktuellen Overscan-Einsätze angibt. Wenn die Overscan-Kalibrierung für das Display id
läuft, wird dadurch die Kalibrierung zurückgesetzt.
Parameters
-
id
String
Die eindeutige ID des Displays.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
Legen Sie das Layout für alle Bildschirme fest. Für alle Bildschirme, die nicht enthalten sind, wird das Standardlayout verwendet. Falls sich ein Layout überlappen würde oder anderweitig ungültig wäre, wird es an ein gültiges Layout angepasst. Nachdem das Layout aufgelöst wurde, wird ein onDisplayChanged-Ereignis ausgelöst. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
Parameters
-
Layouts
Die Layoutinformationen, die für alle Bildschirme außer dem Hauptbildschirm erforderlich sind.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgaben
-
Promise<void>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
Aktualisiert die Eigenschaften für die durch id
angegebene Anzeige gemäß den Informationen in info
. Bei einem Fehler wird runtime.lastError
festgelegt. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
Parameters
-
id
String
Die eindeutige ID des Displays.
-
Info
Die Informationen zu Anzeigeeigenschaften, die geändert werden sollten. Ein Attribut wird nur geändert, wenn in
info
ein neuer Wert dafür angegeben wird. -
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgaben
-
Promise<void>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Legt den Anzeigemodus auf den angegebenen Spiegelmodus fest. Bei jedem Aufruf wird der Status der vorherigen Aufrufe zurückgesetzt. Der Aufruf von „setDisplayProperties()“ schlägt für die Zielbildschirme für die Spiegelung fehl. HINWEIS: Diese Option ist nur für Chrome OS-Kiosk-Apps und die Weboberfläche verfügbar.
Parameters
-
Info
Die Informationen zum Spiegelungsmodus, die auf den Anzeigemodus angewendet werden sollen.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgaben
-
Promise<void>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Zeigt die UX der nativen Touch-Kalibrierung für das Display mit id
als Anzeige-ID an. Daraufhin wird ein Overlay auf dem Bildschirm mit den erforderlichen Schritten angezeigt. Der Callback wird nur im Fall einer erfolgreichen Kalibrierung aufgerufen. Wenn die Kalibrierung fehlschlägt, wird ein Fehler ausgegeben.
Parameters
-
id
String
Die eindeutige ID des Displays.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolgreich
boolean
-
Rückgaben
-
Promise<boolean>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Startet die benutzerdefinierte Touch-Kalibrierung für ein Display. Dies sollte aufgerufen werden, wenn eine benutzerdefinierte UX zum Erfassen von Kalibrierungsdaten verwendet wird. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.
Parameters
-
id
String
Die eindeutige ID des Displays.
Veranstaltungen
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich die Anzeigekonfiguration ändert
Parameters
-
callback
Funktion
Der Parameter
callback
sieht so aus:() => void