chrome.system.display

Beschrijving

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

Rechten

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

• ID kaart

  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.

• ouder ID

  snaar

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

• positie

  IndelingPositie

  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.

• is geselecteerd

  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.

• ID kaart

  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.

• Product-ID

  snaar

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

• jaar van fabricage

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

• modus

  Spiegelmodus

  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.

• aanraakpunt

  Punt

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

TouchCalibrationPairQuad

Chroom 57+

Eigenschappen

• paar1

  Raak KalibratiePaar aan

  Eerste paar aanraak- en weergavepunt vereist voor aanraakkalibratie.

• paar2

  Raak KalibratiePaar aan

  Tweede paar aanraak- en weergavepunt vereist voor aanraakkalibratie.

• paar3

  Raak KalibratiePaar aan

  Derde paar aanraak- en weergavepunt vereist voor aanraakkalibratie.

• paar4

  Raak KalibratiePaar aan

  Vierde paar aanraak- en weergavepunt vereist voor aanraakkalibratie.

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

• ID kaart

  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

• paren

  TouchCalibrationPairQuad

  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

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  (layouts: DisplayLayout[])=>void

  • lay-outs

    DisplayIndeling []

Geeft terug

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

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  (displayInfo: DisplayUnitInfo[])=>void

  • weergaveInfo

    DisplayUnitInfo []

Geeft terug

• 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

• ID kaart

  snaar

  De unieke identificatie van het beeldscherm.

• delta

  Inzetstukken

  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

• ID kaart

  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

• ID kaart

  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

• ID kaart

  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.

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  ()=>void

Geeft terug

• 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

• ID kaart

  snaar

  De unieke identificatie van het beeldscherm.

• informatie

  Beeldscherm eigenschappen

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

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  ()=>void

Geeft terug

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

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  ()=>void

Geeft terug

• 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. De callback wordt alleen geactiveerd als de kalibratie succesvol is. Als de kalibratie mislukt, zal dit een fout opleveren.

Parameters

• ID kaart

  snaar

  De unieke identificatie van het beeldscherm.

• Bel terug

  functie optioneel

  De callback parameter ziet er als volgt uit:

  (success: boolean)=>void

  • succes

    Booleaans

Geeft terug

• 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

• ID kaart

  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

• Bel terug

  functie

  De callback parameter ziet er als volgt uit:

  ()=>void