chrome.system.display

Descrizione

Utilizza l'API system.display per eseguire una query sui metadati di visualizzazione.

Autorizzazioni

system.display

Tipi

ActiveState

Chrome 117 e versioni successive

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

Chrome 53 e versioni successive

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

    LayoutPosition

    La posizione del layout di questa visualizzazione rispetto all'elemento principale. Verrà ignorato per l'account principale.

DisplayMode

Chrome 52 e versioni successive

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 successive

    True 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 successive

    La frequenza di aggiornamento della modalità di visualizzazione in Hertz.

  • uiScale

    numero facoltativo

    Deprecata da Chrome 70

    Formato 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 e boundsOriginY è 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 utilizzando getInfo. 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 successive

    Se 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 successive

    Se 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 successive

    Solo 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 68

    Utilizza 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à

  • activeState

    ActiveState

    Chrome 117 e versioni successive

    Attivo se il display viene rilevato e utilizzato dal sistema.

  • availableDisplayZoomFactors

    numero[]

    Chrome 67 e versioni successive

    Un elenco di valori dei fattori di zoom che è possibile impostare per la visualizzazione.

  • limiti

    Limiti

    I limiti logici del display.

  • displayZoomFactor

    numero

    Chrome 65 e versioni successive

    Il 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 successive

    NOTA: questa funzionalità è disponibile solo per le app kiosk e per la UI web di ChromeOS.

  • hasTouchSupport

    boolean

    Chrome 57 e versioni successive

    True 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 successive

    True per tutti i display in modalità desktop unificato. Consulta la documentazione per enableUnifiedDesktop.

  • mirroringDestinationIds

    stringa[]

    Chrome 64 e versioni successive

    Solo 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).

  • modes

    DisplayMode[]

    Chrome 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

    Inserti

    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

    Limiti

    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

Chrome 67 e versioni successive

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

Chrome 59 e versioni successive

Proprietà

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

Chrome 53 e versioni successive

Posizione del layout, ad esempio bordo dell'elemento principale a cui è collegato il display.

Enum

MirrorMode

Chrome 65 e versioni successive

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

Chrome 65 e versioni successive

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à

    MirrorMode

    La modalità di mirroring che deve essere impostata.

Point

Chrome 57 e versioni successive

Proprietà

  • x

    numero

    La coordinata x del punto.

  • y

    numero

    La coordinata y del punto.

TouchCalibrationPair

Chrome 57 e versioni successive

Proprietà

  • displayPoint

    Punto

    Le coordinate del punto di visualizzazione.

  • touchPoint

    Punto

    Le coordinate del punto di contatto corrispondente al punto di visualizzazione.

TouchCalibrationPairQuad

Chrome 57 e versioni successive

Proprietà

  • Prima coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.

  • Seconda coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.

  • Terza coppia di tocco e punto di visualizzazione necessaria per la calibrazione del tocco.

  • Quarta coppia di punto di contatto e punto di visualizzazione necessaria per la calibrazione del tocco.

Metodi

clearTouchCalibration()

Chrome 57 e versioni successive 
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 57 e versioni successive 
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

  • Le coppie di punti utilizzate per calibrare il display.

  • limiti

    Limiti

    Limiti del display al momento dell'esecuzione della calibrazione del tocco. I valori bounds.left e bounds.top vengono ignorati.

enableUnifiedDesktop()

Chrome 46 e versioni successive 
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()

Promessa Chrome 53 e versioni successive 
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

Ritorni

  • Promise<DisplayLayout[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getInfo()

Promessa 
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 successive

    Opzioni che influiscono sulla modalità di restituzione delle informazioni.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (displayInfo: DisplayUnitInfo[])=>void

Ritorni

  • Promise<DisplayUnitInfo[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

overscanCalibrationAdjust()

Chrome 53 e versioni successive 
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

    Inserti

    La quantità di cui modificare i set di overscan.

overscanCalibrationComplete()

Chrome 53 e versioni successive 
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 53 e versioni successive 
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 53 e versioni successive 
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()

Promessa Chrome 53 e versioni successive 
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

    DisplayLayout[]

    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 successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setDisplayProperties()

Promessa 
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

    DisplayProperties

    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 successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setMirrorMode()

Promessa Chrome 65 e versioni successive 
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

    MirrorModeInfo

    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 successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

showNativeTouchCalibration()

Promessa Chrome 57 e versioni successive 
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 successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

startCustomTouchCalibration()

Chrome 57 e versioni successive 
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