chrome.system.display

Descrizione

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

Autorizzazioni

system.display

Tipi

ActiveState

Chrome 117+

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 scollegato o considerato scollegato a causa della modalità Sospensione e così via). Questo stato viene utilizzato per mantenere la visualizzazione esistente quando tutti i display sono scollegati, ad esempio.

Enum

"active"

"inactive"

Bounds

Proprietà

  • altezza

    numero

    L'altezza del display in pixel.

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

Proprietà

  • id

    stringa

    L'identificatore univoco del display.

  • offset

    numero

    L'offset del display lungo il bordo collegato. 0 indica che gli angoli superiore o sinistro sono allineati.

  • parentId

    stringa

    L'identificatore univoco del display principale. Vuoto se si tratta della radice.

  • position

    LayoutPosition

    La posizione del layout di questa visualizzazione rispetto all'elemento padre. Questo valore verrà ignorato per la radice.

DisplayMode

Chrome 52 o versioni successive

Proprietà

  • deviceScaleFactor

    numero

    Il fattore di scala del dispositivo della 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+

    Vero se questa modalità è interlacciata, falso se non fornita.

  • isNative

    booleano

    True se la modalità è la modalità nativa del display.

  • isSelected

    booleano

    True se la modalità di visualizzazione è attualmente selezionata.

  • refreshRate

    numero

    Chrome 67+

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

  • uiScale

    number (facoltativo)

    Ritirato a partire da Chrome 70

    Utilizza displayZoomFactor

    Il fattore di scalabilità dell'interfaccia utente della 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

    number (facoltativo)

    Se impostato, aggiorna l'origine dei limiti logici del display lungo l'asse x. Applicato insieme a boundsOriginY. Se non è impostato e boundsOriginY è impostato, il valore predefinito è il valore corrente. Tieni presente che quando aggiorni l'origine di visualizzazione, vengono applicati alcuni vincoli, pertanto l'origine dei limiti finale 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

    number (facoltativo)

    Se impostato, aggiorna l'origine dei limiti logici del display lungo l'asse Y. Consulta la documentazione relativa al parametro boundsOriginX.

  • displayMode

    DisplayMode facoltativo

    Chrome 52 o versioni successive

    Se impostato, aggiorna la modalità di visualizzazione alla modalità corrispondente a questo valore. Se altri parametri non sono validi, questo 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

    number (facoltativo)

    Chrome 65+

    Se impostato, aggiorna lo zoom associato al display. Questo zoom esegue il riposizionamento e il ridisegno, ottenendo così uno zoom di qualità migliore rispetto a un semplice ingrandimento pixel per pixel.

  • isPrimary

    booleano facoltativo

    Se viene impostato su true, il display diventa principale. Nessuna operazione se impostato su false. Nota: se impostata, la visualizzazione è considerata principale per tutte le altre proprietà (ad es. isUnified può essere impostata e l'origine dei limiti no).

  • isUnified

    booleano facoltativo

    Chrome 59+

    Solo ChromeOS. Se è impostato su true, la modalità di visualizzazione viene modificata in desktop unificato (per i dettagli, vedi enableUnifiedDesktop). Se viene impostato su false, la modalità desktop unificato verrà disattivata. Questa opzione è valida solo per il display principale. Se viene fornito, mirroringSourceId non deve essere fornito e le altre proprietà verranno ignorate. Se non viene fornito, non ha alcun effetto.

  • mirroringSourceId

    stringa facoltativa

    Ritirato a partire da Chrome 68

    Utilizza setMirrorMode.

    Solo ChromeOS. Se impostato e non 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 del display di origine da duplicare, che non deve corrispondere all'ID passato a setDisplayProperties. Se impostata, non è possibile impostare altre proprietà.

  • overscan

    Rientri facoltativo

    Se impostato, imposta i margini 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. L'overscan non può essere modificato sul monitor interno.

  • rotazione

    number (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+

    Attivo se il display viene rilevato e utilizzato dal sistema.

  • availableDisplayZoomFactors

    number[]

    Chrome 67+

    Un elenco di valori del fattore di zoom che possono essere impostati per il display.

  • limiti

    Bounds

    I limiti logici del display.

  • displayZoomFactor

    numero

    Chrome 65+

    Il rapporto tra lo zoom attuale e quello predefinito del display. Ad esempio, il valore 1 equivale a uno zoom del 100% e il valore 1, 5 equivale a uno zoom del 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+

    NOTA: questa funzionalità è disponibile solo per le app kiosk ChromeOS e l'interfaccia utente web.

  • hasTouchSupport

    booleano

    Chrome 57+

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

  • id

    stringa

    L'identificatore univoco del display.

  • isEnabled

    booleano

    True se questo display è abilitato.

  • isPrimary

    booleano

    True se questo è il display principale.

  • isUnified

    booleano

    Chrome 59+

    Vero per tutti i display in modalità Desktop unificato. Consulta la documentazione relativa a enableUnifiedDesktop.

  • mirroringDestinationIds

    string[]

    Chrome 64+

    Solo ChromeOS. Identificatori dei display su cui viene eseguito il mirroring del display di origine. Vuoto se non viene eseguito il mirroring di alcun display. Questo valore verrà impostato sullo stesso valore per tutti i display. Non deve includere mirroringSourceId.

  • mirroringSourceId

    stringa

    Solo ChromeOS. Identificatore del display sottoposto a mirroring se il mirroring è attivato, altrimenti vuoto. Questa impostazione verrà applicata a tutti i display (incluso quello sottoposto a mirroring).

  • modalità

    DisplayMode[]

    Chrome 52 o 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 descrittivo (ad es. "Monitor LCD HP").

  • overscan

    Inset

    I rientri del display all'interno dei limiti dello schermo. Al momento esposto solo su ChromeOS. Verranno impostati su rientri vuoti su altre piattaforme.

  • rotazione

    numero

    La rotazione in senso orario del display in gradi rispetto alla posizione verticale. Al momento esposto solo su ChromeOS. Verrà impostato su 0 su altre piattaforme. Un valore di -1 verrà interpretato come rotazione automatica quando il dispositivo è in modalità tablet fisica.

  • workArea

    Bounds

    L'area di lavoro utilizzabile del display all'interno dei limiti del display. L'area di lavoro esclude le aree del display riservate al sistema operativo, ad esempio la barra delle app e il launcher.

Edid

Chrome 67+

Proprietà

  • manufacturerId

    stringa

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

  • productId

    stringa

    Codice di 2 byte assegnato dal produttore, pag. 21, sezione 3.4.2. Obbligatorio nella versione 1.4.

  • yearOfManufacture

    numero

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

GetInfoFlags

Chrome 59+

Proprietà

  • singleUnified

    booleano facoltativo

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

Insets

Proprietà

  • in basso

    numero

    La distanza dell'asse Y dal limite inferiore.

  • sinistra

    numero

    La distanza dell'asse X dal limite sinistro.

  • destra

    numero

    La distanza dell'asse X dal limite destro.

  • in alto

    numero

    La distanza dell'asse Y dal limite superiore.

LayoutPosition

Chrome 53+

Posizione del layout, ovvero il bordo dell'elemento padre a cui è collegato il display.

Enum

"top"

"destra"

"bottom"

"sinistra"

MirrorMode

Chrome 65+

Modalità mirroring, ovvero diversi modi in cui un display viene duplicato su altri display.

Enum

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

"normal"
Specifica che la visualizzazione della sorgente predefinita verrà duplicata su tutti gli altri display.

"mixed"
Specifica che la visualizzazione dell'origine specificata verrà sottoposta a mirroring sui display di destinazione forniti. Tutti gli altri display collegati verranno estesi.

MirrorModeInfo

Chrome 65+

Proprietà

  • mirroringDestinationIds

    string[] facoltativo

    Gli ID dei display della destinazione di mirroring. È valido solo per "misto".

  • mirroringSourceId

    stringa facoltativa

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

  • modalità

    MirrorMode

    La modalità specchio da impostare.

Point

Chrome 57+

Proprietà

  • x

    numero

    La coordinata x del punto.

  • y

    numero

    La coordinata y del punto.

TouchCalibrationPair

Chrome 57+

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+

Proprietà

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

  • Per la calibrazione del tocco è necessario un secondo punto di tocco e visualizzazione.

  • Per la calibrazione del tocco è necessario un terzo punto di tocco e visualizzazione.

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

Metodi

clearTouchCalibration()

Chrome 57+ 
chrome.system.display.clearTouchCalibration(
  id: string,
): void

Reimposta la calibrazione del tocco per il display e lo riporta allo stato predefinito cancellando tutti i dati di calibrazione del tocco associati al display.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

completeCustomTouchCalibration()

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

Imposta le coppie di calibrazione del tocco per un display. Questi pairs verranno utilizzati per calibrare il touch screen 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à generato un errore.

Parametri

  • Le coppie di punti utilizzate per calibrare il display.

  • limiti

    Bounds

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

enableUnifiedDesktop()

Chrome 46 o versioni successive 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

Attiva/disattiva la funzionalità Desktop unificato. Se attivata mentre la duplicazione è attiva, la modalità desktop non cambierà finché la duplicazione non verrà disattivata. In caso contrario, la modalità desktop passerà immediatamente a quella unificata. NOTA: questa funzionalità è disponibile solo per le app kiosk ChromeOS e l'interfaccia utente web.

Parametri

  • attivato

    booleano

    True se deve essere attivato il desktop unificato.

getDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

Richiede le informazioni sul layout per tutti i display. NOTA: questa funzionalità è disponibile solo per le app kiosk ChromeOS e l'interfaccia utente web.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (layouts: DisplayLayout[]) => void

Resi

  • Promise<DisplayLayout[]>

    Chrome 91+

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

getInfo()

Promessa 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

Richiede le informazioni per tutti i dispositivi di visualizzazione collegati.

Parametri

  • bandiere

    GetInfoFlags facoltativo

    Chrome 59+

    Opzioni che influiscono sul modo in cui vengono restituite le informazioni.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (displayInfo: DisplayUnitInfo[]) => void

Resi

  • Promise<DisplayUnitInfo[]>

    Chrome 91+

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

overscanCalibrationAdjust()

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

Regola i margini di overscan correnti per un display. In genere, questo valore deve spostare la visualizzazione lungo un asse (ad es. sinistra e destra hanno lo stesso valore) o ridimensionarla lungo un asse (ad es. alto e basso hanno valori opposti). Ogni chiamata Adjust è cumulativa con le chiamate precedenti dall'inizio.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • Delta

    Inset

    L'importo per modificare i margini di overscan.

overscanCalibrationComplete()

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

Completa le regolazioni dell'overscan per un display salvando i valori correnti e nascondendo la sovrapposizione.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

overscanCalibrationReset()

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

Reimposta i margini di overscan per un display sull'ultimo valore salvato (ovvero prima della chiamata di Start).

Parametri

  • id

    stringa

    L'identificatore univoco del display.

overscanCalibrationStart()

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

Avvia la calibrazione dell'overscan per un display. Viene visualizzato un overlay sullo schermo che indica i rientri di overscan correnti. Se è in corso la calibrazione dell'overscan per il display id, la calibrazione verrà reimpostata.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

setDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

Imposta il layout per tutti i display. Qualsiasi display non incluso utilizzerà il layout predefinito. Se un layout si sovrappone o non è valido, verrà modificato in modo da essere valido. Una volta risolto il layout, viene attivato un evento onDisplayChanged. NOTA: questa funzionalità è disponibile solo per le app kiosk ChromeOS e l'interfaccia utente 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

  • Promise<void>

    Chrome 91+

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

setDisplayProperties()

Promessa 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

Aggiorna le proprietà del display specificato 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 ChromeOS e l'interfaccia utente web.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • informazioni

    DisplayProperties

    Le informazioni sulle proprietà di visualizzazione da modificare. Una proprietà verrà modificata solo se in info viene specificato un nuovo valore.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

setMirrorMode()

Promise Chrome 65 e versioni successive 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

Imposta la modalità di visualizzazione sulla modalità specchio specificata. Ogni chiamata reimposta lo stato delle chiamate precedenti. La chiamata a setDisplayProperties() non andrà a buon fine per i display di destinazione del mirroring. NOTA: questa funzionalità è disponibile solo per le app kiosk ChromeOS e l'interfaccia utente web.

Parametri

  • informazioni

    MirrorModeInfo

    Le informazioni sulla modalità specchio da applicare alla modalità di visualizzazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

showNativeTouchCalibration()

Promise Chrome 57+ 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

Visualizza l'esperienza utente di calibrazione del tocco nativa per il display con id come ID display. Verrà visualizzata una sovrapposizione sullo schermo con le istruzioni necessarie su come procedere. Il callback verrà richiamato solo in caso di calibrazione riuscita. Se la calibrazione non riesce, verrà generato 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

      booleano

Resi

  • Promise<boolean>

    Chrome 91+

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

startCustomTouchCalibration()

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

Avvia la calibrazione del tocco personalizzata per un display. Questo metodo deve 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à generato un errore.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

Eventi

onDisplayChanged

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

Viene attivato quando viene modificata la configurazione del display.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void