chrome.system.display (original) (raw)

Zum Hauptinhalt springen

• Docs

  • Übersicht
  • Jetzt starten
  • Entwickeln
  • Anleitungen
  • KI
  • Referenzen
  • Beispiele
  • Chrome Web Store

• Fallstudien

• Blog

• Neu in Chrome

• Manifest V3

• ➡ Manifest V2

• accessibilityFeatures

• action

• alarms

• audio

• bookmarks

• browsingData

• certificateProvider

• commands

• contentSettings

• contextMenus

• cookies

• debugger

• declarativeContent

• declarativeNetRequest

• desktopCapture

• devtools.inspectedWindow

• devtools.network

• devtools.panels

• devtools.performance

• devtools.recorder

• dns

• documentScan

• dom

• downloads

• enterprise.deviceAttributes

• enterprise.hardwarePlatform

• enterprise.login

• enterprise.networkingAttributes

• enterprise.platformKeys

• events

• extension

• extensionTypes

• fileBrowserHandler

• fileSystemProvider

• fontSettings

• gcm

• history

• i18n

• identity

• idle

• input.ime

• instanceID

• loginState

• management

• notifications

• offscreen

• omnibox

• pageCapture

• permissions

• platformKeys

• power

• printerProvider

• printing

• printingMetrics

• privacy

• processes

• proxy

• readingList

• runtime

• scripting

• search

• sessions

• sidePanel

• storage

• system.cpu

• system.display

• system.memory

• system.storage

• systemLog

• tabCapture

• tabGroups

• tabs

• topSites

• tts

• ttsEngine

• types

• userScripts

• vpnProvider

• wallpaper

• webAuthenticationProxy

• webNavigation

• webRequest

• windows

chrome.system.display

Beschreibung

Verwenden Sie die system.display API, um Display-Metadaten abzufragen.

Berechtigungen

system.display

Typen

ActiveState

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

Bounds

Attribute

• Die Höhe des Displays in Pixeln.
• Die X-Koordinate der oberen linken Ecke.
• Die Y-Koordinate der oberen linken Ecke.
• Die Breite des Displays in Pixeln.

DisplayLayout

Attribute

• Die eindeutige ID des Displays.
• Der Versatz des Displays entlang der verbundenen Kante. 0 gibt an, dass die oberen oder linken Ecken ausgerichtet sind.
• Die eindeutige ID des übergeordneten Displays. Leer, wenn es sich um den Stamm handelt.
• Die Layoutposition dieser Anzeige relativ zum übergeordneten Element. Dies wird für den Stamm ignoriert.

DisplayMode

Attribute

• Der Geräteskalierungsfaktor für den Anzeigemodus.
• 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
  „True“, wenn dieser Modus verschachtelt ist, andernfalls „false“.
• „True“, wenn der Modus der native Modus des Displays ist.
• „true“, wenn der Anzeigemodus derzeit ausgewählt ist.
• Die Aktualisierungsrate des Anzeigemodus in Hertz.
• Seit Chrome 70 eingestellt
  „displayZoomFactor“ verwenden
  Der UI-Skalierungsfaktor für den Anzeigemodus.
• Die Breite des Anzeigemodus in geräteunabhängigen (für den Nutzer sichtbaren) Pixeln.
• 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
  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
  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
  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.
• 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

• Aktiv, wenn das Display vom System erkannt und verwendet wird.
• availableDisplayZoomFactors
  number[]
  Eine Liste der Zoomfaktoren, die für die Anzeige festgelegt werden können.
• Die logischen Grenzen des Displays.
• 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.
• Die Anzahl der Pixel pro Zoll entlang der x-Achse.
• Die Anzahl der Pixel pro Zoll entlang der y-Achse.
• HINWEIS: Diese Funktion ist nur für ChromeOS-Kiosk-Apps und die Weboberfläche verfügbar.
• „True“, wenn diesem Display ein Touch-Eingabegerät zugeordnet ist.
• Die eindeutige ID des Displays.
• „True“, wenn dieser Bildschirm aktiviert ist.
• „True“, wenn dies das primäre Display ist.
• Gilt für alle Displays im Unified Desktop-Modus. Weitere Informationen finden Sie in der Dokumentation zu enableUnifiedDesktop.
• mirroringDestinationIds
  String[]
  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.
• 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.
• 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.
• Der nutzerfreundliche Name (z.B. „HP LCD-Monitor“).
• Die Insets des Displays innerhalb der Grenzen des Bildschirms. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf leere Insets gesetzt.
• 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.
• 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

Attribute

• Dreistelliger Herstellercode. Siehe Abschnitt 3.4.1, Seite 21. In Version 1.4 erforderlich.
• 2-Byte-Code, der vom Hersteller zugewiesen wird, Abschnitt 3.4.2, Seite 21. In Version 1.4 erforderlich.
• Herstellungsjahr, Abschnitt 3.4.4, Seite 22. In Version 1.4 erforderlich.

GetInfoFlags

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

• Der Abstand der Y-Achse von der Untergrenze.
• Der Abstand der X-Achse vom linken Rand.
• Der Abstand der X-Achse vom rechten Rand.
• Der Y-Achsen-Abstand von der oberen Grenze.

LayoutPosition

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

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

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

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“.
• Der Spiegelmodus, der eingestellt werden soll.

Point

Attribute

• Die x-Koordinate des Punkts.
• Die y-Koordinate des Punkts.

TouchCalibrationPair

Attribute

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

TouchCalibrationPairQuad

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

• Die eindeutige ID des Displays.

completeCustomTouchCalibration()

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.
• Grenzen des Displays, als die Touch-Kalibrierung durchgeführt wurde. bounds.left- und bounds.top-Werte werden ignoriert.

enableUnifiedDesktop()

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

• „True“, wenn der einheitliche Desktop aktiviert werden soll.

getDisplayLayout()

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

getInfo()

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
): Promise<DisplayUnitInfo[]>

Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.

Parameter

• flags
  GetInfoFlags optional
  Optionen, die sich darauf auswirken, wie die Informationen zurückgegeben werden.

Ausgabe

• Promise<DisplayUnitInfo[]>

overscanCalibrationAdjust()

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

• Die eindeutige ID des Displays.
• Der Betrag, um den die Overscan-Einzüge geändert werden sollen.

overscanCalibrationComplete()

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

• Die eindeutige ID des Displays.

overscanCalibrationReset()

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

• Die eindeutige ID des Displays.

overscanCalibrationStart()

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

• Die eindeutige ID des Displays.

setDisplayLayout()

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

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

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

Ausgabe

setDisplayProperties()

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): Promise

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

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

Ausgabe

setMirrorMode()

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise

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.

Ausgabe

showNativeTouchCalibration()

chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise

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

• Die eindeutige ID des Displays.

Ausgabe

startCustomTouchCalibration()

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

• 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

• Der Parameter callback sieht so aus:
  () => void

Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.

Zuletzt aktualisiert: 2025-12-11 (UTC).