chrome.system.display

Beschrijving

Gebruik de system.display API om metagegevens van het display op te vragen.

Machtigingen

system.display

Soorten

ActiveState

Chroom 117+

Een opsomming die aangeeft of het beeldscherm door het systeem wordt gedetecteerd en gebruikt. Het display wordt als 'inactief' beschouwd als het niet door het systeem wordt gedetecteerd (misschien losgekoppeld of als losgekoppeld vanwege de slaapmodus, 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

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

  • gecompenseerd

    nummer

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

  • ouderId

    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 item. Dit wordt genegeerd voor de root.

DisplayMode

Chroom 52+

Eigenschappen

  • apparaatScaleFactor

    nummer

    De schaalfactor van het apparaat in de weergavemodus.

  • hoogte

    nummer

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

  • hoogteInNativePixels

    nummer

    De hoogte van de weergavemodus in oorspronkelijke pixels.

  • is geïnterlinieerd

    Booleaans optioneel

    Chroom 74+

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

  • isInheems

    Booleaans

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

  • isGeselecteerd

    Booleaans

    Waar als de weergavemodus momenteel is geselecteerd.

  • vernieuwingsfrequentie

    nummer

    Chroom 67+

    De vernieuwingsfrequentie van de weergavemodus in Hertz.

  • uiSchaal

    nummer optioneel

    Verouderd sinds Chrome 70

    Gebruik displayZoomFactor

    De schaalfactor van de weergavemodus van de gebruikersinterface.

  • breedte

    nummer

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

  • breedteInNativePixels

    nummer

    De breedte van de weergavemodus in eigen pixels.

DisplayProperties

Eigenschappen

  • grenzenOorsprongX

    nummer optioneel

    Indien ingesteld, wordt de oorsprong van de logische grenzen van het scherm bijgewerkt langs de x-as. Samen met boundsOriginY toegepast. Standaard ingesteld op de huidige waarde als deze niet is ingesteld en boundsOriginY is ingesteld. Houd er rekening mee dat bij het bijwerken van de weergaveoorsprong enkele beperkingen worden toegepast, waardoor de uiteindelijke grenzenoorsprong anders kan zijn dan de oorspronkelijke grens. De definitieve grenzen kunnen worden opgehaald met behulp van getInfo . De oorsprong van de grens kan niet worden gewijzigd op het primaire beeldscherm.

  • grenzenOorsprongY

    nummer optioneel

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

  • weergavemodus

    Weergavemodus 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 fout ingesteld, maar worden andere eigenschappen nog steeds toegepast.

  • weergaveZoomFactor

    nummer optioneel

    Chroom 65+

    Indien ingesteld, wordt de zoom die aan het scherm is gekoppeld bijgewerkt. Met deze zoom wordt de lay-out en het opnieuw schilderen uitgevoerd, wat resulteert in een zoom van betere kwaliteit dan alleen het uitvoeren van een pixel-voor-pixel rekvergroting.

  • isPrimair

    Booleaans optioneel

    Indien ingesteld op true, wordt de weergave primair gemaakt. No-op indien ingesteld op false. Opmerking: Indien ingesteld, wordt de weergave als primair beschouwd voor alle andere eigenschappen (dat wil zeggen dat isUnified kan worden ingesteld en de oorsprong van grenzen mogelijk niet).

  • is verenigd

    Booleaans optioneel

    Chroom 59+

    Alleen Chrome OS. Indien ingesteld op true, wordt de weergavemodus gewijzigd in Unified Desktop (zie enableUnifiedDesktop voor details). Indien ingesteld op false, wordt de uniforme bureaubladmodus uitgeschakeld. Dit geldt alleen voor het primaire beeldscherm. Indien opgegeven, mag mirroringSourceId niet worden opgegeven en worden andere eigenschappen genegeerd. Dit heeft geen effect als dit niet wordt verstrekt.

  • mirroringSourceId

    tekenreeks optioneel

    Verouderd sinds Chrome 68

    Gebruik setMirrorMode .

    Alleen Chrome OS. Indien ingesteld en niet leeg, wordt spiegelen alleen voor dit scherm ingeschakeld. Anders wordt spiegelen voor alle beeldschermen uitgeschakeld. Deze waarde moet de id aangeven van het bronscherm dat moet worden gespiegeld, wat niet hetzelfde mag zijn als de id die is doorgegeven aan setDisplayProperties. Indien ingesteld, mag er geen andere eigenschap worden ingesteld.

  • overscannen

    Inzetstukken optioneel

    Indien ingesteld, worden de overscan-inzetstukken van het beeldscherm ingesteld op de opgegeven waarden. Houd er rekening mee dat de overscanwaarden niet negatief mogen zijn of 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. Wettelijke 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 staat

    Chroom 117+

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

  • beschikbaarDisplayZoomFactors

    nummer[]

    Chroom 67+

    Een lijst met zoomfactorwaarden die voor de weergave kunnen worden ingesteld.

  • grenzen

    Grenzen

    De logische grenzen van het beeldscherm.

  • weergaveZoomFactor

    nummer

    Chroom 65+

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

    Edid optioneel

    Chroom 67+

    OPMERKING: Dit is alleen beschikbaar voor Chrome OS Kiosk-apps en Web UI.

  • heeft Touch-ondersteuning

    Booleaans

    Chroom 57+

    Waar als er aan dit beeldscherm een ​​aanraakinvoerapparaat is gekoppeld.

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

  • is ingeschakeld

    Booleaans

    Waar als deze weergave is ingeschakeld.

  • isPrimair

    Booleaans

    Waar als dit het primaire beeldscherm is.

  • is verenigd

    Booleaans

    Chroom 59+

    Geldt voor alle beeldschermen in de uniforme bureaubladmodus. Zie documentatie voor enableUnifiedDesktop .

  • mirroringDestinationIds

    snaar[]

    Chroom 64+

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

  • mirroringSourceId

    snaar

    Alleen Chrome OS. Identificatie van het beeldscherm dat wordt gespiegeld als spiegelen is ingeschakeld, anders leeg. Dit wordt ingesteld voor alle beeldschermen (inclusief het beeldscherm dat wordt gespiegeld).

  • modi

    Weergavemodus []

    Chroom 52+

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

  • naam

    snaar

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

  • overscannen

    Inzetstukken

    De inzetstukken van het scherm vallen binnen de grenzen van het scherm. Momenteel alleen beschikbaar op ChromeOS. Zal worden ingesteld op lege inzetstukken op andere platforms.

  • 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 op 0 gezet. Een waarde van -1 wordt geïnterpreteerd als automatisch roteren wanneer het apparaat zich in een fysieke tabletstatus bevindt.

  • werkgebied

    Grenzen

    Het bruikbare werkgebied van het beeldscherm binnen de beeldschermgrenzen. Het werkgebied sluit delen van het scherm uit die zijn gereserveerd voor het besturingssysteem, bijvoorbeeld de taakbalk en het opstartprogramma.

Edid

Chroom 67+

Eigenschappen

  • fabrikantId

    snaar

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

  • productId

    snaar

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

  • Jaarvanfabricage

    nummer

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

GetInfoFlags

Chroom 59+

Eigenschappen

  • singleUnified

    Booleaans optioneel

    Indien ingesteld op true, wordt er slechts één DisplayUnitInfo geretourneerd door getInfo in de uniforme bureaubladmodus (zie enableUnifiedDesktop ). Standaard ingesteld op false.

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

Chroom 53+

Lay-outpositie, dwz de rand van het bovenliggende element waaraan het beeldscherm is bevestigd.

Enum

"bovenkant"

"rechts"

"onderkant"

"links"

MirrorMode

Chroom 65+

Spiegelmodus, dwz verschillende manieren waarop een beeldscherm wordt gespiegeld naar andere beeldschermen.

Enum

"uit"
Specificeert de standaardmodus (uitgebreid of verenigd bureaublad).

"normaal"
Specificeert dat het standaardbronbeeldscherm wordt gespiegeld naar alle andere beeldschermen.

"gemengd"
Specificeert dat het opgegeven brondisplay wordt gespiegeld naar de meegeleverde bestemmingsdisplays. Alle andere aangesloten displays worden uitgebreid.

MirrorModeInfo

Chroom 65+

Eigenschappen

  • mirroringDestinationIds

    tekenreeks[] optioneel

    De ID's van de spiegelbestemming worden weergegeven. Dit geldt alleen voor ‘gemengd’.

  • mirroringSourceId

    tekenreeks optioneel

    De id van de spiegelbronweergave. Dit geldt alleen voor ‘gemengd’.

  • De spiegelmodus die moet worden ingesteld.

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,
)

Reset de aanraakkalibratie voor het beeldscherm en brengt deze terug naar de standaardstatus door alle aanraakkalibratiegegevens die aan het beeldscherm zijn gekoppeld te wissen.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

completeCustomTouchCalibration()

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

Stelt de aanraakkalibratieparen in voor een beeldscherm. Deze pairs zouden worden gebruikt om het aanraakscherm te kalibreren voor weergave met id genaamd startCustomTouchCalibration(). Roep altijd startCustomTouchCalibration aan voordat u deze methode aanroept. Als er al een andere aanraakkalibratie bezig is, zal dit een fout opleveren.

Parameters

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

  • grenzen

    Grenzen

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

enableUnifiedDesktop()

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

Schakelt de Unified Desktop-functie in/uit. Indien ingeschakeld terwijl spiegelen actief is, verandert de bureaubladmodus pas wanneer spiegelen wordt uitgeschakeld. Anders schakelt de bureaubladmodus onmiddellijk over naar verenigd. OPMERKING: Dit is alleen beschikbaar voor Chrome OS Kiosk-apps en Web UI.

Parameters

  • ingeschakeld

    Booleaans

    Waar als Unified Desktop moet worden ingeschakeld.

getDisplayLayout()

BeloofChrome 53+
chrome.system.display.getDisplayLayout(
  callback?: function,
)

Vraagt ​​de lay-outinformatie op voor alle displays. OPMERKING: Dit is alleen beschikbaar voor Chrome OS Kiosk-apps en Web UI.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (layouts: DisplayLayout[]) => void

Retouren

  • Beloof < DisplayLayout []>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getInfo()

Belofte
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

Vraagt ​​de informatie op voor alle aangesloten weergaveapparaten.

Parameters

  • vlaggen

    GetInfoFlags optioneel

    Chroom 59+

    Opties die van invloed zijn op de manier waarop de informatie wordt geretourneerd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (displayInfo: DisplayUnitInfo[]) => void

Retouren

  • Beloof < DisplayUnitInfo []>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

overscanCalibrationAdjust()

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

Past de huidige overscan-inzet voor een beeldscherm aan. Meestal moet dit het scherm langs een as verplaatsen (bijvoorbeeld links+rechts hebben dezelfde waarde) of het langs een as schalen (bijvoorbeeld boven+onder hebben tegengestelde waarden). Elke Adjust-oproep is cumulatief met eerdere oproepen sinds Start.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

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

overscanCalibrationComplete()

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

Voltooi overscanaanpassingen voor een display door de huidige waarden op te slaan en de overlay te verbergen.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

overscanCalibrationReset()

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

Reset de overscan-inzetstukken voor een weergave naar de laatst opgeslagen waarde (dwz voordat Start werd aangeroepen).

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

overscanCalibrationStart()

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

Start overscankalibratie voor een beeldscherm. Hierdoor wordt een overlay op het scherm weergegeven die de huidige overscan-inzetstukken aangeeft. Als de overscankalibratie voor de display id bezig is, wordt de kalibratie gereset.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

setDisplayLayout()

BeloofChrome 53+
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

Stel de lay-out voor alle beeldschermen in. Elk beeldscherm dat niet is inbegrepen, gebruikt de standaardindeling. Als een lay-out zou overlappen of anderszins ongeldig zou zijn, 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 Chrome OS Kiosk-apps en Web UI.

Parameters

  • lay-outs

    DisplayIndeling []

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

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setDisplayProperties()

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

Werkt de eigenschappen bij voor de weergave gespecificeerd door id , volgens de informatie in info . Bij een fout wordt runtime.lastError ingesteld. OPMERKING: Dit is alleen beschikbaar voor Chrome OS Kiosk-apps en Web UI.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

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

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setMirrorMode()

BeloofChrome 65+
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

Stelt de weergavemodus in op de opgegeven spiegelmodus. Bij elke oproep wordt de status van eerdere oproepen gereset. Het aanroepen van setDisplayProperties() mislukt voor de spiegelbestemmingsdisplays. OPMERKING: Dit is alleen beschikbaar voor Chrome OS Kiosk-apps en Web UI.

Parameters

  • informatie

    MirrorModeInfo

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

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

showNativeTouchCalibration()

BeloofChrome 57+
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Toont de native aanraakkalibratie-UX voor het beeldscherm met id als beeldscherm-ID. Er wordt een overlay op het scherm weergegeven met de vereiste instructies over hoe verder te gaan. Alleen bij een succesvolle kalibratie wordt er teruggebeld. Als de kalibratie mislukt, zal dit een fout opleveren.

Parameters

  • Identiteitskaart

    snaar

    De unieke identificatie van het beeldscherm.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (success: boolean) => void

    • succes

      Booleaans

Retouren

  • Beloof<boolean>

    Chroom 91+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

startCustomTouchCalibration()

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

Start aangepaste aanraakkalibratie voor een beeldscherm. Dit moet worden aangeroepen bij gebruik van een aangepaste UX voor het verzamelen van kalibratiegegevens. Als er al een andere aanraakkalibratie bezig is, zal dit een fout opleveren.

Parameters

  • Identiteitskaart

    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 parameter ziet er als volgt uit: 

    () => void