Opis
Do wysyłania zapytań dotyczących wyświetlanych metadanych użyj interfejsu API system.display
.
Uprawnienia
system.display
Typy
ActiveState
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
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
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 nowszejWartość 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 nowszejCzęstotliwość odświeżania trybu wyświetlania w hercach.
-
uiScale
liczba opcjonalnie
Wycofane od Chrome 70Uż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ędziagetInfo
. 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 nowszejJeś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 nowszejJeś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 nowszejTylko 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 68Uż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
-
activeStateChrome w wersji 117 lub nowszej
Aktywny, jeśli wyświetlacz został wykryty i używany przez system.
-
availableDisplayZoomFactors
liczba[]
Chrome w wersji 67 lub nowszejLista 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 nowszejWspół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 nowszejUWAGA: ta funkcja jest dostępna tylko w aplikacjach kiosku i interfejsie internetowym Chrome OS.
-
hasTouchSupport
wartość logiczna
Chrome w wersji 57 lub nowszejPrawda, 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 nowszejPrawda dla wszystkich wyświetlaczy w trybie ujednoliconego pulpitu. Zobacz dokumentację dotyczącą
enableUnifiedDesktop
. -
mirroringDestinationIds
ciąg znaków[]
Chrome w wersji 64 lub nowszejTylko 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 transportuChrome 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
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
Właściwości
-
singleUnified
Wartość logiczna opcjonalna
Jeśli zasada ma wartość Prawda,
getInfo
zwraca tylko jeden elementDisplayUnitInfo
w trybie ujednoliconego pulpitu (patrzenableUnifiedDesktop
). 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
Pozycja układu, czyli krawędź elementu nadrzędnego, do którego jest dołączony wyświetlacz.
Typ wyliczeniowy
"top"
"right"
"bottom"
"left"
MirrorMode
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
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
Właściwości
-
x
liczba
Współrzędna X punktu.
-
y
liczba
Współrzędna Y punktu.
TouchCalibrationPair
Właściwości
-
displayPoint
Współrzędne punktu wyświetlania.
-
touchPoint
Współrzędne punktu kontaktu odpowiadającego punktowi wyświetlania.
TouchCalibrationPairQuad
Właściwości
-
pair1
Do kalibracji dotykowej wymagana jest pierwsza para punktów dotykowych i wyświetlających.
-
pair2
Do kalibracji dotykowej wymagana jest druga para punktów dotykowych i wyświetlanych.
-
pair3
Do kalibracji dotykowej wymagana jest trzecia para punktu dotykowego i wyświetlacza.
-
pair4
Do kalibracji dotykowej wymagana jest czwarta para punktów dotykowych i wyświetlających.
Metody
clearTouchCalibration()
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.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
ibounds.top
są ignorowane.
enableUnifiedDesktop()
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()
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
.-
układy
-
Zwroty
-
Promise<DisplayLayout[]>
Chrome w wersji 91 lub nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getInfo()
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 nowszejOpcje mające wpływ na sposób zwracania informacji.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(displayInfo: DisplayUnitInfo[]) => void
.-
displayInfo
-
Zwroty
-
Promise<DisplayUnitInfo[]>
Chrome w wersji 91 lub nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
overscanCalibrationAdjust()
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.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.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.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()
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 nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
setDisplayProperties()
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 nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
setMirrorMode()
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 nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
showNativeTouchCalibration()
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<boolean>
Chrome w wersji 91 lub nowszejObietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
startCustomTouchCalibration()
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
.