Opis
Aby przesłać zapytanie o metadane wyświetlania, 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. Ekran jest uznawany za „nieaktywny”, jeśli system go nie wykryje (może zostać odłączony lub wyłączony z powodu trybu uśpienia itp.). Ten stan pozwala zachować obecny wyświetlacz, np. gdy wszystkie wyświetlacze są odłączone.
Enum
Bounds
Właściwości
-
wysokość
Liczba
Wysokość wyświetlacza w pikselach.
-
lewa
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
string,
Unikalny identyfikator wyświetlacza.
-
przesunięcie
Liczba
Odsunięcie wyświetlacza wzdłuż połączonej krawędzi. Wartość 0 oznacza, że wyrównane są narożniki skrajnie górny lub lewy.
-
parentId
string,
Unikalny identyfikator wyświetlacza nadrzędnego. Puste, jeśli to jest katalog główny.
-
position
Położenie układu tego wyświetlacza względem elementu nadrzędnego. W katalogu głównym zostanie to zignorowane.
DisplayMode
Właściwości
-
deviceScaleFactor
Liczba
Współczynnik skali 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 i nowszyPrawda, jeśli ten tryb jest z przeplotem, lub false, jeśli nie jest podany.
-
isNative
boolean
Prawda, jeśli tryb jest trybem natywnym ekranu.
-
isSelected
boolean
Prawda, jeśli aktualnie wybrany jest tryb wyświetlania.
-
refreshRate
Liczba
Chrome 67 i nowsze wersjeCzęstotliwość odświeżania w trybie wyświetlania w hercach.
-
uiScale
Liczba opcjonalnie
Wycofane od Chrome 70Użyj formatu:
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
Liczba opcjonalnie
Jeśli zasada jest skonfigurowana, aktualizuje początek granic logicznych wyświetlacza wzdłuż osi X. Stosowane razem z usługą
boundsOriginY
. Jeśli nie jest ustawiona, a parametrboundsOriginY
jest ustawiony, domyślnie przyjmuje się bieżącą wartość. Pamiętaj, że podczas aktualizowania źródła wyświetlania obowiązują pewne ograniczenia, dlatego ostateczne źródło progów może być inne niż zestaw. Ostateczne progi można pobrać za pomocą funkcjigetInfo
. Nie można zmienić punktu początkowego granicy na głównym wyświetlaczu. -
boundsOriginY
Liczba opcjonalnie
Jeśli zasada jest skonfigurowana, aktualizuje początek granic logicznych wyświetlacza wzdłuż osi Y. Zobacz dokumentację parametru
boundsOriginX
. -
displayMode
Opcjonalny DisplayMode
Chrome 52 i nowsze wersjeJeśli jest ustawiony, tryb wyświetlania zmienia się na tryb 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 zostanie zastosowany i zostanie ustawiony błąd, ale inne właściwości będą nadal stosowane.
-
displayZoomFactor
Liczba opcjonalnie
Chrome 65 i nowsze wersjePo ustawieniu aktualizuje powiększenie powiązane z wyświetlaczem. Zoom zmienia układ i malowanie, co daje lepszej jakości powiększenie niż zwykłe 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 zasada jest skonfigurowana, wyświetlacz jest uznawany za główny w przypadku wszystkich pozostałych właściwości (np. może być ustawiony element
isUnified
, a granica punktu początkowego nie). -
isUnified
wartość logiczna opcjonalna
Chrome w wersji 59 i nowszychTylko ChromeOS. Jeśli zasada ma wartość Prawda, tryb wyświetlania zmienia się na ujednolicony pulpit (szczegóły znajdziesz w sekcji
enableUnifiedDesktop
). Jeśli zasada ma wartość Fałsz, tryb ujednoliconego pulpitu jest wyłączony. Ta opcja działa tylko w przypadku głównego wyświetlacza. Jeśli zostanie podany, parametr mirroringSourceId nie może być podany, a inne właściwości będą ignorowane. Jeśli jej nie podasz, nie będzie to miało żadnego efektu. -
mirroringSourceId
ciąg znaków opcjonalny
Wycofana od Chrome 68Użyj
setMirrorMode
.Tylko ChromeOS. Jeśli zasada jest skonfigurowana i nie jest pusta, tworzenie odbicia lustrzanego jest włączone tylko dla tego wyświetlacza. W przeciwnym razie wyłącza odbicie lustrzane wszystkich wyświetlaczy. Ta wartość powinna wskazywać identyfikator wyświetlanego źródła do powielania. Nie może on być taki sam jak identyfikator przekazany do setDisplayWłaściwości. Jeśli jest skonfigurowana, nie można ustawić żadnej innej właściwości.
-
nadmiarowość obrazu
Wstawki opcjonalnie
Jeśli jest skonfigurowana, ustawia ustawienia nadmiarowości obrazu na podane wartości. Pamiętaj, że wartości nadmiarowego skanowania nie mogą być ujemne ani większe niż połowa rozmiaru ekranu. Nadmiarowego skanowania nie można zmienić na monitorze wewnętrznym.
-
obrót
Liczba opcjonalnie
Jeśli jest ustawione, aktualizuje obrót wyświetlacza. Wartości prawne to [0, 90, 180, 270]. Obrót jest ustawiany w prawo względem pozycji pionowej ekranu.
DisplayUnitInfo
Właściwości
-
activeStateChrome 117 i nowsze wersje
Aktywny, jeśli system wykryje wyświetlacz i będzie go używać.
-
availableDisplayZoomFactors
liczba[]
Chrome 67 i nowsze wersjeLista wartości współczynnika powiększenia, które można ustawić dla wyświetlacza.
-
granica
Granice logiczne ekranu.
-
displayZoomFactor
Liczba
Chrome 65 i nowsze wersjeWspółczynnik proporcji między bieżącym a domyślnym powiększeniem ekranu. Na przykład wartość 1 odpowiada powiększenia 100%, a wartość 1, 5 odpowiada powiększenia 150%.
-
dpiX
Liczba
Liczba pikseli na cal na osi X.
-
dpiY
Liczba
Liczba pikseli na cal na osi Y.
-
Edid
Edid opcjonalnie
Chrome 67 i nowsze wersjeUWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
-
hasTouchSupport
boolean
Chrome 57 i nowsze wersjePrawda, jeśli z tym ekranem jest powiązane urządzenie dotykowe.
-
id
string,
Unikalny identyfikator wyświetlacza.
-
isEnabled
boolean
Prawda, jeśli ten ekran jest włączony.
-
isPrimary
boolean
Prawda, jeśli jest to główny wyświetlacz.
-
isUnified
boolean
Chrome w wersji 59 i nowszychPrawda na wszystkich wyświetlaczach w trybie ujednoliconego pulpitu. Zobacz dokumentację na temat
enableUnifiedDesktop
. -
mirroringDestinationIds
string[]
Chrome w wersji 64 i nowszychTylko ChromeOS. Identyfikatory wyświetlaczy, na których jest odbicie lustrzane wyświetlacza źródłowego. Puste, jeśli nie są tworzone odbicia lustrzane żadnych wyświetlaczy. Będzie miała tę samą wartość dla wszystkich wyświetlaczy. Nie może zawierać
mirroringSourceId
. -
mirroringSourceId
string,
Tylko ChromeOS. Identyfikator wyświetlacza, którego odbicie lustrzane jest włączone, w przeciwnym razie jest pusty. Ustawienie zostanie ustawione dla wszystkich wyświetlaczy (także tych, które mają odbicie lustrzane).
-
modesChrome 52 i nowsze wersje
Lista dostępnych trybów wyświetlania. Bieżący tryb będzie miał postać isSelected=true. Funkcja dostępna tylko w systemie operacyjnym Chrome. Na innych platformach zostanie ustawiona pusta tablica.
-
nazwa
string,
Przyjazna dla użytkownika nazwa (np. „Monitor LCD HP”).
-
nadmiarowość obrazu
Zakres wcięcia wyświetlacza mieści się w granicach ekranu. Obecnie dostępny tylko w ChromeOS. Na innych platformach zostanie ustawiony pusty odstęp.
-
obrót
Liczba
Obrót wyświetlacza w prawo w stopniach względem pozycji pionowej. Obecnie dostępny tylko w ChromeOS. Na innych platformach zostanie ustawiona wartość 0. Gdy urządzenie znajduje się w stanie tabletu, wartość -1 jest interpretowana jako autoobracanie.
-
workArea
Użyty obszar roboczy wyświetlacza w granicach wyświetlania. Obszar roboczy nie obejmuje obszarów wyświetlacza zarezerwowanych dla systemu operacyjnego, takich jak pasek zadań i program uruchamiający.
Edid
Właściwości
-
manufacturerId
string,
3-znakowy kod producenta. Patrz: sekcja 3.4.1, strona 21. Wymagane w wersji 1.4.
-
productId
string,
2-bajtowy kod przypisany przez producenta, sekcja 3.4.2, strona 21. Wymagane w wersji 1.4.
-
yearOfManufacture
Liczba
Rok producenta, sekcja 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, w trybie ujednoliconego pulpitu (patrz
enableUnifiedDesktop
) zwracany jest tylko jeden elementDisplayUnitInfo
. Wartość domyślna to false (fałsz).getInfo
Insets
Właściwości
-
dół
Liczba
Odległość osi Y od dolnej granicy.
-
lewa
Liczba
Odległość osi X od lewej granicy.
-
prawa
Liczba
Odległość osi X od prawej krawędzi.
-
góra
Liczba
Odległość osi Y od górnej granicy.
LayoutPosition
Położenie układu, czyli krawędź elementu nadrzędnego, do której jest dołączony wyświetlacz.
Enum
"top"
"bottom"
"left"
MirrorMode
Tryb odbicia lustrzanego, czyli różne sposoby odbicia lustrzanego ekranu na innych wyświetlaczach.
Enum
"off"
Określa tryb domyślny (rozszerzony lub ujednolicony pulpit).
"normal"
Określa, że domyślny wyświetlacz źródła jest powielany na wszystkich pozostałych wyświetlaczach.
"mixed"
Określa, że wybrany wyświetlacz źródłowy będzie odzwierciedlony na podanych wyświetlaczach docelowych. Pozostałe podłączone wyświetlacze zostaną rozszerzone.
MirrorModeInfo
Właściwości
-
mirroringDestinationIds
string[] opcjonalny
Wyświetlą się identyfikatory powielanego miejsca docelowego. Ta opcja działa tylko w przypadku kampanii „mieszane”.
-
mirroringSourceId
ciąg znaków opcjonalny
Identyfikator wyświetlacza powielanego źródła. Ta opcja działa tylko w przypadku kampanii „mieszane”.
-
tryb
Tryb odbicia lustrzanego, który należy ustawić.
Point
Właściwości
-
x
Liczba
Współrzędna na osi X punktu.
-
r.
Liczba
Współrzędna Y punktu.
TouchCalibrationPair
Właściwości
-
displayPoint
Współrzędne punktu wyświetlania.
-
touchPoint
Współrzędne punktu styku odpowiadającego punktowi wyświetlania.
TouchCalibrationPairQuad
Właściwości
-
pair1
Do kalibracji dotykowej wymagana jest pierwsza para punktu dotyku i wyświetlacza.
-
pair2
Do kalibracji dotykowej wymagana jest druga para punktu dotyku i wyświetlacza.
-
pair3
Do kalibracji dotykowej wymagana jest trzecia para punktu dotyku i wyświetlacza.
-
pair4
Do kalibracji dotykowej wymagana jest czwarta para punktu dotyku i wyświetlacza.
Metody
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Resetuje kalibrację dotykową wyświetlacza i przywraca go do stanu domyślnego przez usunięcie wszystkich danych dotyczących kalibracji dotykowej powiązanych z wyświetlaczem.
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Ustawia pary kalibracji dotyku dla wyświetlacza. Te pairs
zostaną użyte do kalibracji ekranu dotykowego dla wyświetlacza z parametrem id
wywołanym w startCustomTouchCalibration(). Zawsze wywołuj startCustomTouchCalibration
przed wywołaniem tej metody. Jeśli trwa już inna kalibracja dotyku, spowoduje to wystąpienie błędu.
Parametry
-
Pary punktów używanych do kalibracji wyświetlacza.
-
granica
Ograniczenia ekranu podczas 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 funkcja jest włączona, gdy odbicie lustrzane jest aktywne, tryb pulpitu nie zmieni się, dopóki odbicie lustrzane nie zostanie wyłączone. W przeciwnym razie tryb pulpitu natychmiast przełączy się na jednolity. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
Parametry
-
włączone
boolean
Prawda, jeśli ujednolicony pulpit powinien być włączony.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
Wysyła żądanie informacji o układzie dla wszystkich wyświetlaczy. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
Parametry
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(layouts: DisplayLayout[]) => void
-
układy
-
Akcje powrotne
-
Promise<DisplayLayout[]>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Wysyła żądanie informacji o wszystkich podłączonych ekranach.
Parametry
-
flagi
GetInfoFlags opcjonalnie
Chrome w wersji 59 i nowszychOpcje wpływające na sposób zwracania informacji.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Akcje powrotne
-
Promise<DisplayUnitInfo[]>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Dostosowuje bieżące ustawienia nadmiarowości obrazu dla wyświetlacza. Zwykle powinno to spowodować przesunięcie widoku wzdłuż osi (np. wartości lewo i prawo mają tę samą wartość) lub przeskalować wzdłuż osi (np. góra/dół mają przeciwne wartości). Każde wywołanie Adjust jest kumulowane z poprzednimi wywołaniami od początku.
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
-
Delta
Wartość zmiany ustawień nadmiarowości obrazu.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Aby zakończyć przeskanowanie wyświetlacza, zapisz bieżące wartości i ukryj nakładkę.
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Resetuje ustawienia nadmiarowości obrazu dla wyświetlenia do ostatniej zapisanej wartości (tj.przed wywołaniem rozpoczęcia).
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
Rozpoczyna kalibrację przeskanowania wyświetlacza. Na ekranie pojawi się nakładka wskazująca bieżące ustawienia nadmiarowości obrazu. Jeśli trwa kalibracja przeskanowanego wyświetlacza id
, kalibracja zostanie zresetowana.
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
Ustaw układ dla wszystkich wyświetlaczy. Wszystkie niedołączone wyświetlacze będą korzystać z układu domyślnego. Jeśli układ będzie się pokrywał lub byłby nieprawidłowy z innego powodu, zostanie dostosowany do prawidłowego układu. Po rozpoznaniu układu wywoływane jest zdarzenie onDisplayChanged. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
Parametry
-
układy
Informacje o układzie, wymagane na wszystkich wyświetlaczach oprócz głównego.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
Aktualizuje właściwości wyświetlania określone przez zasadę id
zgodnie z informacjami podanymi w zasadzie info
. W przypadku niepowodzenia ustawiono runtime.lastError
. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
Parametry
-
id
string,
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 w elemencie
info
określisz dla niej nową wartość. -
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Ustawia tryb wyświetlania na określony tryb lustrzany. Każde połączenie resetuje stan z poprzednich połączeń. Wywołanie setDisplayWłaściwości() nie powiedzie się w przypadku powielanych ekranów docelowych. UWAGA: ta funkcja jest dostępna tylko w przypadku aplikacji kiosku Chrome OS i interfejsu internetowego.
Parametry
-
informacje
Informacje o trybie odbicia lustrzanego, który powinien być stosowany w trybie wyświetlania.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Wyświetla interfejs natywnej kalibracji dotyku w przypadku wyświetlacza z identyfikatorem id
. Na ekranie wyświetli się nakładka z wymaganymi instrukcjami dotyczącymi dalszych czynności. Wywołanie zwrotne jest wywoływane tylko w przypadku pomyślnej kalibracji. Jeśli kalibracja się nie powiedzie, pojawi się błąd.
Parametry
-
id
string,
Unikalny identyfikator wyświetlacza.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(success: boolean) => void
-
sukces
boolean
-
Akcje powrotne
-
Promise<boolean>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Rozpoczyna niestandardową kalibrację ekranu dotykowego. Ta funkcja powinna być wywoływana, gdy używasz niestandardowego interfejsu do zbierania danych kalibracyjnych. Jeśli trwa już inna kalibracja dotyku, spowoduje to wystąpienie błędu.
Parametry
-
id
string,
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