chrome.system.display

Beschrijving

Gebruik de system.display API om weergavemetadata op te vragen.

Toestemmingen

system.display

Soorten

ActiveState

Chrome 117+

Een enum die aangeeft of het scherm door het systeem wordt gedetecteerd en gebruikt. Het scherm wordt als 'inactief' beschouwd als het niet door het systeem wordt gedetecteerd (bijvoorbeeld omdat het is losgekoppeld of als het als losgekoppeld wordt beschouwd vanwege de slaapstand, enz.). Deze status wordt bijvoorbeeld gebruikt om een ​​bestaand scherm te behouden wanneer alle schermen zijn losgekoppeld.

Enum

"actief"

"inactief"

Bounds

Eigenschappen

  • hoogte

    nummer

    De hoogte van het scherm in pixels.

  • links

    nummer

    De x-coördinaat van de linkerbovenhoek.

  • bovenkant

    nummer

    De y-coördinaat van de linkerbovenhoek.

  • breedte

    nummer

    De breedte van het scherm in pixels.

DisplayLayout

Chrome 53+

Eigenschappen

  • id

    snaar

    De unieke identificatiecode van het scherm.

  • verschuiving

    nummer

    De verschuiving van het scherm langs de verbonden rand. 0 geeft aan dat de bovenste of meest linkse hoeken zijn uitgelijnd.

  • ouder-ID

    snaar

    The unique identifier of the parent display. Empty if this is the root.

  • De lay-outpositie van dit scherm ten opzichte van het bovenliggende element. Deze positie wordt voor het hoofdelement genegeerd.

DisplayMode

Chrome 52+

Eigenschappen

  • apparaatScaleFactor

    nummer

    De schaalverfactor van het weergavemodusapparaat.

  • hoogte

    nummer

    De hoogte van de weergavemodus in apparaatonafhankelijke (voor de gebruiker zichtbare) pixels.

  • hoogteInNativePixels

    nummer

    De hoogte van de weergavemodus in native pixels.

  • isInterlaced

    boolean optioneel

    Chrome 74+

    Waar als deze modus interlaced is, onwaar als deze niet is opgegeven.

  • isNative

    booleaans

    Dit is waar als de modus de standaardmodus van het scherm is.

  • isGeselecteerd

    booleaans

    Retourneert waar als de weergavemodus momenteel is geselecteerd.

  • verversingsfrequentie

    nummer

    Chrome 67+

    De verversingsfrequentie van de weergavemodus in hertz.

  • uiScale

    nummer optioneel

    Niet meer bruikbaar sinds Chrome 70.

    Gebruik displayZoomFactor

    De schaalverfactor van de gebruikersinterface in de weergavemodus.

  • breedte

    nummer

    De breedte van de weergavemodus in apparaatonafhankelijke (voor de gebruiker zichtbare) pixels.

  • breedteInNativePixels

    nummer

    De breedte van de weergavemodus in native pixels.

DisplayProperties

Eigenschappen

  • grenzenOorsprongX

    nummer optioneel

    If set, updates the display's logical bounds origin along the x-axis. Applied together with boundsOriginY . Defaults to the current value if not set and boundsOriginY is set. Note that when updating the display origin, some constraints will be applied, so the final bounds origin may be different than the one set. The final bounds can be retrieved using getInfo . The bounds origin cannot be changed on the primary display.

  • grenzenOorsprongY

    nummer optioneel

    Indien ingesteld, wordt de oorsprong van de logische grenzen van het scherm langs de y-as bijgewerkt. Zie de documentatie voor de parameter boundsOriginX .

  • weergavemodus

    DisplayMode optioneel

    Chrome 52+

    Indien ingesteld, wordt de weergavemodus bijgewerkt naar de modus die overeenkomt met deze waarde. Als andere parameters ongeldig zijn, wordt dit niet toegepast. Als de weergavemodus ongeldig is, wordt deze niet toegepast en wordt er een foutmelding weergegeven, maar andere eigenschappen blijven wel van toepassing.

  • displayZoomFactor

    nummer optioneel

    Chrome 65+

    Indien ingesteld, wordt de zoomfactor van het scherm bijgewerkt. Deze zoomfunctie voert een herindeling en hertekening uit, wat resulteert in een betere zoomkwaliteit dan een eenvoudige pixel-voor-pixel vergroting.

  • isPrimair

    boolean optioneel

    Als deze waarde op 'true' is ingesteld, wordt het scherm als primair beschouwd. Als de waarde op 'false' is ingesteld, gebeurt er niets. Opmerking: Indien ingesteld, wordt het scherm als primair beschouwd voor alle andere eigenschappen (d.w.z. ' isUnified kan wel ingesteld zijn, maar 'bounds origin' niet).

  • isUnified

    boolean optioneel

    Chrome 59+

    Alleen voor ChromeOS. Indien ingesteld op true, wordt de weergavemodus gewijzigd naar Unified Desktop (zie enableUnifiedDesktop voor meer informatie). Indien ingesteld op false, wordt de Unified Desktop-modus uitgeschakeld. Dit is alleen geldig voor het primaire scherm. Indien opgegeven, mag mirroringSourceId niet worden opgegeven en worden andere eigenschappen genegeerd. Deze instelling heeft geen effect indien niet opgegeven.

  • mirroringSourceId

    string optioneel

    Niet meer bruikbaar sinds Chrome 68.

    Gebruik setMirrorMode .

    Alleen voor ChromeOS. Indien ingesteld en niet leeg, wordt schermspiegeling alleen voor dit scherm ingeschakeld. Anders wordt schermspiegeling voor alle schermen uitgeschakeld. Deze waarde moet de ID van het te spiegelen bronscherm aangeven. Deze ID mag niet hetzelfde zijn als de ID die is doorgegeven aan setDisplayProperties. Indien ingesteld, mogen geen andere eigenschappen worden ingesteld.

  • overscan

    Insets optional

    Indien ingesteld, worden de overscan-inzetwaarden van het scherm ingesteld op de opgegeven waarden. Houd er rekening mee dat overscan-waarden niet negatief mogen zijn en niet groter dan de helft van de schermgrootte. Overscan kan niet worden gewijzigd op de interne monitor.

  • rotatie

    nummer optioneel

    Indien ingesteld, wordt de rotatie van het scherm bijgewerkt. Toegestane waarden zijn [0, 90, 180, 270]. De rotatie wordt met de klok mee ingesteld, ten opzichte van de verticale positie van het scherm.

DisplayUnitInfo

Eigenschappen

  • actieveStatus

    Actieve status

    Chrome 117+

    Actief als het beeldscherm door het systeem wordt gedetecteerd en gebruikt.

  • beschikbare weergavezoomfactoren

    nummer[]

    Chrome 67+

    Een lijst met zoomfactorwaarden die voor het scherm kunnen worden ingesteld.

  • grenzen

    Grenzen

    De logische grenzen van het scherm.

  • displayZoomFactor

    nummer

    Chrome 65+

    De verhouding tussen de huidige en de standaard zoomfactor van het scherm. Bijvoorbeeld, waarde 1 komt overeen met 100% zoom en waarde 1,5 met 150% zoom.

  • dpiX

    nummer

    Het aantal pixels per inch langs de x-as.

  • dpiY

    nummer

    Het aantal pixels per inch langs de y-as.

  • edid

    Edid optional

    Chrome 67+

    LET OP: Deze functie is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

  • heeft TouchSupport

    booleaans

    Chrome 57+

    Dit klopt als er een aanraakgevoelig invoerapparaat aan dit scherm is gekoppeld.

  • id

    snaar

    De unieke identificatiecode van het scherm.

  • isIngeschakeld

    booleaans

    Als dit scherm is ingeschakeld, klopt dit.

  • isPrimair

    booleaans

    Dit klopt als dit het primaire scherm is.

  • isUnified

    booleaans

    Chrome 59+

    Dit geldt voor alle beeldschermen in de modus 'Unified Desktop'. Zie de documentatie voor enableUnifiedDesktop .

  • spiegelende bestemmings-ID's

    snaar[]

    Chrome 64+

    Alleen voor ChromeOS. Identificaties van de schermen waarnaar het bronscherm wordt gespiegeld. Leeg als er geen schermen worden gespiegeld. Deze waarde wordt voor alle schermen gelijk ingesteld. Deze waarde mag mirroringSourceId niet bevatten.

  • mirroringSourceId

    snaar

    Alleen voor ChromeOS. Identificatiecode van het scherm dat wordt gespiegeld als spiegelen is ingeschakeld, anders leeg. Deze waarde wordt ingesteld voor alle schermen (inclusief het scherm dat wordt gespiegeld).

  • modi

    Weergavemodus []

    Chrome 52+

    De lijst met beschikbare weergavemodi. De huidige modus heeft isSelected=true. Alleen beschikbaar op ChromeOS. Wordt op andere platforms ingesteld op een lege array.

  • naam

    snaar

    De gebruiksvriendelijke naam (bijvoorbeeld "HP LCD-monitor").

  • overscan

    Inzetstukken

    De randen van het scherm. Momenteel alleen zichtbaar op ChromeOS. Worden op andere platforms als lege randen weergegeven.

  • rotatie

    nummer

    De rotatie van het scherm met de klok mee in graden ten opzichte van de verticale positie. Momenteel alleen zichtbaar op ChromeOS. Wordt op andere platforms op 0 ingesteld. Een waarde van -1 wordt geïnterpreteerd als automatisch roteren wanneer het apparaat in de fysieke tabletmodus staat.

  • werkgebied

    Bounds

    Het bruikbare werkgebied van het scherm binnen de schermgrenzen. Het werkgebied sluit delen van het scherm uit die gereserveerd zijn voor het besturingssysteem, zoals de taakbalk en de launcher.

Edid

Chrome 67+

Eigenschappen

  • fabrikant-ID

    snaar

    Fabrikantcode van 3 tekens. Zie paragraaf 3.4.1, pagina 21. Vereist in versie 1.4.

  • productId

    snaar

    2-byte fabrikantcode, sectie 3.4.2 pagina 21. Vereist in versie 1.4.

  • fabricagejaar

    nummer

    Bouwjaar, paragraaf 3.4.4, pagina 22. Vereist in versie 1.4.

GetInfoFlags

Chrome 59+

Eigenschappen

Insets

Eigenschappen

  • onderkant

    nummer

    De afstand op de y-as vanaf de ondergrens.

  • links

    nummer

    De afstand op de x-as vanaf de linkergrens.

  • rechts

    nummer

    De afstand op de x-as vanaf de rechtergrens.

  • bovenkant

    nummer

    De afstand op de y-as vanaf de bovengrens.

LayoutPosition

Chrome 53+

De positie in de lay-out, oftewel de rand van het ouderobject waaraan het scherm is bevestigd.

Enum

"bovenkant"

"rechts"

"onderkant"

"links"

MirrorMode

Chrome 65+

Spiegelmodus, oftewel verschillende manieren waarop een scherm naar andere schermen wordt gespiegeld.

Enum

"uit"
Hiermee wordt de standaardmodus ingesteld (uitgebreid of uniform bureaublad).

"normaal"
Geeft aan dat het standaardbronscherm naar alle andere schermen wordt gespiegeld.

"gemengd"
Geeft aan dat het opgegeven bronscherm wordt gespiegeld naar de opgegeven doelschermen. Alle andere aangesloten schermen worden uitgebreid.

MirrorModeInfo

Chrome 65+

Eigenschappen

  • spiegelende bestemmings-ID's

    string[] optioneel

    De ID's van de spiegelbestemmingen worden weergegeven. Dit is alleen geldig voor 'gemengde' configuraties.

  • mirroringSourceId

    string optioneel

    De ID van het scherm van de spiegelbron. Dit is alleen geldig voor 'mixed'.

  • De spiegelmodus die ingesteld moet worden.

Point

Chrome 57+

Eigenschappen

  • X

    nummer

    De x-coördinaat van het punt.

  • y

    nummer

    De y-coördinaat van het punt.

TouchCalibrationPair

Chrome 57+

Eigenschappen

  • displayPoint

    Punt

    De coördinaten van het weergavepunt.

  • touchPoint

    Punt

    De coördinaten van het aanraakpunt dat overeenkomt met het weergavepunt.

TouchCalibrationPairQuad

Chrome 57+

Eigenschappen

  • Het eerste paar aanraak- en weergavepunten is nodig voor de aanraakkalibratie.

  • Een tweede paar aanraak- en weergavepunten is nodig voor de aanraakkalibratie.

  • Een derde paar aanraak- en weergavepunten is nodig voor aanraakkalibratie.

  • Het vierde paar aanraak- en weergavepunten is nodig voor de aanraakkalibratie.

Methoden

clearTouchCalibration()

Chrome 57+
chrome.system.display.clearTouchCalibration(
  id: string,
): void

Hiermee worden de aanraakkalibratie van het scherm gereset en teruggezet naar de standaardinstellingen door alle aanraakkalibratiegegevens die aan het scherm zijn gekoppeld te wissen.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

completeCustomTouchCalibration()

Chrome 57+
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

Stelt de aanraakkalibratieparen in voor een beeldscherm. Deze pairs worden gebruikt om het touchscreen te kalibreren voor het beeldscherm met de opgegeven id in startCustomTouchCalibration(). Roep altijd eerst startCustomTouchCalibration aan voordat u deze methode aanroept. Als er al een andere aanraakkalibratie bezig is, wordt er een foutmelding gegenereerd.

Parameters

  • De puntenparen die gebruikt worden om het beeldscherm te kalibreren.

  • grenzen

    Grenzen

    De grenzen van het scherm tijdens de touchkalibratie. De waarden bounds.left en bounds.top worden genegeerd.

enableUnifiedDesktop()

Chrome 46+
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

Hiermee kunt u de functie voor het uniforme bureaublad in- of uitschakelen. Indien ingeschakeld terwijl schermspiegeling actief is, blijft de bureaubladmodus ongewijzigd totdat schermspiegeling wordt uitgeschakeld. Anders schakelt de bureaubladmodus direct over naar het uniforme bureaublad. LET OP: Deze functie is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • ingeschakeld

    booleaans

    Waar als het uniforme bureaublad moet worden ingeschakeld.

getDisplayLayout()

Promise Chrome 53+
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

Vraagt ​​de lay-outinformatie op voor alle schermen. LET OP: Deze functie is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (layouts: DisplayLayout[]) => void

Retourneert

  • Promise< DisplayLayout []>

    Chrome 91+

    Een belofte die wordt ingelost met de resultaten.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getInfo()

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

Vraagt ​​de gegevens op van alle aangesloten beeldschermen.

Parameters

  • vlaggen

    GetInfoFlags optioneel

    Chrome 59+

    Opties die bepalen hoe de informatie wordt weergegeven.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (displayInfo: DisplayUnitInfo[]) => void

Retourneert

  • Promise< DisplayUnitInfo []>

    Chrome 91+

    Een belofte die wordt ingelost met de resultaten.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

overscanCalibrationAdjust()

Chrome 53+
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

Hiermee worden de huidige overscan-inzetwaarden voor een beeldscherm aangepast. Dit zou normaal gesproken het beeldscherm langs een as moeten verschuiven (bijvoorbeeld links en rechts hebben dezelfde waarde) of langs een as moeten schalen (bijvoorbeeld boven en onder hebben tegengestelde waarden). Elke aanroep van de functie 'Aanpassen' telt op bij eerdere aanroepen sinds 'Start'.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

  • De hoeveelheid waarmee de overscan-inzetstukken moeten worden aangepast.

overscanCalibrationComplete()

Chrome 53+
chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

Voltooi de overscan-aanpassingen voor een beeldscherm door de huidige waarden op te slaan en de overlay te verbergen.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

overscanCalibrationReset()

Chrome 53+
chrome.system.display.overscanCalibrationReset(
  id: string,
): void

Hiermee worden de overscan-inzetwaarden voor een beeldscherm teruggezet naar de laatst opgeslagen waarde (d.w.z. voordat Start werd aangeroepen).

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

overscanCalibrationStart()

Chrome 53+
chrome.system.display.overscanCalibrationStart(
  id: string,
): void

Start de overscan-kalibratie voor een beeldscherm. Er verschijnt een overlay op het scherm met de huidige overscan-instellingen. Als de overscan-kalibratie voor beeldscherm- id al bezig is, wordt de kalibratie gereset.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

setDisplayLayout()

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

Stel de lay-out in voor alle schermen. Elk scherm dat niet is opgenomen, gebruikt de standaardlay-out. Als een lay-out overlapt of anderszins ongeldig is, wordt deze aangepast naar een geldige lay-out. Nadat de lay-out is bepaald, wordt een onDisplayChanged-gebeurtenis geactiveerd. LET OP: Deze functie is alleen beschikbaar voor ChromeOS Kiosk-apps en webinterfaces.

Parameters

  • lay-outs

    DisplayLayout []

    De lay-outinformatie is vereist voor alle schermen, behalve het primaire scherm.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Een belofte die wordt ingelost wanneer de functie is voltooid.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setDisplayProperties()

Belofte
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

Updates the properties for the display specified by id , according to the information provided in info . On failure, runtime.lastError will be set. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

  • De informatie over weergave-eigenschappen die gewijzigd moeten worden. Een eigenschap wordt alleen gewijzigd als er een nieuwe waarde voor is opgegeven in info .

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Een belofte die wordt ingelost wanneer de functie is voltooid.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setMirrorMode()

Promise Chrome 65+
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

Stelt de weergavemodus in op de opgegeven spiegelmodus. Elke aanroep reset de status van de vorige aanroep. Het aanroepen van setDisplayProperties() zal mislukken voor de spiegelende doelschermen. OPMERKING: Deze functie is alleen beschikbaar voor ChromeOS Kiosk-apps en webinterfaces.

Parameters

  • informatie

    MirrorModeInfo

    De informatie over de spiegelmodus die op de weergavemodus moet worden toegepast.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Een belofte die wordt ingelost wanneer de functie is voltooid.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

showNativeTouchCalibration()

Promise Chrome 57+
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

Toont de native touchkalibratie-UX voor het scherm met id display-ID. Er verschijnt een overlay op het scherm met de benodigde instructies voor de te volgen procedure. De callback-functie wordt alleen aangeroepen bij een succesvolle kalibratie. Bij een mislukte kalibratie wordt een foutmelding gegenereerd.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (success: boolean) => void

    • succes

      booleaans

Retourneert

  • Belofte<boolean>

    Chrome 91+

    Een belofte die wordt opgelost om de beller te laten weten dat de aanraakkalibratie is voltooid. De booleaanse waarde geeft aan of de kalibratie geslaagd is of niet.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

startCustomTouchCalibration()

Chrome 57+
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

Start een aangepaste aanraakkalibratie voor een beeldscherm. Deze functie moet worden aangeroepen wanneer een aangepaste gebruikersinterface wordt gebruikt voor het verzamelen van kalibratiegegevens. Als er al een andere aanraakkalibratie bezig is, wordt er een foutmelding gegenereerd.

Parameters

  • id

    snaar

    De unieke identificatiecode van het scherm.

Evenementen

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Wordt geactiveerd wanneer er iets verandert aan de weergaveconfiguratie.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    () => void