chrome.system.display

Beschrijving

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

Machtigingen

system.display

Typen

ActiveState

Chroom 117+

Een enum die aangeeft of het beeldscherm door het systeem wordt gedetecteerd en gebruikt. Het beeldscherm wordt als 'inactief' beschouwd als het niet door het systeem wordt gedetecteerd (bijvoorbeeld als het is losgekoppeld, of als losgekoppeld vanwege de slaapstand, enz.). Deze status wordt gebruikt om het bestaande beeldscherm te behouden wanneer bijvoorbeeld alle beeldschermen 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

Chroom 53+

Eigenschappen

  • id

    snaar

    De unieke identificatie van het beeldscherm.

  • offset

    nummer

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

  • ouder-ID

    snaar

    De unieke identificatie van het bovenliggende beeldscherm. Leeg als dit de root is.

  • De lay-outpositie van dit scherm ten opzichte van het bovenliggende scherm. Dit wordt genegeerd voor de root.

DisplayMode

Chroom 52+

Eigenschappen

  • apparaatSchaalFactor

    nummer

    De schaalfactor van het weergavemodusapparaat.

  • hoogte

    nummer

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

  • hoogteInNativePixels

    nummer

    De hoogte van de weergavemodus in native pixels.

  • isInterlaced

    boolean optioneel

    Chroom 74+

    True als deze modus interlaced is, false als deze niet is opgegeven.

  • isNative

    Booleaanse

    Waar als de modus de oorspronkelijke modus van het scherm is.

  • is geselecteerd

    Booleaanse

    Waar als de weergavemodus momenteel is geselecteerd.

  • verversingssnelheid

    nummer

    Chroom 67+

    De vernieuwingsfrequentie van de weergavemodus in Hertz.

  • uiScale

    nummer optioneel

    Verouderd sinds Chrome 70

    Gebruik displayZoomFactor

    De schaalfactor van de UI van 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

  • grenzenOriginX

    nummer optioneel

    Indien ingesteld, wordt de oorsprong van de logische grenzen van het scherm langs de x-as bijgewerkt. Wordt toegepast in combinatie met boundsOriginY . Standaardwaarde is de huidige waarde indien niet ingesteld en boundsOriginY is ingesteld. Houd er rekening mee dat bij het bijwerken van de oorsprong van het scherm beperkingen worden toegepast, waardoor de oorsprong van de definitieve grenzen kan afwijken van de ingestelde. De definitieve grenzen kunnen worden opgehaald met getInfo . De oorsprong van de grenzen kan niet worden gewijzigd op het primaire scherm.

  • grenzenOriginY

    nummer optioneel

    Indien ingesteld, worden de logische grenzen van het display langs de y-as bijgewerkt. Zie de documentatie voor de parameter boundsOriginX .

  • weergavemodus

    DisplayMode optioneel

    Chroom 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 worden andere eigenschappen wel toegepast.

  • weergaveZoomFactor

    nummer optioneel

    Chroom 65+

    Indien ingesteld, wordt de zoom die aan het scherm is gekoppeld, bijgewerkt. Deze zoom voert een herindeling en hertekening uit, wat resulteert in een zoom van betere kwaliteit dan het uitvoeren van een pixel-voor-pixel vergroting.

  • isPrimair

    boolean optioneel

    Indien ingesteld op true, wordt de weergave primair. Indien ingesteld op false, wordt de weergave als primair beschouwd. Opmerking: Indien ingesteld, wordt de weergave als primair beschouwd voor alle andere eigenschappen (d.w.z. isUnified kan worden ingesteld en de oorsprong van de grenzen niet).

  • isUnified

    boolean optioneel

    Chroom 59+

    Alleen 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 geldt alleen voor het primaire beeldscherm. Indien opgegeven, mag mirroringSourceId niet worden opgegeven en worden andere eigenschappen genegeerd. Dit heeft geen effect indien niet opgegeven.

  • mirroringSourceId

    string optioneel

    Verouderd sinds Chrome 68

    Gebruik setMirrorMode .

    Alleen ChromeOS. Indien ingesteld en niet leeg, wordt mirroring alleen voor dit beeldscherm ingeschakeld. Anders wordt mirroring voor alle beeldschermen uitgeschakeld. Deze waarde moet de id van het te mirroren bronbeeldscherm aangeven. Deze mag niet gelijk zijn aan de id die aan setDisplayProperties is doorgegeven. Indien ingesteld, mag er geen andere eigenschap worden ingesteld.

  • overscan

    Inzetstukken optioneel

    Indien ingesteld, worden de overscan-insets van het scherm ingesteld op de opgegeven waarden. Let op: overscanwaarden mogen niet negatief of groter zijn 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. Geldige 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

  • actieve staat

    Actieve toestand

    Chroom 117+

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

  • beschikbareDisplayZoomFactors

    nummer[]

    Chroom 67+

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

  • grenzen

    Grenzen

    De logische grenzen van het scherm.

  • weergaveZoomFactor

    nummer

    Chroom 65+

    De verhouding tussen de huidige en de standaardzoom van het scherm. Waarde 1 staat bijvoorbeeld gelijk aan 100% zoom en waarde 1,5 staat gelijk aan 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

    Edit optioneel

    Chroom 67+

    OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

  • heeftTouchSupport

    Booleaanse

    Chroom 57+

    Waar als aan dit beeldscherm een aanraakinvoerapparaat is gekoppeld.

  • id

    snaar

    De unieke identificatie van het beeldscherm.

  • is ingeschakeld

    Booleaanse

    Waar als dit beeldscherm is ingeschakeld.

  • isPrimair

    Booleaanse

    Waar als dit het primaire beeldscherm is.

  • isUnified

    Booleaanse

    Chroom 59+

    Geldt voor alle beeldschermen in de unified desktop-modus. Zie de documentatie voor enableUnifiedDesktop .

  • mirroringDestinationIds

    snaar[]

    Chroom 64+

    Alleen ChromeOS. Identificatiegegevens van de beeldschermen waarnaar het bronbeeldscherm wordt gespiegeld. Leeg als er geen beeldschermen worden gespiegeld. Deze waarde wordt voor alle beeldschermen op dezelfde waarde ingesteld. Dit mag mirroringSourceId niet bevatten.

  • mirroringSourceId

    snaar

    Alleen ChromeOS. Identificatie van het scherm dat wordt gespiegeld indien mirroring is ingeschakeld, anders leeg. Dit wordt ingesteld voor alle schermen (inclusief het scherm dat wordt gespiegeld).

  • modi

    Weergavemodus []

    Chroom 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 (bijv. "HP LCD-monitor").

  • overscan

    Inzetstukken

    De inzetstukken van het scherm binnen de schermgrenzen. Momenteel alleen zichtbaar op ChromeOS. Wordt op andere platforms ingesteld op lege inzetstukken.

  • rotatie

    nummer

    De rotatie van het scherm met de klok mee in graden ten opzichte van de verticale positie. Momenteel alleen beschikbaar op ChromeOS. Wordt op andere platforms ingesteld op 0. Een waarde van -1 wordt geïnterpreteerd als automatische rotatie wanneer het apparaat zich in de fysieke tabletstand bevindt.

  • werkgebied

    Grenzen

    Het bruikbare werkgebied van het scherm binnen de schermgrenzen. Het werkgebied omvat niet de delen van het scherm die gereserveerd zijn voor het besturingssysteem, zoals de taakbalk en het startprogramma.

Edid

Chroom 67+

Eigenschappen

  • fabrikant-ID

    snaar

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

  • product-ID

    snaar

    2 byte door de fabrikant toegewezen code, Sec. 3.4.2 pagina 21. Vereist in v1.4.

  • productiejaar

    nummer

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

GetInfoFlags

Chroom 59+

Eigenschappen

  • enkelvoudigUnified

    boolean optioneel

    Als deze optie is ingesteld op true, wordt er slechts één DisplayUnitInfo geretourneerd door getInfo in de unified desktop-modus (zie enableUnifiedDesktop ). De standaardwaarde is false.

Insets

Eigenschappen

  • onderkant

    nummer

    De y-asafstand vanaf de ondergrens.

  • links

    nummer

    De x-asafstand vanaf de linkergrens.

  • rechts

    nummer

    De x-asafstand vanaf de rechtergrens.

  • bovenkant

    nummer

    De y-asafstand vanaf de bovengrens.

LayoutPosition

Chroom 53+

Positie van de opstelling, d.w.z. de rand van het bovenliggende apparaat waaraan het beeldscherm is bevestigd.

Enum

"bovenkant"

"rechts"

"onderkant"

"links"

MirrorMode

Chroom 65+

Spiegelmodus, dat wil zeggen verschillende manieren waarop een beeldscherm naar andere beeldschermen wordt gespiegeld.

Enum

"uit"
Geeft de standaardmodus aan (uitgebreid of uniform bureaublad).

"normaal"
Hiermee wordt aangegeven dat de standaardbronweergave wordt gespiegeld naar alle andere beeldschermen.

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

MirrorModeInfo

Chroom 65+

Eigenschappen

  • mirroringDestinationIds

    string[] optioneel

    De ID's van de mirroring-bestemming worden weergegeven. Dit is alleen geldig voor 'mixed'.

  • mirroringSourceId

    string optioneel

    De id van de gespiegelde bronweergave. Dit is alleen geldig voor 'mixed'.

  • De spiegelmodus die ingesteld moet worden.

Point

Chroom 57+

Eigenschappen

  • X

    nummer

    De x-coördinaat van het punt.

  • j

    nummer

    De y-coördinaat van het punt.

TouchCalibrationPair

Chroom 57+

Eigenschappen

  • weergavepunt

    Punt

    De coördinaten van het weergavepunt.

  • contactpunt

    Punt

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

TouchCalibrationPairQuad

Chroom 57+

Eigenschappen

Methoden

clearTouchCalibration()

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

Hiermee wordt de aanraakkalibratie voor het scherm opnieuw ingesteld en teruggezet naar de standaardstatus door alle aanraakkalibratiegegevens die aan het scherm zijn gekoppeld, te wissen.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

completeCustomTouchCalibration()

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

Stelt de touchkalibratieparen voor een beeldscherm in. Deze pairs worden gebruikt om het touchscreen te kalibreren voor een beeldscherm met id dat wordt aangeroepen in startCustomTouchCalibration(). Roep altijd startCustomTouchCalibration aan voordat u deze methode aanroept. Als er al een andere touchkalibratie bezig is, genereert dit een foutmelding.

Parameters

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

  • grenzen

    Grenzen

    Grenzen van het scherm tijdens het uitvoeren van de aanraakkalibratie. De waarden bounds.left en bounds.top worden genegeerd.

enableUnifiedDesktop()

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

Schakelt de functie voor een uniform bureaublad in of uit. Indien ingeschakeld terwijl mirroring actief is, verandert de bureaubladmodus pas wanneer mirroring wordt uitgeschakeld. Anders schakelt de bureaubladmodus direct over naar een uniform bureaublad. OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • ingeschakeld

    Booleaanse

    Waar als unified desktop ingeschakeld moet zijn.

getDisplayLayout()

Chroom 53+
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

Vraagt de lay-outinformatie op voor alle beeldschermen. OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Retourneren

getInfo()

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

Vraagt de informatie op voor alle aangesloten weergaveapparaten.

Parameters

  • vlaggen

    GetInfoFlags optioneel

    Chroom 59+

    Opties die bepalen hoe de informatie wordt geretourneerd.

Retourneren

overscanCalibrationAdjust()

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

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 schalen langs een as (bijvoorbeeld boven en onder hebben tegengestelde waarden). Elke Adjust-aanroep is cumulatief met eerdere aanroepen sinds Start.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

  • Het bedrag waarmee de overscan-insets moeten worden gewijzigd.

overscanCalibrationComplete()

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

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

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

overscanCalibrationReset()

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

Hiermee worden de overscan-insets voor een beeldscherm opnieuw ingesteld op de laatst opgeslagen waarde (dus voordat Start werd aangeroepen).

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

overscanCalibrationStart()

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

Start overscankalibratie voor een beeldscherm. Dit toont een overlay op het scherm die de huidige overscan-insets aangeeft. Als overscankalibratie voor het beeldscherm id actief is, wordt de kalibratie gereset.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

setDisplayLayout()

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

Stel de lay-out in voor alle beeldschermen. Elk beeldscherm 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 opgelost, wordt een onDisplayChanged-gebeurtenis geactiveerd. OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • lay-outs

    Weergave-indeling []

    De lay-outinformatie die vereist is voor alle beeldschermen, behalve het primaire beeldscherm.

Retourneren

  • Belofte<leegte>

    Chroom 91+

setDisplayProperties()

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

Werkt de eigenschappen voor het scherm bij zoals gespecificeerd door id , volgens de informatie in info . Bij een fout wordt runtime.lastError ingesteld. OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

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

Retourneren

  • Belofte<leegte>

    Chroom 91+

setMirrorMode()

Chroom 65+
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

Stelt de weergavemodus in op de opgegeven spiegelmodus. Elke aanroep reset de status van eerdere aanroepen. Het aanroepen van setDisplayProperties() mislukt voor de mirroring-doelschermen. OPMERKING: Dit is alleen beschikbaar voor ChromeOS Kiosk-apps en de webinterface.

Parameters

  • informatie

    MirrorModeInfo

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

Retourneren

  • Belofte<leegte>

    Chroom 91+

showNativeTouchCalibration()

Chroom 57+
chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

Geeft de native touch-kalibratie-UX voor het scherm weer met id als display-id. Dit toont een overlay op het scherm met de vereiste instructies over hoe verder te gaan. De callback wordt alleen aangeroepen bij een succesvolle kalibratie. Als de kalibratie mislukt, genereert dit een foutmelding.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

Retourneren

  • Belofte<boolean>

    Chroom 91+

startCustomTouchCalibration()

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

Start een aangepaste aanraakkalibratie voor een scherm. Deze functie moet worden aangeroepen wanneer een aangepaste UX wordt gebruikt voor het verzamelen van kalibratiegegevens. Als er al een andere aanraakkalibratie wordt uitgevoerd, genereert dit een foutmelding.

Parameters

  • id

    snaar

    De unieke identificatie van het beeldscherm.

Evenementen

onDisplayChanged

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

Wordt geactiveerd wanneer er iets verandert in de weergaveconfiguratie.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void