chrome.system.display

Opis

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

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

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

• przesunięcie,

  liczba

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

• parentId

  ciąg znaków

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

• position

  LayoutPosition

  Położenie tego wyświetlacza w układzie 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 nowszy

  Wartość „prawda”, jeśli ten tryb jest przeplotowy. Wartość „fałsz”, jeśli nie podano.

• isNative

  Wartość logiczna

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

• isSelected

  Wartość logiczna

  Wartość „Prawda”, jeśli tryb wyświetlania jest obecnie wybrany.

• refreshRate

  liczba

  Chrome 67 lub nowszy

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

• uiScale

  number opcjonalny

  Wycofane w Chrome 70

  Używaj klawisza 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. Stosowane razem z boundsOriginY. Jeśli nie zostanie ustawiona, domyślną wartością jest bieżąca wartość, a parametr boundsOriginY jest ustawiony. Pamiętaj, że podczas aktualizowania źródła wyświetlania będą obowiązywać pewne ograniczenia, więc ostateczne źródło granic może się różnić od ustawionego. Ostateczne granice można pobrać za pomocą metody 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 nadal będą stosowane.

• 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, dzięki czemu zapewnia lepszą jakość niż zwykłe powiększenie przez rozciągnięcie pikseli.

• 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 skonfigurowane, wyświetlanie jest uznawane za podstawowe dla wszystkich innych właściwości (np. można ustawić isUnified, ale nie można ustawić źródła granic).

• 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 ta 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 podasz tej wartości, nie będzie to miało ż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 wcięcia overscan 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ć nadskanowania na monitorze wewnętrznym.

• obrót,

  number opcjonalny

  Jeśli to ustawienie jest włączone, aktualizuje obrót wyświetlacza. Prawidłowe wartości to [0, 90, 180, 270]. Obrót jest ustawiony w prawo względem pozycji pionowej 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 nowszy

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

• ograniczenia,

  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 nowszy

  UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS i interfejsu internetowego.

• hasTouchSupport

  Wartość logiczna

  Chrome w wersji 57 lub nowszej

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

• id

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

• isEnabled

  Wartość logiczna

  Wartość „prawda”, 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 nowsza

  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

  ciąg znaków

  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

  ciąg znaków

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

• nadmiarowość obrazu,

  Wstawki

  Wcięcia wyświetlacza w granicach ekranu. Obecnie dostępne tylko w ChromeOS. Na innych platformach będzie ustawiona jako puste wstawki.

• obrót,

  liczba

  Obrót wyświetlacza w prawo w stopniach względem pozycji pionowej. Obecnie dostępne tylko w ChromeOS. Na innych platformach będzie ustawiona wartość 0. Wartość –1 będzie interpretowana jako automatyczne obracanie, gdy urządzenie jest w stanie fizycznym 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 nowszy

Właściwości

• manufacturerId

  ciąg znaków

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

• productId

  ciąg znaków

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

• yearOfManufacture

  liczba

  Rok produkcji, sekcja 3.4.4, strona 22. Wymagany 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ść od dolnej granicy na osi Y.

• w lewo

  liczba

  Odległość od lewej krawędzi na osi X.

• w prawo

  liczba

  Odległość od prawej krawędzi w osi X.

• góra

  liczba

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

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 tryb domyślny (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 będzie powielany 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[] opcjonalny

  Wyświetlają się identyfikatory miejsca docelowego dublowania. Jest to prawidłowe tylko w przypadku wartości „mieszane”.

• mirroringSourceId

  ciąg znaków opcjonalny

  Identyfikator źródłowego wyświetlacza powielania. Jest to prawidłowe tylko w przypadku wartości „mieszane”.

• tryb

  MirrorMode

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

Point

Chrome w wersji 57 lub nowszej

Właściwości

• x

  liczba

  Współrzędna x punktu.

• y

  liczba

  Współrzędna y punktu.

TouchCalibrationPair

Chrome w wersji 57 lub nowszej

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 w wersji 57 lub nowszej

Właściwości

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

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

• pair4

  TouchCalibrationPair

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

Metody

clearTouchCalibration()

Chrome w wersji 57 lub nowszej

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

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

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

completeCustomTouchCalibration()

Chrome w wersji 57 lub nowszej

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

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, spowoduje to błąd.

Parametry

• pary,

  TouchCalibrationPairQuad

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

• ograniczenia,

  Granice

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

enableUnifiedDesktop()

Chrome 46 lub nowszy

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

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. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS i interfejsu internetowego.

Parametry

• włączone

  Wartość logiczna

  Wartość Prawda, jeśli ujednolicony pulpit ma być włączony.

getDisplayLayout()

Chrome 53 lub nowsza

chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

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

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

Dostosowuje bieżące wcięcia overscanu na wyświetlaczu. 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 sumą poprzednich wywołań od momentu rozpoczęcia.

Parametry

• id

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

• Delta

  Wstawki

  Wartość zmiany wcięć overscanu.

overscanCalibrationComplete()

Chrome 53 lub nowsza

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

Dokończ dostosowywanie nadskanowania wyświetlacza, zapisując bieżące wartości i ukrywając nakładkę.

Parametry

• id

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

overscanCalibrationReset()

Chrome 53 lub nowsza

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

Przywraca wcięcia overscanu na wyświetlaczu do ostatniej zapisanej wartości (czyli sprzed wywołania funkcji Start).

Parametry

• id

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

overscanCalibrationStart()

Chrome 53 lub nowsza

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

Rozpoczyna kalibrację nadskanowania na wyświetlaczu. Na ekranie pojawi się nakładka wskazująca bieżące wcięcia nadskanowania. Jeśli trwa kalibracja nadskanowania dla wyświetlacza id, spowoduje to zresetowanie kalibracji.

Parametry

• id

  ciąg znaków

  Unikalny identyfikator wyświetlacza.

setDisplayLayout()

Chrome 53 lub nowsza

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

Ustaw układ dla wszystkich wyświetlaczy. W przypadku wszystkich wyświetleń, które nie zostały uwzględnione, zostanie użyty 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. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS i interfejsu internetowego.

Parametry

• układy,

  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 jest spełniana po zakończeniu działania funkcji.

setDisplayProperties()

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

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. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS i interfejsu internetowego.

Parametry

• id

  ciąg znaków

  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 nowa wartość.

Zwroty

• Promise<void>

  Chrome 91 lub nowsza

  Obietnica, która jest spełniana po zakończeniu działania funkcji.

setMirrorMode()

Chrome 65 lub nowsza

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde wywołanie resetuje stan z poprzednich wywołań. Wywołanie funkcji setDisplayProperties() nie powiedzie się w przypadku wyświetlaczy docelowych do dublowania. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS i interfejsu internetowego.

Parametry

• informacje

  MirrorModeInfo

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

Zwroty

• Promise<void>

  Chrome 91 lub nowsza

  Obietnica, która jest spełniana po zakończeniu działania funkcji.

showNativeTouchCalibration()

Chrome w wersji 57 lub nowszej

chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

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

  ciąg znaków

  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 w wersji 57 lub nowszej

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

Uruchamia niestandardową kalibrację dotyku na wyświetlaczu. Tę metodę należy wywoływać, gdy do zbierania danych kalibracyjnych używasz niestandardowego interfejsu. Jeśli trwa już inna kalibracja dotyku, spowoduje to błąd.

Parametry

• id

  ciąg znaków

  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