chrome.system.display

Opis

Aby wysłać zapytanie o metadane wyświetlania, użyj interfejsu API system.display.

Uprawnienia

system.display

Typy

ActiveState

Chrome 117+

Typ enumeracji określający, czy wyświetlacz jest wykrywany i używany przez system. Wyświetlacz jest uważany za „nieaktywny”, jeśli nie jest wykrywany przez system (może być odłączony lub uznany za odłączony z powodu trybu uśpienia itp.). Ten stan służy do zachowania dotychczasowego wyświetlacza, gdy wszystkie wyświetlacze są odłączone.

Typ wyliczeniowy

„active”

„inactive”

Bounds

Właściwości

  • wysokość

    liczba

    Wysokość wyświetlacza w pikselach.

  • w lewo

    liczba

    Pozioma współrzędna lewego górnego rogu.

  • góra

    liczba

    Pionowa współrzędna lewego górnego rogu.

  • szerokość

    liczba

    Szerokość wyświetlacza w pikselach.

DisplayLayout

Chrome 53 lub nowszy

Właściwości

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • przesunięcie

    liczba

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

  • parentId

    ciąg znaków

    Unikalny identyfikator wyświetlacza nadrzędnego. Pusty, jeśli jest to element główny.

  • position

    LayoutPosition

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

DisplayMode

Chrome 52+

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 przeplotowany, i wartość „fałsz”, jeśli nie jest podany.

  • isNative

    wartość logiczna

    Wartość Prawda, jeśli tryb jest natywną wartością wyświetlacza.

  • isSelected

    wartość logiczna

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

  • refreshRate

    liczba

    Chrome w wersji 67 lub nowszej

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

  • uiScale

    number opcjonalny

    Wycofane w wersji Chrome 70

    Użyj konta 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 logiczny punkt początkowy zakresu wyświetlania wzdłuż osi X. Zastosowano razem z boundsOriginY. Jeśli nie zostanie ustawiony, a boundsOriginY jest ustawiony, domyślnie przyjmuje bieżącą wartość. Pamiętaj, że podczas aktualizowania wyświetlanej wersji pochodzenia zostaną zastosowane pewne ograniczenia, więc ostateczna wersja pochodzenia może być inna niż ustawiona. Ostateczne granice można pobrać za pomocą getInfo. Początku zakresu nie można zmienić na wyświetlaczu głównym.

  • boundsOriginY

    number opcjonalny

    Jeśli jest ustawiony, aktualizuje logiczny punkt początkowy zakresu wyświetlania wzdłuż osi y. Zapoznaj się z dokumentacją dotyczącą parametru boundsOriginX.

  • displayMode

    DisplayMode opcjonalnie

    Chrome 52+

    Jeśli jest ustawiona, zmienia tryb wyświetlania na odpowiadający tej wartości. Jeśli inne parametry są nieprawidłowe, nie zostaną zastosowane. Jeśli tryb wyświetlania jest nieprawidłowy, nie zostanie on zastosowany i wystąpi błąd, ale inne właściwości zostaną zastosowane.

  • displayZoomFactor

    number opcjonalny

    Chrome 65 i nowsze

    Jeśli jest ustawiony, aktualizuje powiększenie powiązane z wyświetlaczem. Ten zoom wykonuje ponowny układ i odświeżanie, co przekłada się na wyższą jakość powiększenia niż po prostu rozciąganie pikseli.

  • isPrimary

    wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, wyświetlacz jest ustawiony jako główny. Jeśli ma wartość Fałsz, nie ma żadnego działania. Uwaga: jeśli jest ustawiona, wyświetlanie jest uważane za podstawowe dla wszystkich innych właściwości (tzn. isUnified może być ustawiona, a początek ograniczeń może nie być ustawiony).

  • isUnified

    wartość logiczna opcjonalna

    Chrome 59 lub nowszy

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

  • mirroringSourceId

    string opcjonalny

    Wycofane w wersji Chrome 68

    Użyj setMirrorMode.

    Tylko w ChromeOS. Jeśli jest ustawione i nie jest puste, umożliwia dublowanie tylko na tym wyświetlaczu. W przeciwnym razie dublowanie obrazu zostanie wyłączone na wszystkich wyświetlaczach. Ta wartość powinna wskazywać identyfikator źródłowego wyświetlacza, który ma być powielany. Identyfikator ten nie może być taki sam jak identyfikator przekazany do funkcji setDisplayProperties. Jeśli jest ustawiona, nie można ustawić żadnej innej właściwości.

  • overscan

    Wstawka opcjonalna

    Jeśli jest ustawiona, ustawia w ramkach wyświetlacza w ramkach podanych wartości. Pamiętaj, że wartości overscan nie mogą być ujemne ani większe niż połowa rozmiaru ekranu. Na monitorze wewnętrznym nie można zmienić wartości overscan.

  • rotacja

    number opcjonalny

    Jeśli jest ustawiona, aktualizuje orientację wyświetlacza. Dozwolone wartości to [0, 90, 180, 270]. Obrót jest ustawiany zgodnie z kierunkiem wskazówek zegara względem pionowej pozycji wyświetlacza.

DisplayUnitInfo

Właściwości

  • activeState

    ActiveState

    Chrome 117+

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

  • availableDisplayZoomFactors

    number[]

    Chrome w wersji 67 lub nowszej

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

  • bounds

    Granice

    Logiczne granice wyświetlacza.

  • displayZoomFactor

    liczba

    Chrome 65 i nowsze

    Stosunek bieżącego powiększenia ekranu do domyślnego powiększenia. Wartość 1 jest równoznaczna z powiększeniem 100%, a wartość 1, 5 z powiększeniem 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 w wersji 67 lub nowszej

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

  • hasTouchSupport

    wartość logiczna

    Chrome 57 lub nowszy

    Wartość Prawda, jeśli z ekranem jest powiązane urządzenie dotykowe.

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • isEnabled

    wartość logiczna

    Prawda, jeśli wyświetlacz jest włączony.

  • isPrimary

    wartość logiczna

    Prawda, jeśli jest to główny wyświetlacz.

  • isUnified

    wartość logiczna

    Chrome 59 lub nowszy

    Prawda dla wszystkich ekranów w ujednolonym trybie pulpitu. Zapoznaj się z dokumentacją enableUnifiedDesktop.

  • mirroringDestinationIds

    string[]

    Chrome 64+

    Tylko w ChromeOS. Identyfikatory wyświetlaczy, na które jest powielane źródło. Pusty, jeśli nie ma żadnych wyświetlaczy, które są dublowane. Ta sama wartość zostanie ustawiona dla wszystkich wyświetlaczy. Nie może zawierać mirroringSourceId.

  • mirroringSourceId

    ciąg znaków

    Tylko w ChromeOS. Identyfikator wyświetlacza, który jest dublowany, jeśli dublowanie jest włączone. W przeciwnym razie jest pusty. Ustawienie to będzie obowiązywać na wszystkich wyświetlaczach (w tym na wyświetlaczu, na którym wyświetlany jest obraz lustrzany).

  • trybów

    DisplayMode[]

    Chrome 52+

    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 pustym tablicą.

  • nazwa

    ciąg znaków

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

  • overscan

    Wstawki

    Wstawka wyświetlacza w ramach ekranu. Obecnie jest dostępny tylko w ChromeOS. Na innych platformach będą puste.

  • rotacja

    liczba

    Obrót wyświetlacza zgodnie z kierunkiem wskazówek zegara wyrażony w stopniach względem pozycji pionowej. Obecnie jest dostępny tylko w ChromeOS. Na innych platformach zostanie ustawiona wartość 0. Wartość -1 zostanie zinterpretowana jako autoobracanie, gdy urządzenie jest w stanie tabletu.

  • workArea

    Granice

    Użyteczny obszar roboczy wyświetlacza w ramach jego granic. Obszar roboczy nie obejmuje obszarów ekranu zarezerwowanych dla systemu operacyjnego, takich jak pasek zadań czy launcher.

Edid

Chrome w wersji 67 lub nowszej

Właściwości

  • manufacturerId

    ciąg znaków

    3-znakowy kod producenta. Patrz sekcja 3.4.1, strona 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 producenta, sekcja 3.4.4, strona 22. Wymagane w wersji 1.4.

GetInfoFlags

Chrome 59 lub nowszy

Właściwości

  • singleUnified

    wartość logiczna opcjonalna

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

Insets

Właściwości

  • dół

    liczba

    Odległość na osi y od dolnej granicy.

  • w lewo

    liczba

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

  • w prawo

    liczba

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

  • góra

    liczba

    Odległość na osi y od górnej granicy.

LayoutPosition

Chrome 53 lub nowszy

Pozycja układu, czyli krawędź elementu nadrzędnego, do którego jest dołączony wyświetlacz.

Typ wyliczeniowy

„top”

„right”

"bottom"

"left"

MirrorMode

Chrome 65 i nowsze

Tryb lustra, czyli różne sposoby powielania 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ła będzie odzwierciedlany na wszystkich innych wyświetlaczach.

"mixed"
Określa, że wskazany wyświetlacz źródłowy będzie powielany na wskazanych wyświetlaczach docelowych. Wszystkie inne podłączone wyświetlacze zostaną rozciągnięte.

MirrorModeInfo

Chrome 65 i nowsze

Właściwości

  • mirroringDestinationIds

    string[] opcjonalnie

    Pojawią się identyfikatory wyświetlanego miejsca docelowego. Dotyczy to tylko opcji „mixed” (mieszane).

  • mirroringSourceId

    string opcjonalny

    Identyfikator wyświetlanego obrazu źródłowego. Dotyczy to tylko opcji „mixed” (mieszane).

  • tryb

    MirrorMode

    Tryb odbicia lustrzanego, który należy ustawić.

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 dotykowego odpowiadające punktowi wyświetlania;

TouchCalibrationPairQuad

Chrome 57 lub nowszy

Właściwości

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

  • Druga para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.

  • Trzecia para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.

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

Metody

clearTouchCalibration()

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

Przywraca domyślne ustawienia kalibracji dotykowej ekranu, usuwając wszystkie dane kalibracji dotykowej powiązane z ekranem.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

completeCustomTouchCalibration()

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

Ustawia pary kalibracji dotykowej dla wyświetlacza. Te pairs służą do kalibrowania ekranu dotykowego w celu wyświetlania id wywoływanego w ramach startCustomTouchCalibration(). Przed wywołaniem tej metody zawsze wywołuj startCustomTouchCalibration. Jeśli inna kalibracja dotyku jest już w toku, pojawi się błąd.

Parametry

  • Pary punktów użyte do skalibrowania wyświetlacza.

  • bounds

    Granice

    Granice ekranu w momencie kalibracji dotykowej. Wartości bounds.left i bounds.top są ignorowane.

enableUnifiedDesktop()

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

Włącza lub wyłącza funkcję ujednoliconego pulpitu. Jeśli włączysz tę opcję, gdy klonowanie jest aktywne, tryb pulpitu nie zmieni się, dopóki nie wyłączysz klonowania. W przeciwnym razie tryb pulpitu przełączy się na ujednolicony natychmiast. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku i interfejsu internetowego w ChromeOS.

Parametry

  • włączone

    wartość logiczna

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

getDisplayLayout()

Obietnice Chrome 53 lub nowszy 
chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (layouts: DisplayLayout[]) => void

Zwroty

  • Promise<DisplayLayout[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getInfo()

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

Wymaga informacji o wszystkich podłączonych wyświetlaczach.

Parametry

  • flagi

    GetInfoFlags opcjonalnie

    Chrome 59 lub nowszy

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

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (displayInfo: DisplayUnitInfo[]) => void

Zwroty

  • Promise<DisplayUnitInfo[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

overscanCalibrationAdjust()

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

Dostosowuje bieżące wstawienia nakładki na wyświetlaczu. Zazwyczaj należy przesunąć wyświetlanie wzdłuż osi (np. lewo i prawo mają tę samą wartość) lub zmienić jego skalę wzdłuż osi (np. góra i dół mają przeciwne wartości). Każde wywołanie Adjust jest łączne z poprzednimi wywołaniami od momentu uruchomienia.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • Delta

    Wstawki

    Wartość, o którą mają być zmienione wstawienia w ramkach przesunięcia.

overscanCalibrationComplete()

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

Zapisz bieżące wartości i ukryj nakładkę, aby dokończyć dostosowywanie overscanu wyświetlacza.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

overscanCalibrationReset()

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

Przywraca w przypadku wyświetlacza w ramkach funkcji overscan wspięcia do ostatniej zapisanej wartości (czyli przed wywołaniem funkcji Start).

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

overscanCalibrationStart()

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

Rozpoczyna kalibrację przesunięcia obrazu na wyświetlaczu. Na ekranie pojawi się nakładka wskazująca bieżące wstawienia overscan. Jeśli w przypadku wyświetlacza id trwa kalibracja z przeskalowaniem, spowoduje to zresetowanie kalibracji.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

setDisplayLayout()

Obietnica Chrome 53 lub nowszy 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

Ustaw układ dla wszystkich wyświetlaczy. W przypadku nieuwzględnionych wyświetleń zostanie użyty układ domyślny. Jeśli układ będzie się nakładać lub będzie nieprawidłowy, zostanie dostosowany do prawidłowego układu. Po rozwiązaniu układu zostanie wywołane zdarzenie onDisplayChanged. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku i interfejsu internetowego w ChromeOS.

Parametry

  • layouts

    DisplayLayout[]

    informacje o układzie, wymagane we wszystkich widokach z wyjątkiem widoku głównego;

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

setDisplayProperties()

Obietnice 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

Aktualizuje właściwości wyświetlania określone przez id zgodnie z informacjami podanymi w info. W przypadku niepowodzenia zostanie ustawiona wartość runtime.lastError. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku i interfejsu internetowego w ChromeOS.

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 nowa wartość zostanie określona w parametrye info.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

setMirrorMode()

Obietnice Chrome 65 i nowsze wersje 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde wywołanie powoduje zresetowanie stanu z poprzednich wywołań. Wywołanie funkcji setDisplayProperties() spowoduje błąd w przypadku wyświetlaczy docelowych w lustrzanym trybie. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku i interfejsu internetowego w ChromeOS.

Parametry

  • informacje

    MirrorModeInfo

    Informacje o trybie lustra, które powinny zostać zastosowane do trybu wyświetlania.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

showNativeTouchCalibration()

Obietnice Chrome 57 lub nowszy 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Wyświetla natywny interfejs kalibracji dotykowej dla wyświetlacza z identyfikatorem id. Na ekranie pojawi się nakładka z instrukcjami. Funkcja wywołania zwrotnego zostanie wywołana tylko w przypadku pomyślnej kalibracji. Jeśli kalibracja się nie powiedzie, zostanie zwrócony błąd.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (success: boolean) => void

    • sukces

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

startCustomTouchCalibration()

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

Uruchamia niestandardową kalibrację dotykowego wyświetlacza. Należy go wywołać, gdy do zbierania danych kalibracji używany jest niestandardowy interfejs użytkownika. Jeśli inna kalibracja dotyku jest już w toku, pojawi się błąd.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

Wydarzenia

onDisplayChanged

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

Wywoływane, gdy cokolwiek zmieni się w konfiguracji wyświetlania.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void