Opis
Aby wysłać zapytanie o metadane wyświetlania, użyj interfejsu API system.display
.
Uprawnienia
system.display
Typy
ActiveState
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
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
Pozycja układu tego wyświetlacza względem elementu nadrzędnego. W przypadku głównego elementu zostanie on zignorowany.
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 74 lub nowszyWartość „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 nowszejCzęstotliwość odświeżania trybu wyświetlania w hercach.
-
uiScale
number opcjonalny
Wycofane w wersji Chrome 70Uż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, aboundsOriginY
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 nowszeJeś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 nowszyTylko 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 68Uż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
-
activeStateChrome 117+
Aktywny, jeśli wyświetlacz jest wykrywany i używany przez system.
-
availableDisplayZoomFactors
number[]
Chrome w wersji 67 lub nowszejLista wartości współczynnika powiększenia, które można ustawić dla wyświetlacza.
-
bounds
Logiczne granice wyświetlacza.
-
displayZoomFactor
liczba
Chrome 65 i nowszeStosunek 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 nowszejUWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku i interfejsu internetowego w ChromeOS.
-
hasTouchSupport
wartość logiczna
Chrome 57 lub nowszyWartość 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 nowszyPrawda 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ówChrome 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
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
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
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
Właściwości
-
singleUnified
wartość logiczna opcjonalna
Jeśli ma wartość Prawda, funkcja
getInfo
zwraca tylko jedną wartośćDisplayUnitInfo
w trybie ujednoliconego pulpitu (patrzenableUnifiedDesktop
). 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
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 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
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
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 dotykowego odpowiadające punktowi wyświetlania;
TouchCalibrationPairQuad
Właściwości
-
pair1
Pierwsza para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.
-
pair2
Druga para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.
-
pair3
Trzecia para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.
-
pair4
Czwarta para punktów dotykowych i wyświetlacza wymagana do kalibracji dotyku.
Metody
clearTouchCalibration()
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.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 ekranu w momencie kalibracji dotykowej. Wartości
bounds.left
ibounds.top
są ignorowane.
enableUnifiedDesktop()
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()
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
-
layouts
-
Zwroty
-
Promise<DisplayLayout[]>
Chrome 91 lub nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Wymaga informacji o wszystkich podłączonych wyświetlaczach.
Parametry
-
flagi
GetInfoFlags opcjonalnie
Chrome 59 lub nowszyOpcje wpływające na sposób zwracania informacji.
-
wywołanie zwrotne
function opcjonalny
Parametr
callback
ma postać:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Zwroty
-
Promise<DisplayUnitInfo[]>
Chrome 91 lub nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
overscanCalibrationAdjust()
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
Wartość, o którą mają być zmienione wstawienia w ramkach przesunięcia.
overscanCalibrationComplete()
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.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.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()
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
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 nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
setDisplayProperties()
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
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 nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
setMirrorMode()
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
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 nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
showNativeTouchCalibration()
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 nowszyObietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.
startCustomTouchCalibration()
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