Descrizione
Utilizza l'API system.display
per eseguire una query sui metadati di visualizzazione.
Autorizzazioni
system.display
Tipi
ActiveState
Un'enumerazione per indicare se il display viene rilevato e utilizzato dal sistema. Il display è considerato 'inattivo' se non viene rilevato dal sistema (potrebbe essere disconnesso o considerato disconnesso a causa della modalità di sospensione, ecc.). Ad esempio, questo stato viene utilizzato per mantenere il display esistente quando tutti i display sono disconnessi.
Enum
Bounds
Proprietà
-
altezza
numero
L'altezza del display in pixel.
-
a sinistra
numero
La coordinata x dell'angolo superiore sinistro.
-
superiore
numero
La coordinata y dell'angolo superiore sinistro.
-
larghezza
numero
La larghezza dello schermo in pixel.
DisplayLayout
Proprietà
-
id
stringa
L'identificatore univoco del display.
-
offset
numero
L'offset del display lungo il bordo connesso. 0 indica che gli angoli più in alto o più a sinistra sono allineati.
-
parentId
stringa
L'identificatore univoco del display principale. Vuoto se questa è la directory principale.
-
position
La posizione del layout di questa visualizzazione rispetto all'elemento principale. Verrà ignorato per l'account principale.
DisplayMode
Proprietà
-
deviceScaleFactor
numero
Il fattore di scala del dispositivo in modalità di visualizzazione.
-
altezza
numero
L'altezza della modalità di visualizzazione in pixel indipendenti dal dispositivo (visibili dall'utente).
-
heightInNativePixels
numero
L'altezza della modalità di visualizzazione in pixel nativi.
-
isInterlaced
booleano facoltativo
Chrome 74 e versioni successiveTrue se questa modalità è interlacciata, false se non viene specificato.
-
isNative
boolean
True se la modalità è quella nativa del display.
-
isSelected
boolean
True se è attualmente selezionata la modalità di visualizzazione.
-
refreshRate
numero
Chrome 67 e versioni successiveLa frequenza di aggiornamento della modalità di visualizzazione in Hertz.
-
uiScale
numero facoltativo
Deprecata da Chrome 70Formato
displayZoomFactor
Il fattore di scala dell'interfaccia utente della modalità di visualizzazione.
-
larghezza
numero
La larghezza della modalità di visualizzazione in pixel indipendenti dal dispositivo (visibili dall'utente).
-
widthInNativePixels
numero
La larghezza della modalità di visualizzazione in pixel nativi.
DisplayProperties
Proprietà
-
boundsOriginX
numero facoltativo
Se impostata, aggiorna l'origine dei limiti logici del display lungo l'asse x. Applicato insieme a
boundsOriginY
. Se non viene configurato eboundsOriginY
è impostato, il valore predefinito è quello corrente. Tieni presente che quando aggiorni l'origine di visualizzazione, verranno applicati alcuni vincoli, quindi l'origine dei limiti finali potrebbe essere diversa da quella impostata. I limiti finali possono essere recuperati utilizzandogetInfo
. L'origine dei limiti non può essere modificata sul display principale. -
boundsOriginY
numero facoltativo
Se impostata, aggiorna l'origine dei limiti logici del display lungo l'asse y. Consulta la documentazione per il parametro
boundsOriginX
. -
displayMode
DisplayMode facoltativo
Chrome 52 e versioni successiveSe impostato, aggiorna la modalità di visualizzazione alla modalità corrispondente a questo valore. Se gli altri parametri non sono validi, non verranno applicati. Se la modalità di visualizzazione non è valida, non verrà applicata e verrà impostato un errore, ma verranno comunque applicate altre proprietà.
-
displayZoomFactor
numero facoltativo
Chrome 65 e versioni successiveSe impostato, aggiorna lo zoom associato al display. Questo zoom esegue il re-layout e la modifica, offrendo una qualità migliore rispetto al semplice ingrandimento con un ingrandimento pixel per pixel.
-
isPrimary
booleano facoltativo
Se impostato su true, rende il display principale. No-op se impostato su false. Nota: se impostato, la visualizzazione è considerata principale per tutte le altre proprietà (ad esempio, è possibile impostare
isUnified
, mentre i limiti dell'origine no). -
isUnified
booleano facoltativo
Chrome 59 e versioni successiveSolo ChromeOS. Se è impostato su true, la modalità di visualizzazione passa alla modalità desktop unificato (vedi
enableUnifiedDesktop
per i dettagli). Se viene impostato su false, la modalità desktop unificato verrà disattivata. È valido solo per il display principale. Se fornito, mirroringSourceId non deve essere specificato e le altre proprietà verranno ignorate. Questa opzione non ha effetto se non viene fornita. -
mirroringSourceId
stringa facoltativo
Obsoleto da Chrome 68Utilizza
setMirrorMode
.Solo ChromeOS. Se impostato e non vuoto, abilita il mirroring solo per questo display. In caso contrario il mirroring viene disattivato per tutti i display. Questo valore deve indicare l'ID della visualizzazione di origine di cui eseguire il mirroring, che non deve corrispondere all'ID passato a setDisplayProperties. Se impostato, non è possibile impostare nessun'altra proprietà.
-
overscan
Inserti facoltativi
Se impostato, imposta gli insiemi di overscan del display sui valori forniti. Tieni presente che i valori di overscan non possono essere negativi o superiori alla metà delle dimensioni dello schermo. Impossibile modificare l'overscan sul monitor interno.
-
rotazione
numero facoltativo
Se impostata, aggiorna la rotazione del display. I valori legali sono [0, 90, 180, 270]. La rotazione è impostata in senso orario rispetto alla posizione verticale del display.
DisplayUnitInfo
Proprietà
-
activeStateChrome 117 e versioni successive
Attivo se il display viene rilevato e utilizzato dal sistema.
-
availableDisplayZoomFactors
numero[]
Chrome 67 e versioni successiveUn elenco di valori dei fattori di zoom che è possibile impostare per la visualizzazione.
-
limiti
I limiti logici del display.
-
displayZoomFactor
numero
Chrome 65 e versioni successiveIl rapporto tra lo zoom corrente e quello predefinito del display. Ad esempio, il valore 1 equivale a uno zoom al 100% e il valore 1, 5 allo zoom al 150%.
-
dpiX
numero
Il numero di pixel per pollice sull'asse x.
-
dpiY
numero
Il numero di pixel per pollice sull'asse y.
-
edid
Editor facoltativo
Chrome 67 e versioni successiveNOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
-
hasTouchSupport
boolean
Chrome 57 e versioni successiveTrue se al display è associato un dispositivo di input tocco.
-
id
stringa
L'identificatore univoco del display.
-
isEnabled
boolean
True se questo display è attivo.
-
isPrimary
boolean
True se è il display principale.
-
isUnified
boolean
Chrome 59 e versioni successiveTrue per tutti i display in modalità desktop unificato. Consulta la documentazione per
enableUnifiedDesktop
. -
mirroringDestinationIds
stringa[]
Chrome 64 e versioni successiveSolo ChromeOS. Identificatori dei display su cui viene eseguito il mirroring della visualizzazione di origine. Vuota se non viene eseguito il mirroring di nessun display. Verrà impostato sullo stesso valore per tutti i display. Non deve includere
mirroringSourceId
. -
mirroringSourceId
stringa
Solo ChromeOS. Identificatore del display di cui viene eseguito il mirroring se il mirroring è attivo, altrimenti vuoto. Verrà impostata per tutti i display (incluso il display di cui viene eseguito il mirroring).
-
modesChrome 52 e versioni successive
L'elenco delle modalità di visualizzazione disponibili. La modalità corrente avrà isSelected=true. Disponibile solo su ChromeOS. Verrà impostato su un array vuoto su altre piattaforme.
-
nome
stringa
Il nome facile da usare (ad es. "Monitor LCD HP").
-
overscan
I riquadri del display rientrano nei margini dello schermo. Attualmente esposto solo su ChromeOS. Verrà impostato su riquadri vuoti su altre piattaforme.
-
rotazione
numero
La rotazione in senso orario del display in gradi rispetto alla posizione verticale. Attualmente esposto solo su ChromeOS. Verrà impostato su 0 su altre piattaforme. Il valore -1 verrà interpretato come rotazione automatica quando il dispositivo è in uno stato tablet fisico.
-
workArea
L'area di lavoro utilizzabile del display entro i margini del display. L'area di lavoro esclude le aree del display riservate al sistema operativo, ad esempio barra delle applicazioni e Avvio app.
Edid
Proprietà
-
manufacturerId
stringa
Codice produttore di 3 caratteri. Si veda la Sezione 3.4.1 a pagina 21. Obbligatorio nella versione 1.4.
-
productId
stringa
Codice di 2 byte assegnato dal produttore, Sezione 3.4.2 a pagina 21. Obbligatorio nella versione 1.4.
-
yearOfManufacture
numero
Anno di produzione, Sec. 3.4.4 pagina 22. Obbligatorio nella versione 1.4.
GetInfoFlags
Proprietà
-
singleUnified
booleano facoltativo
Se è impostato su true,
getInfo
restituirà un soloDisplayUnitInfo
in modalità desktop unificato (vedienableUnifiedDesktop
). Il valore predefinito è false.
Insets
Proprietà
-
inferiore
numero
La distanza dell'asse y dal limite inferiore.
-
a sinistra
numero
La distanza dell'asse x dal limite sinistro.
-
a destra
numero
La distanza dell'asse x dal limite destro.
-
superiore
numero
La distanza dell'asse y dal limite superiore.
LayoutPosition
Posizione del layout, ad esempio bordo dell'elemento principale a cui è collegato il display.
Enum
MirrorMode
Modalità Mirroring, ovvero diversi modi di eseguire il mirroring di un display su altri display.
Enum
"off"
Specifica la modalità predefinita (desktop esteso o unificato).
"normal"
Specifica che il display dell'origine predefinito verrà mirroring su tutti gli altri display.
"mixed"
Specifica che la visualizzazione dell'origine specificata verrà sottoposta a mirroring sui display della destinazione forniti. Tutti gli altri display connessi verranno estesi.
MirrorModeInfo
Proprietà
-
mirroringDestinationIds
string[] facoltativo
Vengono visualizzati gli ID della destinazione di mirroring. È valido solo per "mixed".
-
mirroringSourceId
stringa facoltativo
L'ID della visualizzazione dell'origine del mirroring. È valido solo per "mixed".
-
modalità
La modalità di mirroring che deve essere impostata.
Point
Proprietà
-
x
numero
La coordinata x del punto.
-
y
numero
La coordinata y del punto.
TouchCalibrationPair
Proprietà
-
displayPoint
Le coordinate del punto di visualizzazione.
-
touchPoint
Le coordinate del punto di contatto corrispondente al punto di visualizzazione.
TouchCalibrationPairQuad
Proprietà
-
pair1
Prima coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.
-
pair2
Seconda coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.
-
pair3
Terza coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.
-
pair4
Quarta coppia di punto di contatto e punto di visualizzazione necessaria per la calibrazione del tocco.
Metodi
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Consente di reimpostare la calibrazione del tocco per il display e di ripristinarne lo stato predefinito cancellando tutti i dati di calibrazione del tocco associati al display.
Parametri
-
id
stringa
L'identificatore univoco del display.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Consente di impostare le coppie di calibrazione del tocco per un display. Questi pairs
vengono utilizzati per calibrare il touchscreen per il display con id
chiamato in startCustomTouchCalibration(). Chiama sempre startCustomTouchCalibration
prima di chiamare questo metodo. Se è già in corso un'altra calibrazione del tocco, verrà visualizzato un errore.
Parametri
-
coppie
Le coppie di punti utilizzate per calibrare il display.
-
limiti
Limiti del display al momento dell'esecuzione della calibrazione del tocco. I valori
bounds.left
ebounds.top
vengono ignorati.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
Attiva/disattiva la funzionalità desktop unificato. Se il criterio viene attivato quando è attivo il mirroring, la modalità desktop non cambierà fino alla disattivazione del mirroring. In caso contrario, la modalità desktop passerà immediatamente alla modalità unificata. NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
Parametri
-
abilitata
boolean
True se deve essere attivato il desktop unificato.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
Richiede le informazioni sul layout per tutti i display. NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(layouts: DisplayLayout[]) => void
-
layout
-
Ritorni
-
Promise<DisplayLayout[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Richiede le informazioni per tutti i dispositivi di visualizzazione collegati.
Parametri
-
flags
GetInfoFlags facoltativo
Chrome 59 e versioni successiveOpzioni che influiscono sulla modalità di restituzione delle informazioni.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Ritorni
-
Promise<DisplayUnitInfo[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Regola gli insiemi di overscan correnti per un display. In genere, questa operazione dovrebbe spostare la visualizzazione lungo un asse (ad es. sinistra+destra ha lo stesso valore) o scalarla lungo un asse (ad es. superiore e inferiore hanno valori opposti). Ogni chiamata di Adjust è cumulativa con le chiamate precedenti dall'inizio.
Parametri
-
id
stringa
L'identificatore univoco del display.
-
delta
La quantità di cui modificare i set di overscan.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Completa le regolazioni dell'overscan per una visualizzazione salvando i valori correnti e nascondendo l'overlay.
Parametri
-
id
stringa
L'identificatore univoco del display.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Consente di reimpostare i riquadri di overscan di una visualizzazione sull'ultimo valore salvato (ad esempio prima della chiamata di Start).
Parametri
-
id
stringa
L'identificatore univoco del display.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
Avvia la calibrazione dell'overscan per un display. Sullo schermo verrà visualizzato un overlay che indica gli attuali riquadri di overscan. Se è in corso la calibrazione dell'overscan per il display id
, la calibrazione verrà reimpostata.
Parametri
-
id
stringa
L'identificatore univoco del display.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
Imposta il layout per tutti i display. Tutti i display non inclusi utilizzeranno il layout predefinito. Se un layout si sovrappone o non è valido in altro modo, viene modificato con un layout valido. Una volta risolto il layout, verrà attivato un evento onDisplayChanged. NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
Parametri
-
layout
Le informazioni sul layout, obbligatorie per tutti i display, ad eccezione del display principale.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
Aggiorna le proprietà per la visualizzazione specificata da id
, in base alle informazioni fornite in info
. In caso di errore, verrà impostato runtime.lastError
. NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
Parametri
-
id
stringa
L'identificatore univoco del display.
-
informazioni
Le informazioni sulle proprietà di visualizzazione che devono essere modificate. Una proprietà verrà modificata solo se viene specificato un nuovo valore in
info
. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Imposta la modalità di visualizzazione sulla modalità di mirroring specificata. Ogni chiamata reimposta lo stato delle chiamate precedenti. La chiamata a setDisplayProperties() non riuscirà per le visualizzazioni delle destinazioni di mirroring. NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.
Parametri
-
informazioni
Le informazioni della modalità di mirroring da applicare alla modalità di visualizzazione.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Mostra l'UX nativa per la calibrazione del tocco per il display con id
come ID display. Verrà visualizzato un overlay sullo schermo con le istruzioni richieste su come procedere. Il callback viene richiamato solo in caso di calibrazione riuscita. Se la calibrazione non va a buon fine, verrà visualizzato un errore.
Parametri
-
id
stringa
L'identificatore univoco del display.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(success: boolean) => void
-
operazione riuscita
boolean
-
Ritorni
-
Promise<boolean>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Avvia la calibrazione del tocco personalizzata per un display. Questa funzionalità deve essere richiamata quando si utilizza un'UX personalizzata per la raccolta dei dati di calibrazione. Se è già in corso un'altra calibrazione del tocco, verrà visualizzato un errore.
Parametri
-
id
stringa
L'identificatore univoco del display.
Eventi
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Attivato quando vengono apportate modifiche alla configurazione del display.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:() => void