chrome.system.display

Descrizione

Usa l'API system.display per eseguire query sui metadati display.

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 "non attivo" se non viene rilevato dal sistema (forse disconnesso o considerato disconnesso a causa della modalità sonno e così via). Questo stato viene utilizzato, ad esempio, per mantenere il display esistente quando tutti i display sono disconnessi.

Enum

"attivo"

"non attivo"

Bounds

Proprietà

  • altezza

    numero

    L'altezza del display in pixel.

  • a sinistra

    numero

    La coordinata x dell'angolo in alto a sinistra.

  • in alto

    numero

    La coordinata y dell'angolo in alto a sinistra.

  • larghezza

    numero

    La larghezza del display 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 è la radice.

  • position

    LayoutPosition

    La posizione del layout di questa visualizzazione rispetto a quella principale. Questo valore verrà ignorato per la directory 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 all'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 fornita.

  • isNative

    booleano

    True se la modalità è quella nativa del display.

  • isSelected

    booleano

    True se al momento è 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

    Ritirato da Chrome 70

    Utilizza displayZoomFactor

    Il fattore di scala dell'interfaccia utente in modalità di visualizzazione.

  • larghezza

    numero

    La larghezza della modalità di visualizzazione in pixel indipendenti dal dispositivo (visibili all'utente).

  • widthInNativePixels

    numero

    La larghezza della modalità di visualizzazione in pixel nativi.

DisplayProperties

Proprietà

  • boundsOriginX

    numero facoltativo

    Se impostato, aggiorna l'origine dei limiti logici della visualizzazione lungo l'asse x. Applicato insieme a boundsOriginY. Se non viene configurato, il valore predefinito è il valore corrente e boundsOriginY è impostato. 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 nella visualizzazione principale.

  • boundsOriginY

    numero facoltativo

    Se impostato, aggiorna l'origine dei limiti logici della visualizzazione lungo l'asse y. Consulta la documentazione per il parametro boundsOriginX.

  • displayMode

    DisplayMode facoltativo

    Chrome 52 e versioni successive .

    Se impostata, aggiorna la modalità di visualizzazione alla modalità corrispondente a questo valore. Se gli altri parametri non sono validi, questo valore non verrà applicato. Se la modalità di visualizzazione non è valida, non verrà applicata e verrà impostato un errore, ma le altre proprietà verranno comunque applicate.

  • displayZoomFactor

    numero facoltativo

    Chrome 65 e versioni successive .

    Se impostato, aggiorna lo zoom associato al display. Questo zoom esegue il re-layout e la ricolorazione, con conseguente miglioramento della qualità dello zoom rispetto alla semplice ingrandimento dell'estensione pixel per pixel.

  • Principale

    booleano facoltativo

    Se è impostato su true, il display diventa principale. No-op se impostato su false. Nota: se impostato, la visualizzazione è considerata principale per tutte le altre proprietà (ad esempio, può essere impostata isUnified, mentre l'origine dei limiti potrebbe non essere impostata).

  • isUnified

    booleano facoltativo

    Chrome 59 e versioni successive .

    Solo ChromeOS. Se viene impostato su true, la modalità di visualizzazione viene impostata su desktop unificato (per informazioni dettagliate, visita la pagina enableUnifiedDesktop). Se viene impostato su false, la modalità desktop unificato verrà disattivata. È valido solo per il display principale. Se fornito, mirroringSourceId non deve essere fornito e le altre proprietà verranno ignorate. Se non viene specificato, questa impostazione non ha alcun effetto.

  • mirroringSourceId

    stringa facoltativo

    Ritirato da Chrome 68

    Utilizza setMirrorMode.

    Solo ChromeOS. Se il criterio viene impostato e non viene lasciato vuoto, attiva 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 da sottoporre a mirroring, che non deve essere uguale all'ID passato a setDisplayProperties. Se impostato, non è possibile impostare altre proprietà.

  • overscan

    Inserti facoltativi

    Se impostato, imposta gli inserti di overscan del display sui valori forniti. Tieni presente che i valori di overscan non possono essere negativi o maggiori della metà delle dimensioni dello schermo. L'overscan non può essere modificato sul monitor interno.

  • rotazione

    numero facoltativo

    Se impostato, 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 del fattore di zoom che possono essere impostati per la visualizzazione.

  • limiti

    Limiti

    I limiti logici della visualizzazione.

  • displayZoomFactor

    numero

    Chrome 65 e versioni successive .

    Il rapporto tra lo zoom corrente e predefinito del display. Ad esempio, il valore 1 equivale allo zoom del 100% e il valore 1, 5 allo zoom al 150%.

  • dpiX

    numero

    Il numero di pixel per pollice lungo l'asse x.

  • dpiY

    numero

    Il numero di pixel per pollice lungo l'asse y.

  • edid

    Edid facoltativo

    Chrome 67 e versioni successive .

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

  • hasTouchSupport

    booleano

    Chrome 57 e versioni successive .

    True se a questo display è associato un dispositivo di input tocco.

  • id

    stringa

    L'identificatore univoco del display.

  • isEnabled

    booleano

    True se questa visualizzazione è abilitata.

  • Principale

    booleano

    True se questo è il display principale.

  • isUnified

    booleano

    Chrome 59 e versioni successive .

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

  • mirroringDestinationIds

    stringa[]

    Chrome 64 e versioni successive .

    Solo ChromeOS. Identificatori dei display su cui viene eseguito il mirroring del display di origine. Vuoto se non viene eseguito il mirroring di nessun display. Verrà impostato lo stesso valore per tutte le visualizzazioni. Non deve includere mirroringSourceId.

  • mirroringSourceId

    stringa

    Solo ChromeOS. Identificatore del display di cui viene eseguito il mirroring se è attivo il mirroring, altrimenti vuoto. L'impostazione verrà applicata a tutti i display (incluso quello con mirroring).

  • modalità

    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 semplice da usare (ad esempio "Monitor LCD HP").

  • overscan

    Inserti

    I riquadri del display rientrano nei limiti 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 di tablet fisico.

  • workArea

    Limiti

    L'area di lavoro utilizzabile del display entro i limiti del display. L'area di lavoro esclude le aree del display riservate al sistema operativo, come la barra delle applicazioni e l'Avvio app.

Edid

Chrome 67 e versioni successive .

Proprietà

  • manufacturerId

    stringa

    Codice produttore di 3 caratteri. Vedi la sezione 3.4.1 pagina 21. Obbligatorio nella versione 1.4.

  • productId

    stringa

    Codice a 2 byte assegnato dal produttore, sez. 3.4.2 pagina 21. Obbligatorio nella versione 1.4.

  • yearOfManufacture

    numero

    Anno di produzione, sez. 3.4.4 pagina 22. Obbligatorio nella versione 1.4.

GetInfoFlags

Chrome 59 e versioni successive .

Proprietà

  • singleUnified

    booleano facoltativo

    Se il criterio viene impostato su true, getInfo restituirà un solo DisplayUnitInfo in modalità desktop unificato (vedi enableUnifiedDesktop). Il valore predefinito è false.

Insets

Proprietà

  • in basso

    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.

  • in alto

    numero

    La distanza dell'asse y dal limite superiore.

LayoutPosition

Chrome 53 e versioni successive .

Posizione del layout, ovvero il bordo dell'elemento principale a cui è agganciato il display.

Enum

"top"

"destra"

"bottom"

"left"

MirrorMode

Chrome 65 e versioni successive .

Modalità Specchio, ovvero modi diversi di mirroring del display su altri display.

Enum

"off"
Specifica la modalità predefinita (desktop esteso o unificato).

"normal"
Specifica che la visualizzazione predefinita dell'origine verrà visualizzata su tutti gli altri display.

"mixed"
Specifica che la visualizzazione dell'origine specificata verrà visualizzata sui display della destinazione forniti. Tutti gli altri display collegati verranno estesi.

MirrorModeInfo

Chrome 65 e versioni successive .

Proprietà

  • mirroringDestinationIds

    string[] facoltativo

    Vengono visualizzati gli ID della destinazione di mirroring. È valido solo per il tipo "misto".

  • mirroringSourceId

    stringa facoltativo

    L'ID del display dell'origine di mirroring. È valido solo per il tipo "misto".

  • modalità

    MirrorMode

    La modalità di mirroring da impostare.

Point

Chrome 57 e versioni successive .

Proprietà

  • x

    numero

    La coordinata x del punto.

  • y

    numero

    Coordinata y del punto.

TouchCalibrationPair

Chrome 57 e versioni successive .

Proprietà

  • displayPoint

    Punto

    Le coordinate del punto di visualizzazione.

  • touchPoint

    Punto

    Coordinate del punto di contatto corrispondente al punto di visualizzazione.

TouchCalibrationPairQuad

Chrome 57 e versioni successive .

Proprietà

  • La prima coppia di touch e punti di visualizzazione è necessaria per la calibrazione del tocco.

  • Seconda coppia di touch e punti di visualizzazione necessari per la calibrazione del tocco.

  • Terza coppia di punti tattili e display necessari per la calibrazione del tocco.

  • Quarto paio di punti tattili e display necessari 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 riportarla allo stato predefinito cancellando tutti i dati di calibrazione associati al display.

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

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 la visualizzazione 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 quando è stata eseguita la 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à di desktop unificato. Se il mirroring è attivo, la modalità desktop non cambierà fino a quando il mirroring non viene disattivato. In caso contrario, la modalità desktop passerà immediatamente a unificata. NOTA: questa funzionalità è disponibile solo per le app kiosk di ChromeOS e la UI web.

Parametri

  • abilitata

    booleano

    True se deve essere attivato il desktop unificato.

getDisplayLayout()

Promesso 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 di ChromeOS e la UI web.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (layouts: DisplayLayout[]) => void

Resi

  • Promise<DisplayLayout[]>

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getInfo()

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

Consente di richiedere le informazioni per tutti i display collegati.

Parametri

  • bandiere

    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

Resi

  • Promise<DisplayUnitInfo[]>

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

overscanCalibrationAdjust()

Chrome 53 e versioni successive .
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

Consente di regolare gli inserti di overscan correnti per un display. In genere questo dovrebbe spostare la visualizzazione lungo un asse (ad es. se il valore è uguale a sinistra + destra) o scalarlo lungo un asse (ad es. in alto + in basso hanno valori opposti). Ogni chiamata di Adjust è cumulativa con le chiamate precedenti dall'inizio.

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

  • Delta

    Inserti

    Il numero di modifiche degli inserti overscan.

overscanCalibrationComplete()

Chrome 53 e versioni successive .
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

Completa le regolazioni dell'overscan per la visualizzazione salvando i valori correnti e nascondendo l'overlay.

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

overscanCalibrationReset()

Chrome 53 e versioni successive .
chrome.system.display.overscanCalibrationReset(
  id: string,
)

Consente di reimpostare gli inserti di overscan per una visualizzazione sull'ultimo valore salvato (ovvero prima della chiamata di Start).

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

overscanCalibrationStart()

Chrome 53 e versioni successive .
chrome.system.display.overscanCalibrationStart(
  id: string,
)

Avvia la calibrazione dell'overscan per un display. In questo modo, sullo schermo verrà mostrato 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 della visualizzazione.

setDisplayLayout()

Promesso Chrome 53 e versioni successive 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

Imposta il layout per tutti i display. I display non inclusi utilizzeranno il layout predefinito. Se un layout si sovrappone o non è altrimenti valido, verrà adattato a un layout valido. Una volta risolto il layout, viene attivato un evento onDisplayChanged. NOTA: questa funzionalità è disponibile solo per le app kiosk di ChromeOS e la UI web.

Parametri

  • layout

    DisplayLayout[]

    Le informazioni sul layout, obbligatorie per tutti i display tranne quello principale.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setDisplayProperties()

Promesso .
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 di ChromeOS e la UI web.

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

  • informazioni

    DisplayProperties

    Le informazioni sulle proprietà di visualizzazione che devono essere modificate. Una proprietà viene modificata solo se viene specificato un nuovo valore in info.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setMirrorMode()

Promesso 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 i display della destinazione di mirroring. NOTA: questa funzionalità è disponibile solo per le app kiosk di ChromeOS e la UI web.

Parametri

  • informazioni

    MirrorModeInfo

    Le informazioni della modalità Specchio che devono essere applicate alla modalità di visualizzazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

showNativeTouchCalibration()

Promesso Chrome 57 e versioni successive 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Mostra l'esperienza utente della calibrazione del tocco nativa per il display con id come ID display. Sullo schermo verrà mostrato un overlay con le istruzioni necessarie su come procedere. Il callback verrà attivato solo in caso di calibrazione riuscita. Se la calibrazione non va a buon fine, viene generato un errore.

Parametri

  • id

    stringa

    L'identificatore univoco della visualizzazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (success: boolean) => void

    • operazione riuscita

      booleano

Resi

  • Promise&lt;boolean&gt;

    Chrome 91 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

startCustomTouchCalibration()

Chrome 57 e versioni successive .
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

Avvia la calibrazione del tocco personalizzato per un display. Dovrebbe essere chiamato quando si utilizza un'esperienza utente 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 della visualizzazione.

Eventi

onDisplayChanged

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

Attivato quando viene modificata la configurazione del display.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void