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 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 przeplatany. 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 nowsza

    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ą stosowane pewne ograniczenia, więc ostateczne źródło granic może różnić się 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 nadal będą stosowane.

  • displayZoomFactor

    number opcjonalny

    Chrome 65 lub nowszy

    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ść powiększenia niż zwykłe rozciąganie 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ść mirroringSourceId, nie można podać wartości sourceId, 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

    string 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ć nadmiernego skanowania 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 pionowego położenia 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 nowszy

    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 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. Puste, 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. W przypadku bieżącego trybu wartość isSelected będzie wynosić „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

    Wstawki 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 nowsza

Właściwości

  • manufacturerId

    ciąg znaków

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

  • productId

    ciąg znaków

    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ść od dolnej granicy na osi Y.

  • w lewo

    liczba

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

  • w prawo

    liczba

    Odległość na osi X od prawej granicy.

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

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. Obraz na pozostałych podłączonych wyświetlaczach zostanie rozszerzony.

MirrorModeInfo

Chrome 65 lub nowszy

Właściwości

  • mirroringDestinationIds

    string[] opcjonalne

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

  • mirroringSourceId

    string opcjonalny

    Identyfikator wyświetlacza źródłowego 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

  • 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 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 służą do kalibracji ekranu dotykowego na potrzeby wyświetlania za pomocą wywołania id w metodzie startCustomTouchCalibration(). Zawsze wywołuj 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

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

Promise Chrome 53+ 
chrome.system.display.getDisplayLayout(
  callback?: function,
): 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.

Parametry

Zwroty

  • Promise<DisplayLayout[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getInfo()

Obietnica 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): 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.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (displayInfo: DisplayUnitInfo[]) => void

Zwroty

  • Promise<DisplayUnitInfo[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

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 nadmiernego skanowania 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 nadmiernego skanowania dla wyświetlacza id, spowoduje to zresetowanie kalibracji.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

setDisplayLayout()

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

Ustaw układ dla wszystkich wyświetlaczy. W przypadku pozostałych wyświetlaczy będzie używany układ domyślny. Jeśli układ nakłada się na inny lub jest 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.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setDisplayProperties()

Obietnica 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): 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ść.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setMirrorMode()

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

Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde wywołanie resetuje stan z poprzednich wywołań. Wywołanie 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óry ma być zastosowany w trybie wyświetlania.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

showNativeTouchCalibration()

Promise Chrome 57 lub nowszy 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): 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. Funkcja zwrotna zostanie wywołana 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.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (success: boolean) => void

    • sukces

      Wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

startCustomTouchCalibration()

Chrome w wersji 57 lub nowszej 
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

Rozpoczyna 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

    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