chrome.system.display

Opis

Do wysyłania zapytań dotyczących wyświetlanych metadanych użyj interfejsu API system.display.

Uprawnienia

system.display

Typy

ActiveState

Chrome w wersji 117 lub nowszej .

Wyliczenie określające, czy wyświetlacz został wykryty i używany przez system. Wyświetlacz jest uważany za „nieaktywny”, jeśli nie zostanie wykryty przez system (może być odłączony lub uznany za odłączony z powodu trybu uśpienia itp.). Służy on do zachowania dotychczasowego wyświetlacza, na przykład 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

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

Właściwości

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • odliczyć

    liczba

    Odsunięcie wyświetlacza wzdłuż połączonej krawędzi. 0 oznacza, że górny lub lewy górny róg są wyrównane.

  • parentId

    ciąg znaków

    Unikalny identyfikator wyświetlacza nadrzędnego. Brak wartości, jeśli to katalog główny.

  • position

    Pozycja układu tego wyświetlacza względem elementu nadrzędnego. Będzie ona ignorowana w przypadku katalogu głównego.

DisplayMode

Chrome w wersji 52 lub nowszej .

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

    Wartość true, jeśli ten tryb ma przeplot. Wartość false, jeśli nie zostanie podana.

  • isNative

    wartość logiczna

    Prawda, jeśli tryb jest trybem natywnym ekranu.

  • isSelected

    wartość logiczna

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

  • refreshRate

    liczba

    Chrome w wersji 67 lub nowszej .

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

  • uiScale

    liczba opcjonalnie

    Wycofane od Chrome 70

    Użyj konta displayZoomFactor

    Współczynnik skalowania w trybie wyświetlania w interfejsie.

  • 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

    liczba opcjonalnie

    Jeśli jest ustawiony, aktualizuje logiczne granice wyświetlania wzdłuż osi X. Stosowane razem z: boundsOriginY. Jeśli nie zostanie ustawiony, domyślna wartość to bieżąca wartość (boundsOriginY). Pamiętaj, że podczas aktualizowania punktu początkowego wyświetlania będą stosowane pewne ograniczenia, więc końcowe granice mogą się różnić od punktu początkowego. Ostateczne granice można pobrać za pomocą narzędzia getInfo. Punktu początkowego nie można zmienić na wyświetlaczu głównym.

  • boundsOriginY

    liczba opcjonalnie

    Jeśli jest ustawiony, aktualizuje logiczne granice wyświetlania wzdłuż osi Y. Zapoznaj się z dokumentacją parametru boundsOriginX.

  • displayMode

    Opcjonalny DisplayMode

    Chrome w wersji 52 lub nowszej .

    Jeśli jest ustawione, tryb wyświetlania zmienia tryb na pasujący do tej wartości. Jeśli inne parametry są nieprawidłowe, nie zostaną zastosowane. Jeśli tryb wyświetlania jest nieprawidłowy, nie jest stosowany i ustawia się błąd, ale inne właściwości nadal będą stosowane.

  • displayZoomFactor

    liczba opcjonalnie

    Chrome w wersji 65 lub nowszej .

    Jeśli jest ustawione, aktualizuje powiększenie powiązane z wyświetlaczem. Ta opcja powoduje jej przeformatowanie i odrysowanie. Zapewnia to lepszą jakość niż tylko powiększanie piksel po pikselu.

  • isPrimary

    Wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, ekran jest główny. No-op, jeśli ma wartość false (fałsz). Uwaga: jeśli skonfigurujesz ten sposób wyświetlania, będzie on uznawany za główny w przypadku wszystkich innych usług (tj. parametr isUnified może być ustawiony, a punkt początkowy – nie).

  • isUnified

    Wartość logiczna opcjonalna

    Chrome w wersji 59 lub nowszej .

    Tylko w ChromeOS. Jeśli ma wartość Prawda, tryb wyświetlania zmienia tryb wyświetlania na ujednolicony pulpit (więcej informacji znajdziesz tutaj: enableUnifiedDesktop). Jeśli ma wartość Fałsz, tryb ujednoliconego pulpitu jest wyłączony. Dotyczy to tylko głównego wyświetlacza. Jeśli podasz wartość mirroringSourceId, nie możesz jej podać, a inne właściwości będą ignorowane. Jeśli nie zostanie podane, działanie nie przyniesie żadnego efektu.

  • mirroringSourceId

    ciąg znaków opcjonalny

    Wycofane od Chrome 68

    Użyj setMirrorMode.

    Tylko w ChromeOS. Jeśli zasada jest ustawiona i nie jest pusta, włącza odbicie lustrzane tylko tego wyświetlacza. W przeciwnym razie wyłącza odbicie lustrzane na wszystkich wyświetlaczach. Ta wartość powinna wskazywać identyfikator źródłowego wyświetlacza do odbicia lustrzanego, który nie może być taki sam jak identyfikator przekazywany do setDisplayWłaściwości. Jeśli zasada jest skonfigurowana, nie można ustawić żadnej innej właściwości.

  • nadmiarowość obrazu

    Wstawki opcjonalne

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

  • rotacja

    liczba opcjonalnie

    Jeśli jest ustawione, aktualizuje obrót wyświetlacza. Wartości prawne to [0, 90, 180, 270]. Obrót ekranu jest ustawiony w prawo, odpowiednio do pozycji pionowej wyświetlacza.

DisplayUnitInfo

Właściwości

  • activeState
    Chrome w wersji 117 lub nowszej .

    Aktywny, jeśli wyświetlacz został wykryty i używany przez system.

  • availableDisplayZoomFactors

    liczba[]

    Chrome w wersji 67 lub nowszej .

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

  • granice

    Granice logiczne wyświetlacza.

  • displayZoomFactor

    liczba

    Chrome w wersji 65 lub nowszej .

    Współczynnik między bieżącym a domyślnym powiększeniem ekranu. Na przykład wartość 1 oznacza powiększenie 100%, a wartość 1, 5 – powiększenie 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 aplikacjach kiosku i interfejsie internetowym Chrome OS.

  • hasTouchSupport

    wartość logiczna

    Chrome w wersji 57 lub nowszej .

    Prawda, jeśli z wyświetlaczem jest powiązane urządzenie dotykowe.

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • isEnabled

    wartość logiczna

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

  • isPrimary

    wartość logiczna

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

  • isUnified

    wartość logiczna

    Chrome w wersji 59 lub nowszej .

    Prawda dla wszystkich wyświetlaczy w trybie ujednoliconego pulpitu. Zobacz dokumentację dotyczącą enableUnifiedDesktop.

  • mirroringDestinationIds

    ciąg znaków[]

    Chrome w wersji 64 lub nowszej .

    Tylko w ChromeOS. Identyfikatory ekranów, na których jest wyświetlany obraz źródłowy. Pole puste, jeśli nie są tworzone odbicia lustrzane ekranów. Będzie ona ustawiona na tę samą wartość dla wszystkich wyświetlaczy. Nie może zawierać właściwości mirroringSourceId.

  • mirroringSourceId

    ciąg znaków

    Tylko w ChromeOS. Identyfikator ekranu, który jest dublowany, jeśli włączone jest odbicie lustrzane. W przeciwnym razie pole jest puste. Ta opcja zostanie ustawiona dla wszystkich wyświetlaczy (w tym dla ekranu lustrzanego).

  • środki transportu
    Chrome w wersji 52 lub nowszej .

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

  • nazwa

    ciąg znaków

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

  • nadmiarowość obrazu

    Wcięcia wyświetlacza w granicach ekranu. Obecnie dostępne tylko w ChromeOS. Ustawienie zostanie ustawione na puste wstawki na innych platformach.

  • rotacja

    liczba

    Obrót ekranu w prawo, wyrażony w stopniach względem pozycji pionowej. Obecnie dostępne tylko w ChromeOS. W przypadku innych platform zostanie ustawiona na 0. Wartość –1 będzie interpretowana jako autoobracanie, gdy urządzenie będzie ustawione na fizycznym tablecie.

  • workArea

    Używany obszar roboczy wyświetlacza w granicach wyświetlania. Obszar roboczy nie obejmuje obszarów ekranu zarezerwowanych dla systemu operacyjnego, np. paska zadań czy programu uruchamiającego.

Edid

Chrome w wersji 67 lub nowszej .

Właściwości

  • manufacturerId

    ciąg znaków

    3-znakowy kod producenta. Zobacz sekcję 3.4.1 strona 21. Wymagane w wersji 1.4.

  • productId

    ciąg znaków

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

  • yearOfManufacture

    liczba

    Rok producenta, s. 3.4.4 strona 22. Wymagane w wersji 1.4.

GetInfoFlags

Chrome w wersji 59 lub nowszej .

Właściwości

  • singleUnified

    Wartość logiczna opcjonalna

    Jeśli zasada ma wartość Prawda, getInfo zwraca tylko jeden element DisplayUnitInfo w trybie ujednoliconego pulpitu (patrz enableUnifiedDesktop). Wartość domyślna to fałsz.

Insets

Właściwości

  • dół

    liczba

    Odległość osi Y od dolnej granicy.

  • w lewo

    liczba

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

  • w prawo

    liczba

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

  • góra

    liczba

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

LayoutPosition

Chrome w wersji 53 lub nowszej .

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

tryb lustrzany, czyli różne sposoby tworzenia odbicia lustrzanego ekranu na innych wyświetlaczach.

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 odbiciem lustrzanym wszystkich innych wyświetlaczy.

"mixed"
Określa, że podany źródłowy wyświetlacz będzie odzwierciedlany w wyświetlanym miejscu docelowym. Pozostałe podłączone ekrany będą rozszerzone.

MirrorModeInfo

Chrome w wersji 65 lub nowszej .

Właściwości

  • mirroringDestinationIds

    string[] opcjonalnie

    Wyświetlane są identyfikatory miejsca docelowego powielania. Ta wartość jest prawidłowa tylko w przypadku ustawienia „mieszane”.

  • mirroringSourceId

    ciąg znaków opcjonalny

    Identyfikator wyświetlacza źródła powielania. Ta wartość jest prawidłowa tylko w przypadku ustawienia „mieszane”.

  • tryb

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

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

    Współrzędne punktu wyświetlania.

  • touchPoint

    Współrzędne punktu kontaktu odpowiadającego punktowi wyświetlania.

TouchCalibrationPairQuad

Chrome w wersji 57 lub nowszej .

Właściwości

  • Do kalibracji dotykowej wymagana jest pierwsza para punktów dotykowych i wyświetlających.

  • Do kalibracji dotykowej wymagana jest druga para punktów dotykowych i wyświetlanych.

  • Do kalibracji dotykowej wymagana jest trzecia para punktu dotykowego i wyświetlacza.

  • Do kalibracji dotykowej wymagana jest czwarta para punktów dotykowych i wyświetlających.

Metody

clearTouchCalibration()

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

Resetuje kalibrację dotykową wyświetlacza i przywraca na nim stan domyślny, usuwając wszystkie powiązane z nim dane kalibracji dotykowej.

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

Ustawia pary kalibracji dotykowej wyświetlacza. Te elementy typu pairs będą używane do kalibracji ekranu dotykowego pod kątem wyświetlacza za pomocą metody id wywoływanej w programie startCustomTouchCalibration(). Zawsze wywołuj metodę startCustomTouchCalibration przed wywołaniem tej metody. Jeśli trwa już inna kalibracja dotykowa, spowoduje to wyświetlenie błędu.

Parametry

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

  • granice

    Ograniczenia ekranu podczas kalibracji dotykowej. Wartości bounds.left i bounds.top są ignorowane.

enableUnifiedDesktop()

Chrome w wersji 46 lub nowszej, .
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

Włącza/wyłącza funkcję ujednoliconego pulpitu. Jeśli ta opcja jest włączona, gdy włączone jest odbicie lustrzane, tryb pulpitu nie zmieni się, dopóki nie wyłączysz odbicia lustrzanego. W przeciwnym razie tryb pulpitu natychmiast przełączy się na ujednolicony. UWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.

Parametry

  • włączone

    wartość logiczna

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

getDisplayLayout()

Obietnica Chrome w wersji 53 lub nowszej
chrome.system.display.getDisplayLayout(
  callback?: function,
)

Żąda informacji o układzie na wszystkich wyświetlaczach. UWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (layouts: DisplayLayout[]) => void

Zwroty

  • Promise<DisplayLayout[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getInfo()

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

Żąda informacji o wszystkich podłączonych urządzeniach displayowych.

Parametry

  • flagi

    Opcjonalne GetInfoFlags

    Chrome w wersji 59 lub nowszej .

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (displayInfo: DisplayUnitInfo[]) => void

Zwroty

  • Promise<DisplayUnitInfo[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

overscanCalibrationAdjust()

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

Dostosowuje bieżące wcięcia nadmiarowego obrazu na wyświetlaczu. Zwykle powinno to przesunąć wyświetlacz wzdłuż osi (np. wartości lewa i prawa mają tę samą wartość) lub przeskalować go wzdłuż osi (np. wartości góra/dół mają przeciwstawne wartości). Każde wywołanie Adjust sumuje się z poprzednimi wywołaniami od momentu rozpoczęcia.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • Delta

    Kwota zmiany wcięcia nadmiarowego skanowania.

overscanCalibrationComplete()

Chrome w wersji 53 lub nowszej .
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

Całkowite korekty przeskanowania wyświetlacza przez zapisanie bieżących wartości i ukrycie nakładki.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

overscanCalibrationReset()

Chrome w wersji 53 lub nowszej .
chrome.system.display.overscanCalibrationReset(
  id: string,
)

Resetuje wcięcia nadskanowania dla wyświetlacza do ostatniej zapisanej wartości (tj.przed wywołaniem Start).

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

overscanCalibrationStart()

Chrome w wersji 53 lub nowszej .
chrome.system.display.overscanCalibrationStart(
  id: string,
)

Rozpoczyna kalibrację przeskanowania ekranu. Na ekranie pojawi się nakładka wskazująca bieżące wcięcia skanowania. Jeśli trwa kalibracja przeskanowania wyświetlacza id, kalibracja zostanie zresetowana.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

setDisplayLayout()

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

Ustaw układ dla wszystkich wyświetlaczy. Wszystkie ekrany, które nie zostaną uwzględnione, będą używać układu domyślnego. Jeśli układ mógłby się pokrywać lub byłby nieprawidłowy z innego powodu, zostanie dostosowany do prawidłowego układu. Po rozwiązaniu szablonu zostanie wywołane zdarzenie onDisplayChanged. UWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.

Parametry

  • układy

    Informacje o układzie wymagane na wszystkich wyświetlaczach oprócz głównego.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

setDisplayProperties()

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

Aktualizuje właściwości widoku określonego przez zasadę id zgodnie z informacjami podanymi w sekcji info. W przypadku niepowodzenia zostanie ustawiony zasób runtime.lastError. UWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • informacje

    Informacje o właściwościach wyświetlania, które należy zmienić. Właściwość zmienia się tylko wtedy, gdy w polu info określisz jej nową wartość.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

setMirrorMode()

Obietnica Chrome w wersji 65 lub nowszej
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde połączenie resetuje stan poprzednich połączeń. Wywołanie setDisplayWłaściwości() nie powiedzie się w przypadku powielania wyświetlania miejsca docelowego. UWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.

Parametry

  • informacje

    Informacje o trybie odbicia lustrzanego, który powinien być zastosowany do trybu wyświetlania.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

showNativeTouchCalibration()

Obietnica Chrome w wersji 57 lub nowszej
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Wyświetla UX kalibracji dotykowej ekranu natywnego z identyfikatorem id. Spowoduje to wyświetlenie na ekranie nakładki z wymaganymi instrukcjami dotyczącymi dalszego postępowania. Wywołanie zwrotne jest wywoływane tylko w przypadku kalibracji. Jeśli kalibracja się nie powiedzie, wyświetli się błąd.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie 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,
)

Rozpoczyna niestandardową kalibrację ekranu dotykowego. Tę metodę należy wywoływać, gdy używasz niestandardowego interfejsu użytkownika do zbierania danych kalibracyjnych. Jeśli trwa już inna kalibracja dotykowa, spowoduje to wyświetlenie błędu.

Parametry

  • id

    ciąg znaków

    Unikalny identyfikator wyświetlacza.

Wydarzenia

onDisplayChanged

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

Uruchamiane, gdy cokolwiek zmieni się w konfiguracji wyświetlania.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    () => void