chrome.system.display

Descrizione

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

Autorizzazioni

system.display

Tipi

ActiveState

Chrome 117 e versioni successive

Un enum per indicare se il display viene rilevato e utilizzato dal sistema. Il display è considerato "inattivo" se non viene rilevato dal sistema (ad esempio se è scollegato o considerato scollegato a causa della modalità di sospensione e così via). Questo stato viene utilizzato per mantenere il display esistente quando tutti i display sono disconnessi, ad esempio.

Enum

"active"

"inactive"

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

    Lo spostamento del display lungo il bordo collegato. 0 indica che gli angoli in alto o a sinistra sono allineati.

  • parentId

    stringa

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

  • position

    LayoutPosition

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

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

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

  • 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 e versioni successive

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

  • uiScale

    number facoltativo

    Ritirato da Chrome 70

    Utilizza 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 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 della visualizzazione 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 finali potrebbe essere diversa da quella impostata. I limiti finali possono essere recuperati utilizzando getInfo. L'origine dei limiti non può essere modificata nel display principale.

  • boundsOriginY

    number facoltativo

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

  • displayMode

    DisplayMode facoltativo

    Chrome 52 e versioni successive

    Se impostato, aggiorna la modalità di visualizzazione in base alla modalità corrispondente a questo valore. Se gli 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 e versioni successive

    Se impostato, aggiorna lo zoom associato al display. Questo zoom esegue il ricalcolo del layout e la nuova colorazione, il che si traduce in uno zoom di qualità superiore rispetto a un semplice allargamento pixel per pixel.

  • isPrimary

    booleano facoltativo

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

  • isUnified

    booleano facoltativo

    Chrome 59 e versioni successive

    Solo ChromeOS. Se impostato su true, modifica la modalità di visualizzazione in desktop unificato (per maggiori dettagli, consulta enableUnifiedDesktop). Se viene impostato su false, la modalità desktop unificata verrà disattivata. Questo vale solo per il display principale. Se fornito, mirroringSourceId non deve essere fornito e le altre proprietà verranno ignorate. Se non viene fornito, questo valore non ha alcun effetto.

  • mirroringSourceId

    stringa facoltativa

    Ritirato 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 della visualizzazione di origine da eseguire in mirroring, che non deve essere uguale all'ID passato a setDisplayProperties. Se impostata, non è possibile impostare altre proprietà.

  • overscan

    Inserizioni facoltative

    Se impostato, imposta gli inserimenti 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 consentiti 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

    number[]

    Chrome 67 e versioni successive

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

  • 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 è equivalente allo zoom del 100% e il valore 1, 5 è equivalente allo 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 e versioni successive

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

  • hasTouchSupport

    booleano

    Chrome 57 e versioni successive

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

  • id

    stringa

    L'identificatore univoco del display.

  • isEnabled

    booleano

    True se questo display è attivo.

  • isPrimary

    booleano

    True se si tratta del display principale.

  • isUnified

    booleano

    Chrome 59 e versioni successive

    Vero 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 a cui viene eseguito il mirroring del display di origine. Vuoto se non è in corso 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 il mirroring è attivo, altrimenti vuoto. Questo valore verrà impostato per tutti i display (incluso quello sottoposto a 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 facile da ricordare (ad es. "Monitor LCD HP").

  • overscan

    Inserizioni

    Gli inserti del display all'interno dei limiti dello schermo. Al momento è visibile solo su ChromeOS. Verrà impostato su intestazioni vuote su altre piattaforme.

  • rotazione

    numero

    La rotazione in senso orario del display in gradi rispetto alla posizione verticale. Al momento è visibile solo su ChromeOS. Verrà impostato su 0 su altre piattaforme. Un valore pari a -1 verrà interpretato come rotazione automatica quando il dispositivo è in uno stato fisico da tablet.

  • workArea

    Limiti

    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 programma di avvio.

Edid

Chrome 67 e versioni successive

Proprietà

  • manufacturerId

    stringa

    Codice del 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, sezione 3.4.2, pagina 21. Obbligatorio nella versione 1.4.

  • yearOfManufacture

    numero

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

GetInfoFlags

Chrome 59 e versioni successive

Proprietà

Insets

Proprietà

  • in basso

    numero

    La distanza dell'asse Y dal limite inferiore.

  • a sinistra

    numero

    La distanza dall'asse x al limite sinistro.

  • a destra

    numero

    La distanza dall'asse x al 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 è collegato il display.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 e versioni successive

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

Enum

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

"normal"
Specifica che il display di origine predefinito verrà replicato su tutti gli altri display.

"mixed"
Specifica che la visualizzazione di origine specificata verrà replicata nelle visualizzazioni di destinazione fornite. Tutti gli altri display collegati verranno estesi.

MirrorModeInfo

Chrome 65 e versioni successive

Proprietà

  • mirroringDestinationIds

    stringa[] facoltativo

    Vengono visualizzati gli ID della destinazione del mirroring. Questo valore è valido solo per "mixed".

  • mirroringSourceId

    stringa facoltativa

    L'ID della visualizzazione dell'origine di mirroring. Questo valore è valido solo per "mixed".

  • modalità

    MirrorMode

    La modalità Specchio da impostare.

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 punti di tocco e display necessari per la calibrazione del tocco.

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

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

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

Metodi

clearTouchCalibration()

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

Ripristina la calibrazione tocco del display e ripristina lo stato predefinito cancellando tutti i dati di calibrazione 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,
)

Imposta le coppie di calibrazione 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 tocco, verrà generato un errore.

Parametri

  • Le coppie di punti utilizzate per calibrare il display.

  • limiti

    Limiti

    Confini 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à Desktop unificato. Se l'opzione è attivata mentre lo specchio è attivo, la modalità desktop non cambierà finché lo specchio non viene disattivato. In caso contrario, la modalità desktop passerà immediatamente a quella unificata. NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS e per l'interfaccia utente web.

Parametri

  • abilitata

    booleano

    True se è necessario attivare 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 opzione è disponibile solo per le app kiosk di ChromeOS e per l'interfaccia utente web.

Parametri

  • callback

    function 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()

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

Richiede le informazioni per tutti i dispositivi di visualizzazione collegati.

Parametri

  • bandiere

    GetInfoFlags facoltativo

    Chrome 59 e versioni successive

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

  • callback

    function 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,
)

Regola gli inserimenti di overscan correnti per un display. In genere, questo dovrebbe spostare la visualizzazione lungo un asse (ad es. sinistra+destra hanno lo stesso valore) o ridimensionarla lungo un asse (ad es. superiore+inferiore hanno valori opposti). Ogni chiamata Adjust è cumulativa con le chiamate precedenti dall'inizio.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • Delta

    Inserizioni

    L'importo per modificare gli inserti di overscan.

overscanCalibrationComplete()

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

Completa gli aggiustamenti dell'overscan per un display 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,
)

Ripristina gli inserimenti di overscan per un display all'ultimo valore salvato (ovvero 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 viene visualizzato un overlay che indica gli inserimenti 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()

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

Imposta il layout per tutti i display. Per qualsiasi display non incluso verrà utilizzato il layout predefinito. Se un layout si sovrappone o non è valido, verrà modificato in modo da diventare valido. Una volta risolto il layout, viene attivato un evento onDisplayChanged. NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS e per l'interfaccia utente web.

Parametri

  • layouts

    DisplayLayout[]

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

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<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()

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 opzione è disponibile solo per le app kiosk di ChromeOS e per 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

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<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()

Promessa Chrome 65 e versioni successive 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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 opzione è disponibile solo per le app kiosk di ChromeOS e per l'interfaccia utente web.

Parametri

  • informazioni

    MirrorModeInfo

    Le informazioni della modalità di mirroring da applicare alla modalità di visualizzazione.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<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()

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

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

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (success: boolean) => void

    • operazione riuscita

      booleano

Resi

  • Promise<boolean>

    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 tocco personalizzata per un display. Deve essere chiamato quando si utilizza un'esperienza utente personalizzata per la raccolta dei dati di calibrazione. Se è già in corso un'altra calibrazione 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 si verificano modifiche alla configurazione del display.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void