browser.system.display

Opis

Użyj interfejsu system.display API, aby wysyłać zapytania o wyświetlane metadane.

Uprawnienia

system.display

Typy

ActiveState

Chrome 117 lub nowsza

Wyliczenie określające, czy wyświetlacz jest wykrywany i używany przez system. Wyświetlacz jest uznawany za „nieaktywny”, jeśli nie jest wykrywany przez system (może być odłączony lub uznawany za odłączony z powodu trybu uśpienia itp.). Ten stan jest używany do zachowania istniejącego wyświetlacza, gdy wszystkie wyświetlacze są odłączone, na przykład.

Typ wyliczeniowy

„aktywny”

„inactive”

Bounds

Właściwości

  • wysokość

    liczba

    Wysokość wyświetlacza w pikselach.

  • w lewo

    liczba

    Współrzędna X lewego górnego rogu.

  • góra

    liczba

    Współrzędna y lewego górnego rogu.

  • szerokość

    liczba

    Szerokość wyświetlacza w pikselach.

DisplayLayout

Chrome 53 lub nowsza

Właściwości

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

  • odliczyć

    liczba

    Przesunięcie wyświetlacza wzdłuż połączonej krawędzi. Wartość 0 oznacza, że górne lub lewe rogi są wyrównane.

  • parentId

    tekst

    Unikalny identyfikator wyświetlacza nadrzędnego. Jeśli jest to katalog główny, pole jest puste.

  • position

    LayoutPosition

    Pozycja układu tego wyświetlacza względem elementu nadrzędnego. W przypadku elementu głównego zostanie to zignorowane.

DisplayMode

Chrome 52 lub nowsza

Właściwości

  • deviceScaleFactor

    liczba

    Współczynnik skalowania urządzenia w trybie wyświetlania.

  • wysokość

    liczba

    Wysokość trybu wyświetlania w pikselach niezależnych od urządzenia (widocznych dla użytkownika).

  • heightInNativePixels

    liczba

    Wysokość trybu wyświetlania w pikselach natywnych.

  • isInterlaced

    wartość logiczna opcjonalna

    Chrome 74 lub nowsza

    Wartość „prawda”, jeśli ten tryb jest przeplotowy; w przeciwnym razie wartość „fałsz”.

  • isNative

    wartość logiczna

    Wartość Prawda, jeśli tryb jest trybem natywnym wyświetlacza.

  • isSelected

    wartość logiczna

    Prawda, jeśli tryb wyświetlania jest obecnie wybrany.

  • refreshRate

    liczba

    Chrome 67 lub nowsza

    Częstotliwość odświeżania trybu wyświetlania w hercach.

  • uiScale

    number opcjonalny

    Wycofane w Chrome 70

    Otwórz displayZoomFactor

    Współczynnik skalowania interfejsu trybu wyświetlania.

  • szerokość

    liczba

    Szerokość trybu wyświetlania w pikselach niezależnych od urządzenia (widocznych dla użytkownika).

  • widthInNativePixels

    liczba

    Szerokość trybu wyświetlania w pikselach natywnych.

DisplayProperties

Właściwości

  • boundsOriginX

    number opcjonalny

    Jeśli jest ustawiony, aktualizuje początek logicznych granic wyświetlacza wzdłuż osi X. Zastosowano razem z boundsOriginY. Jeśli nie zostanie ustawiona, a parametr boundsOriginY jest ustawiony, domyślną wartością jest bieżąca wartość. Pamiętaj, że podczas aktualizowania źródła wyświetlania zostaną zastosowane pewne ograniczenia, więc ostateczne źródło granic może się różnić od ustawionego. Ostateczne granice można pobrać za pomocą funkcji getInfo. Nie można zmienić początku obszaru na wyświetlaczu głównym.

  • boundsOriginY

    number opcjonalny

    Jeśli jest ustawiona, aktualizuje początek logicznych granic wyświetlacza wzdłuż osi Y. Zapoznaj się z dokumentacją parametru boundsOriginX.

  • displayMode

    DisplayMode opcjonalny

    Chrome 52 lub nowsza

    Jeśli jest ustawiona, aktualizuje tryb wyświetlania do trybu pasującego do tej wartości. Jeśli inne parametry są nieprawidłowe, ta zasada nie zostanie zastosowana. Jeśli tryb wyświetlania jest nieprawidłowy, nie zostanie zastosowany i zostanie ustawiony błąd, ale inne właściwości zostaną zastosowane.

  • displayZoomFactor

    number opcjonalny

    Chrome 65 lub nowsza

    Jeśli jest ustawione, aktualizuje powiększenie powiązane z wyświetlaczem. Ten zoom zmienia układ i ponownie rysuje obraz, co zapewnia lepszą jakość niż zwykłe powiększenie piksel po pikselu.

  • isPrimary

    wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, wyświetlacz staje się głównym. Jeśli ma wartość Fałsz, nie ma żadnego efektu. Uwaga: jeśli to ustawienie jest włączone, wyświetlanie jest uznawane za podstawowe w przypadku wszystkich innych właściwości (np. można ustawić isUnified, ale nie można ustawić początku zakresu).

  • isUnified

    wartość logiczna opcjonalna

    Chrome 59 lub nowsza

    Tylko ChromeOS. Jeśli ma wartość Prawda, zmienia tryb wyświetlania na ujednolicony pulpit (szczegóły znajdziesz w sekcji enableUnifiedDesktop). Jeśli zasada ma wartość Fałsz, tryb ujednoliconego pulpitu zostanie wyłączony. Dotyczy to tylko wyświetlacza głównego. Jeśli podano wartość, nie można podać parametru mirroringSourceId, a inne właściwości zostaną zignorowane. Jeśli nie zostanie podana, nie będzie miała żadnego wpływu.

  • mirroringSourceId

    ciąg znaków opcjonalny

    Wycofane w Chrome 68

    Użyj setMirrorMode.

    Tylko ChromeOS. Jeśli to pole jest ustawione i nie jest puste, włącza dublowanie tylko na tym wyświetlaczu. W przeciwnym razie wyłącza tworzenie odbicia lustrzanego na wszystkich wyświetlaczach. Ta wartość powinna wskazywać identyfikator wyświetlacza źródłowego do odzwierciedlenia, który nie może być taki sam jak identyfikator przekazany do setDisplayProperties. Jeśli ta właściwość jest ustawiona, nie można ustawić żadnej innej.

  • nadmiarowość obrazu

    Wstawki opcjonalne

    Jeśli jest ustawiona, ustawia wstawki overscanu wyświetlacza na podane wartości. Pamiętaj, że wartości overscanu nie mogą być ujemne ani większe niż połowa rozmiaru ekranu. Nie można zmienić nadmiernego skanowania na monitorze wewnętrznym.

  • obrót,

    number opcjonalny

    Jeśli jest ustawiona, aktualizuje obrót wyświetlacza. Prawidłowe wartości to [0, 90, 180, 270]. Obrót jest ustawiony w kierunku zgodnym z ruchem wskazówek zegara względem pozycji w pionie wyświetlacza.

DisplayUnitInfo

Właściwości

  • activeState

    ActiveState

    Chrome 117 lub nowsza

    Aktywny, jeśli wyświetlacz jest wykrywany i używany przez system.

  • availableDisplayZoomFactors

    number[]

    Chrome 67 lub nowsza

    Lista wartości współczynnika powiększenia, które można ustawić na wyświetlaczu.

  • granice,

    Granice

    Logiczne granice wyświetlacza.

  • displayZoomFactor

    liczba

    Chrome 65 lub nowsza

    Stosunek między bieżącym a domyślnym powiększeniem wyświetlacza. Na przykład wartość 1 odpowiada powiększeniu o 100%, a wartość 1, 5 – powiększeniu o 150%.

  • dpiX

    liczba

    Liczba pikseli na cal wzdłuż osi X.

  • dpiY

    liczba

    Liczba pikseli na cal wzdłuż osi Y.

  • edid

    Edid opcjonalny

    Chrome 67 lub nowsza

    UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS.

  • hasTouchSupport

    wartość logiczna

    Chrome 57 lub nowszy

    Wartość Prawda, jeśli z tym wyświetlaczem jest powiązane urządzenie wejściowe dotykowe.

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

  • isEnabled

    wartość logiczna

    Wartość „true”, jeśli ten wyświetlacz jest włączony.

  • isPrimary

    wartość logiczna

    Wartość True, jeśli jest to wyświetlacz główny.

  • isUnified

    wartość logiczna

    Chrome 59 lub nowsza

    Dotyczy wszystkich wyświetlaczy w trybie ujednoliconego pulpitu. Zapoznaj się z dokumentacją enableUnifiedDesktop.

  • mirroringDestinationIds

    string[]

    Chrome 64 lub nowszy

    Tylko ChromeOS. Identyfikatory wyświetlaczy, na których jest powielany wyświetlacz źródłowy. Pusta, jeśli żaden wyświetlacz nie jest klonowany. W przypadku wszystkich wyświetlaczy będzie ona miała tę samą wartość. Nie może zawierać mirroringSourceId.

  • mirroringSourceId

    tekst

    Tylko ChromeOS. Identyfikator wyświetlacza, który jest klonowany, jeśli klonowanie jest włączone. W przeciwnym razie jest pusty. To ustawienie będzie obowiązywać w przypadku wszystkich wyświetlaczy (w tym wyświetlacza, który jest dublowany).

  • tryby

    DisplayMode[]

    Chrome 52 lub nowsza

    Lista dostępnych trybów wyświetlania. Bieżący tryb będzie miał wartość isSelected=true. Dostępne tylko w ChromeOS. Na innych platformach będzie ustawiona jako pusta tablica.

  • nazwa

    tekst

    Przyjazna dla użytkownika nazwa (np. „Monitor LCD HP”).

  • nadmiarowość obrazu

    Wstawki

    Wcięcia wyświetlacza w granicach ekranu. Obecnie jest dostępny tylko w ChromeOS. Na innych platformach będzie ustawiona pusta wartość.

  • obrót,

    liczba

    Obrót wyświetlacza w prawo w stopniach względem pozycji w pionie. Obecnie jest dostępny tylko w ChromeOS. Na innych platformach będzie ustawiona wartość 0. Wartość -1 będzie interpretowana jako autoobracanie, gdy urządzenie jest w fizycznym stanie tabletu.

  • workArea

    Granice

    Użyteczny obszar roboczy wyświetlacza w jego granicach. Obszar roboczy nie obejmuje obszarów wyświetlacza zarezerwowanych dla systemu operacyjnego, np. paska zadań i programu uruchamiającego.

Edid

Chrome 67 lub nowsza

Właściwości

  • manufacturerId

    tekst

    3-znakowy kod producenta. Patrz sekcja 3.4.1 na stronie 21. Wymagane w wersji 1.4.

  • productId

    tekst

    2-bajtowy kod przypisany przez producenta, sekcja 3.4.2, strona 21. Wymagane w wersji 1.4.

  • yearOfManufacture

    liczba

    Rok produkcji, sekcja 3.4.4, strona 22. Wymagane w wersji 1.4.

GetInfoFlags

Chrome 59 lub nowsza

Właściwości

  • singleUnified

    wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, funkcja getInfo zwraca tylko jeden element DisplayUnitInfo w trybie ujednoliconego pulpitu (patrz enableUnifiedDesktop). Domyślnie ma wartość Fałsz.

Insets

Właściwości

  • dół

    liczba

    Odległość osi Y od dolnej granicy.

  • w lewo

    liczba

    Odległość osi X od lewej granicy.

  • w prawo

    liczba

    Odległość osi X od prawej granicy.

  • góra

    liczba

    Odległość od górnej granicy w osi Y.

LayoutPosition

Chrome 53 lub nowsza

Położenie układu, czyli krawędź elementu nadrzędnego, do której przymocowany jest wyświetlacz.

Typ wyliczeniowy

„top”

„right”

„bottom”

„left”

MirrorMode

Chrome 65 lub nowsza

Tryb odbicia lustrzanego, czyli różne sposoby powielania obrazu z wyświetlacza na inne wyświetlacze.

Typ wyliczeniowy

„off”
Określa domyślny tryb (rozszerzony lub ujednolicony pulpit).

„normal”
Określa, że domyślny wyświetlacz źródłowy będzie odzwierciedlany na wszystkich innych wyświetlaczach.

„mixed”
Określa, że wyświetlacz źródłowy zostanie powielony na podanych wyświetlaczach docelowych. Wszystkie pozostałe podłączone wyświetlacze zostaną rozszerzone.

MirrorModeInfo

Chrome 65 lub nowsza

Właściwości

  • mirroringDestinationIds

    string[] opcjonalnie

    Wyświetlają się identyfikatory miejsca docelowego dublowania. Dotyczy to tylko wartości „mieszane”.

  • mirroringSourceId

    ciąg znaków opcjonalny

    Identyfikator źródłowego wyświetlacza powielania. Dotyczy to tylko wartości „mieszane”.

  • tryb

    MirrorMode

    Tryb odbicia lustrzanego, który ma zostać ustawiony.

Point

Chrome 57 lub nowszy

Właściwości

  • x

    liczba

    Współrzędna X punktu.

  • y

    liczba

    Współrzędna Y punktu.

TouchCalibrationPair

Chrome 57 lub nowszy

Właściwości

  • displayPoint

    Punkt

    Współrzędne punktu wyświetlania.

  • touchPoint

    Punkt

    Współrzędne punktu dotyku odpowiadające punktowi wyświetlania.

TouchCalibrationPairQuad

Chrome 57 lub nowszy

Właściwości

  • Pierwsza para punktów dotyku i wyświetlania wymagana do kalibracji dotyku.

  • Do kalibracji dotyku wymagana jest druga para punktów dotyku i wyświetlania.

  • Do kalibracji dotyku wymagana jest trzecia para punktów dotyku i wyświetlania.

  • Czwarta para punktów dotyku i wyświetlania wymagana do kalibracji dotyku.

Metody

clearTouchCalibration()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Resetuje kalibrację dotyku wyświetlacza i przywraca ją do stanu domyślnego, usuwając wszystkie dane kalibracji dotyku powiązane z wyświetlaczem.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

completeCustomTouchCalibration()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustawia pary kalibracji dotykowej dla wyświetlacza. Te pairs będą używane do kalibracji ekranu dotykowego na potrzeby wyświetlania z wywołaną funkcją id w metodzie startCustomTouchCalibration(). Zawsze wywołuj funkcję startCustomTouchCalibration przed wywołaniem tej metody. Jeśli trwa już inna kalibracja dotyku, ta funkcja zgłosi błąd.

Parametry

  • Pary punktów używane do kalibracji wyświetlacza.

  • granice,

    Granice

    Granice wyświetlacza w momencie przeprowadzania kalibracji dotyku. Wartości bounds.left i bounds.top są ignorowane.

enableUnifiedDesktop()

Chrome 46 lub nowsza 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Włącza i wyłącza funkcję ujednoliconego pulpitu. Jeśli ta opcja jest włączona podczas aktywnego dublowania, tryb pulpitu nie zmieni się, dopóki dublowanie nie zostanie wyłączone. W przeciwnym razie tryb pulpitu natychmiast przełączy się na ujednolicony.

Parametry

  • aktywne

    wartość logiczna

    Wartość logiczna określająca, czy ujednolicony pulpit ma być włączony.

getDisplayLayout()

Chrome 53 lub nowsza 
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Żąda informacji o układzie wszystkich wyświetlaczy.

Zwroty

  • Promise<DisplayLayout[]>

    Chrome 91 lub nowsza

    Obietnica, która zwraca wyniki.

getInfo()

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

Wysyła prośbę o informacje o wszystkich podłączonych urządzeniach wyświetlających.

Parametry

  • flagi

    GetInfoFlags opcjonalnie

    Chrome 59 lub nowsza

    Opcje wpływające na sposób zwracania informacji.

Zwroty

  • Promise<DisplayUnitInfo[]>

    Chrome 91 lub nowsza

    Obietnica, która zwraca wyniki.

overscanCalibrationAdjust()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Dostosowuje bieżące wstawki nadskanowania dla wyświetlacza. Zazwyczaj powinna ona przesuwać wyświetlacz wzdłuż osi (np. lewo+prawo mają tę samą wartość) lub skalować go wzdłuż osi (np. góra+dół mają przeciwne wartości). Każde wywołanie Adjust jest kumulatywne w stosunku do poprzednich wywołań od momentu rozpoczęcia.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

  • Delta

    Wstawki

    Kwota zmiany wstawki overscanu.

overscanCalibrationComplete()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Dokończ dostosowywanie nadmiernego skanowania wyświetlacza, zapisując bieżące wartości i ukrywając nakładkę.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

overscanCalibrationReset()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Przywraca wcięcia overscanu na wyświetlaczu do ostatniej zapisanej wartości (czyli sprzed wywołania funkcji Start).

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

overscanCalibrationStart()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Rozpoczyna kalibrację nadskanowania na wyświetlaczu. Na ekranie pojawi się nakładka wskazująca bieżące wcięcia nadskanowania. Jeśli trwa kalibracja nadskanowania wyświetlacza id, spowoduje to zresetowanie kalibracji.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

setDisplayLayout()

Chrome 53 lub nowsza 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustaw układ dla wszystkich wyświetlaczy. W przypadku wyświetlaczy, które nie zostały uwzględnione, używany będzie układ domyślny. Jeśli układ nakłada się na inny lub jest w inny sposób nieprawidłowy, zostanie dostosowany do prawidłowego układu. Po rozwiązaniu problemu z układem zostanie wywołane zdarzenie onDisplayChanged.

Parametry

  • układów,

    DisplayLayout[]

    Informacje o układzie, wymagane w przypadku wszystkich wyświetlaczy z wyjątkiem wyświetlacza głównego.

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnica, która zostanie spełniona po zakończeniu działania funkcji.

setDisplayProperties()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Aktualizuje właściwości wyświetlacza określonego przez id zgodnie z informacjami podanymi w info. W razie niepowodzenia zostanie ustawiona wartość runtime.lastError.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

  • informacje

    DisplayProperties

    Informacje o właściwościach wyświetlania, które należy zmienić. Właściwość zostanie zmieniona tylko wtedy, gdy w parametrze info zostanie podana jej nowa wartość.

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnica, która zostanie spełniona po zakończeniu działania funkcji.

setMirrorMode()

Chrome 65 lub nowsza 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde połączenie resetuje stan z poprzednich połączeń. Wywołanie setDisplayProperties() nie powiedzie się w przypadku wyświetlaczy docelowych dublowania.

Parametry

  • informacje

    MirrorModeInfo

    Informacje o trybie dublowania, które mają być zastosowane w trybie wyświetlania.

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnica, która zostanie spełniona po zakończeniu działania funkcji.

showNativeTouchCalibration()

Chrome 57 lub nowszy 
chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Wyświetla natywny interfejs kalibracji dotykowej dla wyświetlacza o identyfikatorze id. Na ekranie pojawi się nakładka z instrukcjami, jak postępować dalej. Wywołanie zwrotne zostanie wywołane tylko w przypadku pomyślnej kalibracji. Jeśli kalibracja się nie powiedzie, pojawi się błąd.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

Zwroty

  • Promise<boolean>

    Chrome 91 lub nowsza

    Obietnica, która informuje rozmówcę o zakończeniu kalibracji dotyku. Wartość logiczna informuje, czy kalibracja się powiodła.

startCustomTouchCalibration()

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

UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Uruchamia niestandardową kalibrację dotyku na wyświetlaczu. Tę funkcję należy wywoływać, gdy do zbierania danych kalibracyjnych używasz niestandardowego interfejsu. Jeśli trwa już inna kalibracja dotyku, ta funkcja zgłosi błąd.

Parametry

  • id

    tekst

    Unikalny identyfikator wyświetlacza.

Wydarzenia

onDisplayChanged

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

Wysyłane, gdy w konfiguracji wyświetlania nastąpią jakiekolwiek zmiany.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void