browser.system.display

Beschrijving

Gebruik de system.display API om display-metadata op te vragen.

Rechten

system.display

Typen

ActiveState

Chrome 117 of hoger browser.* sinds Chrome 148

Een enum om aan te geven of het scherm wordt gedetecteerd en gebruikt door het systeem. Het scherm wordt als inactief beschouwd als het niet wordt gedetecteerd door het systeem (misschien is de verbinding verbroken of wordt de verbinding als verbroken beschouwd vanwege de slaapstand, enzovoort). Deze status wordt bijvoorbeeld gebruikt om de bestaande weergave te behouden als de verbinding met alle schermen is verbroken.

Enum

active

inactive

Bounds

Eigenschappen

  • hoogte

    getal

    De hoogte van het scherm in pixels.

  • links

    getal

    De x-coördinaat van de linkerbovenhoek.

  • boven

    getal

    De y-coördinaat van de linkerbovenhoek.

  • breedte

    getal

    De breedte van het scherm in pixels.

DisplayLayout

Chrome 53+ browser.* sinds Chrome 148

Eigenschappen

  • id

    tekenreeks

    De unieke ID van het scherm.

  • gecompenseerd

    getal

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

  • parentId

    tekenreeks

    De unieke ID van het bovenliggende scherm. Leeg als dit de root is.

  • position

    LayoutPosition

    De positie van de indeling van dit scherm ten opzichte van het bovenliggende scherm. Dit wordt genegeerd voor de root.

DisplayMode

Chrome 52+ browser.* sinds Chrome 148

Eigenschappen

  • deviceScaleFactor

    getal

    De schaalfactor van het apparaat voor de weergavemodus.

  • hoogte

    getal

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

  • heightInNativePixels

    getal

    De hoogte van de weergavemodus in native pixels.

  • isInterlaced

    booleaans optioneel

    Chrome 74 of hoger browser.* sinds Chrome 148

    Waar als deze modus is geïnterlinieerd, onwaar als deze niet is verstrekt.

  • isNative

    booleaans

    True als de modus de native modus van het scherm is.

  • isSelected

    booleaans

    Waar als de weergavemodus op dit moment is geselecteerd.

  • refreshRate

    getal

    Chrome 67 of hoger browser.* sinds Chrome 148

    De vernieuwingssnelheid van de weergavemodus in hertz.

  • uiScale

    number optioneel

    Beëindigd sinds Chrome 70

    displayZoomFactor gebruiken

    De schaalfactor van de UI van de weergavemodus.

  • breedte

    getal

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

  • widthInNativePixels

    getal

    De breedte van de weergavemodus in native pixels.

DisplayProperties

Eigenschappen

  • boundsOriginX

    number optioneel

    Als deze optie is ingesteld, wordt de oorsprong van de logische grenzen van het scherm geüpdatet langs de x-as. Samen met boundsOriginY toegepast. De standaardwaarde is de huidige waarde als deze niet is ingesteld en boundsOriginY is ingesteld. Als je de weergaveoorsprong updatet, worden er bepaalde beperkingen toegepast. De uiteindelijke oorsprong van de grenzen kan dus afwijken van de ingestelde oorsprong. Je kunt de uiteindelijke grenzen ophalen met getInfo. De oorsprong van de grenzen kan niet worden gewijzigd op het primaire scherm.

  • boundsOriginY

    number optioneel

    Als deze optie is ingesteld, wordt de oorsprong van de logische grenzen van het scherm langs de y-as geüpdatet. Bekijk de documentatie voor de parameter boundsOriginX.

  • displayMode

    DisplayMode optioneel

    Chrome 52+ browser.* sinds Chrome 148

    Als je dit instelt, wordt de weergavemodus geüpdatet naar de modus die overeenkomt met deze waarde. Als andere parameters ongeldig zijn, wordt deze niet toegepast. Als de weergavemodus ongeldig is, wordt deze niet toegepast en wordt er een fout ingesteld, maar worden andere eigenschappen nog steeds toegepast.

  • displayZoomFactor

    number optioneel

    Chrome 65+ browser.* sinds Chrome 148

    Als deze optie is ingesteld, wordt de zoomfactor van het scherm geüpdatet. Deze zoomfunctie voert een nieuwe indeling en een nieuwe weergave uit, wat resulteert in een zoom van betere kwaliteit dan wanneer je alleen een pixel-voor-pixel-vergroting uitvoert.

  • isPrimary

    booleaans optioneel

    Als je dit instelt op True, wordt het scherm het primaire scherm. No-op als je dit beleid instelt op False. Opmerking: Als dit is ingesteld, wordt het scherm als primair beschouwd voor alle andere property's (isUnified kan bijvoorbeeld worden ingesteld en de oorsprong van de grenzen niet).

  • isUnified

    booleaans optioneel

    Chrome 59+ browser.* sinds Chrome 148

    Alleen ChromeOS. Als je dit instelt op True, wordt de weergavemodus gewijzigd in Unified Desktop (zie enableUnifiedDesktop voor meer informatie). Als je dit beleid instelt op False, wordt de samengestelde desktopmodus uitgezet. Dit is alleen geldig voor het primaire scherm. Als dit is ingevoerd, mag mirroringSourceId niet worden ingevoerd en worden andere property's genegeerd. Dit heeft geen effect als je dit niet invoert.

  • mirroringSourceId

    tekenreeks optioneel

    Beëindigd sinds Chrome 68

    Gebruik setMirrorMode.

    Alleen ChromeOS. Als je dit beleid instelt en niet leeg laat, wordt dupliceren alleen voor dit scherm aangezet. Anders wordt mirroring uitgezet voor alle schermen. Deze waarde moet de ID aangeven van het bronscherm dat moet worden gespiegeld. Deze mag niet hetzelfde zijn als de ID die is doorgegeven aan setDisplayProperties. Als deze is ingesteld, kan er geen andere property worden ingesteld.

  • overscan

    Insets optioneel

    Als je dit beleid instelt, worden de overscan-insets van het scherm ingesteld op de ingevoerde waarden. Overscan-waarden mogen niet negatief zijn of groter zijn dan de helft van de schermgrootte. Overscan kan niet worden gewijzigd op de interne monitor.

  • rotatie

    number optioneel

    Als je dit instelt, wordt de rotatie van het scherm geüpdatet. Geldige waarden zijn [0, 90, 180, 270]. De rotatie is rechtsom ingesteld, ten opzichte van de verticale positie van het scherm.

DisplayUnitInfo

Eigenschappen

  • activeState

    ActiveState

    Chrome 117 of hoger browser.* sinds Chrome 148

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

  • availableDisplayZoomFactors

    number[]

    Chrome 67 of hoger browser.* sinds Chrome 148

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

  • grenzen

    Grenzen

    De logische grenzen van het scherm.

  • displayZoomFactor

    getal

    Chrome 65+ browser.* sinds Chrome 148

    De verhouding tussen de huidige en standaardzoom van het scherm. De waarde 1 staat bijvoorbeeld gelijk aan 100% zoom en de waarde 1,5 staat gelijk aan 150% zoom.

  • dpiX

    getal

    Het aantal pixels per inch langs de x-as.

  • dpiY

    getal

    Het aantal pixels per inch langs de y-as.

  • edid

    Edid optioneel

    Chrome 67 of hoger browser.* sinds Chrome 148

    OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps.

  • hasTouchSupport

    booleaans

    Chrome 57+ browser.* sinds Chrome 148

    Waar als dit scherm een gekoppeld invoerapparaat voor bediening via touchscreen heeft.

  • id

    tekenreeks

    De unieke ID van het scherm.

  • isEnabled

    booleaans

    True als dit scherm aanstaat.

  • isPrimary

    booleaans

    Waar als dit het primaire scherm is.

  • isUnified

    booleaans

    Chrome 59+ browser.* sinds Chrome 148

    Waar voor alle schermen in de samengestelde desktopmodus. Bekijk de documentatie voor enableUnifiedDesktop.

  • mirroringDestinationIds

    tekenreeks[]

    Chrome 64+ browser.* sinds Chrome 148

    Alleen ChromeOS. ID's van de schermen waarop het bronscherm wordt gespiegeld. Leeg als er geen schermen worden gedupliceerd. Deze wordt voor alle schermen op dezelfde waarde ingesteld. Dit mag niet mirroringSourceId bevatten.

  • mirroringSourceId

    tekenreeks

    Alleen ChromeOS. ID van het scherm dat wordt gedupliceerd als dupliceren aanstaat, anders leeg. Dit wordt ingesteld voor alle schermen (waaronder het scherm dat wordt gespiegeld).

  • modi

    DisplayMode[]

    Chrome 52+ browser.* sinds Chrome 148

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

  • name

    tekenreeks

    De gebruiksvriendelijke naam (bijvoorbeeld HP LCD-monitor).

  • overscan

    Invoegingen

    De insets van het scherm binnen de grenzen van het scherm. Op dit moment alleen beschikbaar op ChromeOS. Wordt op andere platforms ingesteld op lege insets.

  • rotatie

    getal

    De rotatie van het scherm rechtsom in graden ten opzichte van de verticale positie. Op dit moment alleen beschikbaar op ChromeOS. Wordt op andere platforms ingesteld op 0. Een waarde van -1 wordt geïnterpreteerd als automatisch draaien als het apparaat zich in een fysieke tabletstatus bevindt.

  • workArea

    Grenzen

    Het bruikbare werkgebied van het scherm binnen de schermgrenzen. Het werkgebied omvat geen gebieden van het scherm die zijn gereserveerd voor het OS, zoals de taakbalk en de Launcher.

Edid

Chrome 67 of hoger browser.* sinds Chrome 148

Eigenschappen

  • manufacturerId

    tekenreeks

    Fabrikantcode van 3 tekens. Zie artikel 3.4.1, pagina 21. Vereist in v1.4.

  • productId

    tekenreeks

    Door de fabrikant toegewezen code van 2 bytes, Sec. 3.4.2 pagina 21. Vereist in v1.4.

  • yearOfManufacture

    getal

    Bouwjaar, artikel 3.4.4, pagina 22. Vereist in v1.4.

GetInfoFlags

Chrome 59+ browser.* sinds Chrome 148

Eigenschappen

  • singleUnified

    booleaans optioneel

    Als je dit instelt op True, wordt er maar één DisplayUnitInfo geretourneerd door getInfo in de samengestelde desktopmodus (zie enableUnifiedDesktop). De standaardinstelling is False.

Insets

Eigenschappen

  • onder

    getal

    De afstand op de y-as vanaf de ondergrens.

  • links

    getal

    De afstand op de x-as vanaf de linkergrens.

  • rechts

    getal

    De afstand op de x-as vanaf de rechtergrens.

  • boven

    getal

    De afstand op de y-as vanaf de bovengrens.

LayoutPosition

Chrome 53+ browser.* sinds Chrome 148

Indelingspositie, d.w.z. de rand van het bovenliggende element waaraan het scherm is gekoppeld.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65+ browser.* sinds Chrome 148

Spiegelmodus, d.w.z. verschillende manieren waarop een scherm wordt gespiegeld naar andere schermen.

Enum

'off'
Hiermee wordt de standaardmodus (uitgebreid of samengevoegd bureaublad) aangegeven.

"normal"
Geeft aan dat het standaardscherm wordt gespiegeld naar alle andere schermen.

"mixed"
Geeft aan dat het aangegeven bronscherm wordt gespiegeld naar de aangegeven doelschermen. Alle andere verbonden schermen worden uitgebreid.

MirrorModeInfo

Chrome 65+ browser.* sinds Chrome 148

Eigenschappen

  • mirroringDestinationIds

    string[] optioneel

    De ID's van de schermen van de duplicaatbestemming. Dit is alleen geldig voor 'mixed'.

  • mirroringSourceId

    tekenreeks optioneel

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

  • modus

    MirrorMode

    De spiegelmodus die moet worden ingesteld.

Point

Chrome 57+ browser.* sinds Chrome 148

Eigenschappen

  • x

    getal

    De x-coördinaat van het punt.

  • j

    getal

    De y-coördinaat van het punt.

TouchCalibrationPair

Chrome 57+ browser.* sinds Chrome 148

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+ browser.* sinds Chrome 148

Eigenschappen

Methoden

clearTouchCalibration()

Chrome 57+ browser.* sinds Chrome 148 
browser.system.display.clearTouchCalibration(
  id: string,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Hiermee wordt de aanraakkalibratie voor het scherm gereset en teruggezet naar de standaardstatus door alle aanraakkalibratiegegevens die aan het scherm zijn gekoppeld, te wissen.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

completeCustomTouchCalibration()

Chrome 57+ browser.* sinds Chrome 148 
browser.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Hiermee stel je de paren voor aanraakkalibratie in voor een scherm. Deze pairs worden gebruikt om het touchscreen te kalibreren voor weergave met id aangeroepen in startCustomTouchCalibration(). Roep altijd startCustomTouchCalibration aan voordat je deze methode aanroept. Als er al een andere aanraakkalibratie wordt uitgevoerd, wordt er een foutmelding gegeven.

Parameters

  • De paren punten die worden gebruikt om het scherm te kalibreren.

  • grenzen

    Grenzen

    Grenzen van het scherm toen de aanraakkalibratie werd uitgevoerd. De waarden bounds.left en bounds.top worden genegeerd.

enableUnifiedDesktop()

Chrome 46+ browser.* sinds Chrome 148 
browser.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Hiermee zet je de functie voor een uniform bureaublad aan of uit. Als je deze optie aanzet terwijl de functie voor spiegelen actief is, verandert de desktopmodus pas als de functie voor spiegelen wordt uitgezet. Anders wordt de desktopmodus onmiddellijk gewijzigd in geïntegreerd.

Parameters

  • aangezet

    booleaans

    True als een gecombineerd bureaublad moet worden aangezet.

getDisplayLayout()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Vraagt de indelingsinformatie voor alle schermen op.

Retourzendingen

  • Promise<DisplayLayout[]>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt opgelost met de resultaten.

getInfo()

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

Vraagt de informatie op voor alle aangesloten weergaveapparaten.

Parameters

  • vlaggen

    GetInfoFlags optioneel

    Chrome 59+ browser.* sinds Chrome 148

    Opties die van invloed zijn op hoe de informatie wordt geretourneerd.

Retourzendingen

  • Promise<DisplayUnitInfo[]>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt opgelost met de resultaten.

overscanCalibrationAdjust()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Past de huidige overscan-insets voor een scherm aan. Meestal moet dit het scherm langs een as verplaatsen (bijvoorbeeld links en rechts hebben dezelfde waarde) of het scherm langs een as schalen (bijvoorbeeld boven en onder hebben tegenovergestelde waarden). Elke aanroep van Adjust is cumulatief met eerdere aanroepen sinds Start.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

  • delta

    Invoegingen

    De hoeveelheid waarmee je de overscan-insets wilt wijzigen.

overscanCalibrationComplete()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.overscanCalibrationComplete(
  id: string,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Rond de overscan-aanpassingen voor een scherm af door de huidige waarden op te slaan en de overlay te verbergen.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

overscanCalibrationReset()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.overscanCalibrationReset(
  id: string,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Hiermee worden de overscan-insets voor een scherm gereset naar de laatst opgeslagen waarde (dat wil zeggen voordat Start werd aangeroepen).

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

overscanCalibrationStart()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.overscanCalibrationStart(
  id: string,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Start de overscan-kalibratie voor een scherm. Er wordt dan een overlay op het scherm getoond die de huidige overscan-insets aangeeft. Als de overscan-kalibratie voor scherm id bezig is, wordt de kalibratie gereset.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

setDisplayLayout()

Chrome 53+ browser.* sinds Chrome 148 
browser.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Stel de indeling in voor alle schermen. Voor schermen die niet zijn opgenomen, wordt de standaardindeling gebruikt. Als een indeling overlapt of op een andere manier ongeldig is, wordt deze aangepast naar een geldige indeling. Nadat de indeling is opgelost, wordt een onDisplayChanged-gebeurtenis geactiveerd.

Parameters

  • indelingen

    DisplayLayout[]

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

Retourzendingen

  • Promise<void>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt opgelost als de functie is voltooid.

setDisplayProperties()

browser.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): Promise<void>

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Updatet de eigenschappen voor het scherm dat wordt aangegeven door id, volgens de informatie in info. Bij een fout wordt runtime.lastError ingesteld.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

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

Retourzendingen

  • Promise<void>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt opgelost als de functie is voltooid.

setMirrorMode()

Chrome 65+ browser.* sinds Chrome 148 
browser.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Hiermee wordt de weergavemodus ingesteld op de aangegeven spiegelmodus. Elke aanroep reset de status van eerdere aanroepen. Het aanroepen van setDisplayProperties() mislukt voor de schermen van de bestemming voor spiegelen.

Parameters

  • De informatie van de spiegelmodus die moet worden toegepast op de weergavemodus.

Retourzendingen

  • Promise<void>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt opgelost als de functie is voltooid.

showNativeTouchCalibration()

Chrome 57+ browser.* sinds Chrome 148 
browser.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Toont de native UX voor aanraakkalibratie voor het scherm met id als scherm-ID. Er wordt een overlay op het scherm getoond met de vereiste instructies om door te gaan. De callback wordt alleen aangeroepen als de kalibratie is geslaagd. Als de kalibratie mislukt, wordt er een foutmelding gegeven.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

Retourzendingen

  • Promise<boolean>

    Chrome 91+ browser.* sinds Chrome 148

    Promise die wordt omgezet om de beller te informeren dat de aanraakkalibratie is beëindigd. De booleaanse waarde geeft aan of de kalibratie is geslaagd of niet.

startCustomTouchCalibration()

Chrome 57+ browser.* sinds Chrome 148 
browser.system.display.startCustomTouchCalibration(
  id: string,
): void

OPMERKING: Dit is alleen beschikbaar voor ChromeOS-kiosk-apps. Start een aangepaste aanraakkalibratie voor een scherm. Dit moet worden aangeroepen als je een aangepaste UX gebruikt om kalibratiegegevens te verzamelen. Als er al een andere aanraakkalibratie wordt uitgevoerd, wordt er een foutmelding gegeven.

Parameters

  • id

    tekenreeks

    De unieke ID van het scherm.

Evenementen

onDisplayChanged

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

Wordt geactiveerd als er iets verandert in de weergaveconfiguratie.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    () => void