refresh date: 2026-09-25 robots: noindex
Opis
Użyj interfejsu API system.display, aby wysłać zapytanie o wyświetlane metadane.
Uprawnienia
system.displayTypy
ActiveState
Typ wyliczeniowy wskazujący, czy wyświetlacz jest wykrywany i używany przez system. Wyświetlacz jest uznawany 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 jest używany na przykład do zachowania istniejącego 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
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
tekst
Unikalny identyfikator wyświetlacza.
-
offset
liczba
Przesunięcie wyświetlacza wzdłuż połączonej krawędzi. Wartość 0 oznacza, że wyrównane są górne lub lewe rogi.
-
parentId
tekst
Unikalny identyfikator wyświetlacza nadrzędnego. Jeśli jest to katalog główny, pole jest puste.
-
position
Pozycja układu tego wyświetlacza względem elementu nadrzędnego. W przypadku katalogu głównego zostanie to zignorowane.
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
boolean opcjonalne
Chrome 74 lub nowsza wersjaWartość „prawda”, jeśli ten tryb jest z przeplotem, lub „fałsz”, jeśli nie podano.
-
isNative
wartość logiczna
Wartość True (Prawda), jeśli tryb jest trybem natywnym wyświetlacza.
-
isSelected
wartość logiczna
Prawda, jeśli tryb wyświetlania jest obecnie wybrany.
-
refreshRate
liczba
Chrome 67 lub nowsza wersjaCzęstotliwość odświeżania trybu wyświetlania w hercach.
-
uiScale
number optional
Wycofane od wersji Chrome 70Otwórz
displayZoomFactorWspół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 optional
Jeśli jest ustawiona, aktualizuje początek logicznych granic wyświetlacza wzdłuż osi X. Zastosowano razem z:
boundsOriginY. Jeśli nie zostanie ustawiony, a ustawiony jest parametrboundsOriginY, domyślnie przyjmuje bieżącą wartość. Pamiętaj, że podczas aktualizowania punktu początkowego wyświetlania zostaną zastosowane pewne ograniczenia, więc ostateczny punkt początkowy granic może się różnić od ustawionego. Ostateczne granice można pobrać za pomocą metodygetInfo. Nie można zmienić punktu początkowego granic na wyświetlaczu głównym. -
boundsOriginY
number optional
Jeśli jest ustawiona, aktualizuje początek logicznych granic wyświetlacza wzdłuż osi Y. Zapoznaj się z dokumentacją parametru
boundsOriginX. -
displayMode
DisplayMode opcjonalny
Chrome 52 lub nowsza wersjaJeśli jest ustawiona, aktualizuje tryb wyświetlania do trybu odpowiadającego tej wartości. Jeśli inne parametry są nieprawidłowe, nie zostanie on zastosowany. Jeśli tryb wyświetlania jest nieprawidłowy, nie zostanie zastosowany i pojawi się błąd, ale inne właściwości zostaną zastosowane.
-
displayZoomFactor
number optional
Chrome 65 lub nowsza wersjaJeśli jest ustawiona, aktualizuje powiększenie powiązane z wyświetlaczem. To powiększenie powoduje zmianę układu i ponowne renderowanie, co zapewnia lepszą jakość niż zwykłe powiększenie piksel po pikselu.
-
isPrimary
boolean opcjonalne
Jeśli ma wartość Prawda, wyświetlacz jest ustawiony jako główny. Jeśli ma wartość Fałsz, nie ma żadnego efektu. Uwaga: jeśli ta właściwość jest ustawiona, wyświetlacz jest traktowany jako główny w przypadku wszystkich innych właściwości (np. można ustawić
isUnified, ale nie można ustawić początku granic). -
isUnified
boolean opcjonalne
Chrome 59 lub nowsza wersjaTylko w systemie ChromeOS. Jeśli zasada ma wartość Prawda, tryb wyświetlania zmienia się na ujednolicony pulpit (szczegółowe informacje znajdziesz w artykule
enableUnifiedDesktop). Jeśli zasada ma wartość Fałsz, tryb ujednoliconego pulpitu jest wyłączony. Dotyczy to tylko wyświetlacza głównego. Jeśli podano wartość, nie można podać parametru mirroringSourceId, a inne właściwości zostaną zignorowane. Jeśli nie podasz tej wartości, nie będzie to miało żadnego wpływu. -
mirroringSourceId
ciąg znaków opcjonalny
Wycofane w Chrome 68Użyj
setMirrorMode.Tylko w systemie ChromeOS. Jeśli ta zasada jest skonfigurowana i nie jest pusta, włącza dublowanie tylko na tym wyświetlaczu. W przeciwnym razie wyłącza tworzenie odbicia lustrzanego na wszystkich wyświetlaczach. Ta wartość powinna wskazywać identyfikator źródłowego wyświetlacza, który ma być dublowany. Nie może on być taki sam jak identyfikator przekazany do metody setDisplayProperties. Jeśli ta właściwość jest ustawiona, nie można ustawić żadnej innej.
-
nadmiarowość obrazu
Insets opcjonalny
Jeśli ta zasada jest skonfigurowana, ustawia wstawki overscanu wyświetlacza na podane wartości. Pamiętaj, że wartości overscan nie mogą być ujemne ani większe niż połowa rozmiaru ekranu. Nie można zmienić overscanu na monitorze wewnętrznym.
-
obrót
number optional
Jeśli jest ustawiona, aktualizuje obrót wyświetlacza. Prawidłowe wartości to [0, 90, 180, 270]. Obrót jest ustawiany zgodnie z ruchem wskazówek zegara względem pozycji w pionie wyświetlacza.
DisplayUnitInfo
Właściwości
-
activeStateChrome 117 lub nowsza wersja
Aktywny, jeśli wyświetlacz jest wykrywany i używany przez system.
-
availableDisplayZoomFactors
number[]
Chrome 67 lub nowsza wersjaLista wartości współczynnika powiększenia, które można ustawić dla wyświetlacza.
-
bounds
Granice logiczne wyświetlacza.
-
displayZoomFactor
liczba
Chrome 65 lub nowsza wersjaStosunek bieżącego powiększenia wyświetlacza do domyślnego. Na przykład wartość 1 odpowiada powiększeniu 100%, a wartość 1, 5 – powiększeniu 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 67 lub nowsza wersjaUWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS.
-
hasTouchSupport
wartość logiczna
Chrome 57 lub nowsza wersjaWartość „true”, jeśli z tym wyświetlaczem jest powiązane urządzenie do dotykowego wprowadzania danych.
-
id
tekst
Unikalny identyfikator wyświetlacza.
-
isEnabled
wartość logiczna
Wartość True (Prawda), jeśli ten wyświetlacz jest włączony.
-
isPrimary
wartość logiczna
Wartość True (Prawda), jeśli jest to wyświetlacz główny.
-
isUnified
wartość logiczna
Chrome 59 lub nowsza wersjaPrawda dla wszystkich wyświetlaczy w trybie ujednoliconego pulpitu. Zobacz dokumentację
enableUnifiedDesktop. -
mirroringDestinationIds
string[]
Chrome 64 lub nowsza wersjaTylko w systemie ChromeOS. Identyfikatory wyświetlaczy, na które jest dublowany wyświetlacz źródłowy. Jeśli nie ma żadnych wyświetlaczy, pole jest puste. Ta wartość będzie taka sama dla wszystkich wyświetlaczy. Nie może zawierać:
mirroringSourceId. -
mirroringSourceId
tekst
Tylko w systemie ChromeOS. Identyfikator wyświetlacza, który jest dublowany, jeśli dublowanie jest włączone. W przeciwnym razie pole jest puste. Zostanie ona ustawiona na wszystkich wyświetlaczach (w tym na wyświetlaczu, który jest dublowany).
-
trybyChrome 52 lub nowsza wersja
Lista dostępnych trybów wyświetlania. Bieżący tryb będzie miał wartość isSelected=true. Dostępne tylko w ChromeOS. Na innych platformach zostanie ustawiona pusta tablica.
-
nazwa
tekst
Przyjazna dla użytkownika nazwa (np. „Monitor LCD HP”).
-
nadmiarowość obrazu
Wstawki wyświetlacza w granicach ekranu. Obecnie jest dostępna tylko w ChromeOS. Na innych platformach zostaną ustawione puste wstawki.
-
obrót
liczba
Obrót wyświetlacza w prawo w stopniach względem pozycji w pionie. Obecnie jest dostępna tylko w ChromeOS. Na innych platformach zostanie ustawiona wartość 0. Wartość -1 będzie interpretowana jako autoobracanie, gdy urządzenie jest w trybie tabletu.
-
workArea
Użyteczny 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 menu z aplikacjami.
Edid
Właściwości
-
manufacturerId
tekst
3-znakowy kod producenta. Patrz sekcja 3.4.1 na stronie 21. Wymagane w wersji 1.4.
-
productId
tekst
2-bajtowy kod przypisany przez producenta, sekcja 3.4.2, strona 21. Wymagane w wersji 1.4.
-
yearOfManufacture
liczba
Rok produkcji, sekcja 3. 4.4, s.22. Wymagane w wersji 1.4.
GetInfoFlags
Właściwości
-
singleUnified
boolean opcjonalne
Jeśli ma wartość Prawda, w trybie ujednoliconego pulpitu (patrz
enableUnifiedDesktop)getInfozwraca tylko 1DisplayUnitInfo. Domyślnie ma wartość Fałsz.
Insets
Właściwości
-
dół
liczba
Odległość od dolnej granicy na osi Y.
-
w lewo
liczba
Odległość na osi X od lewej krawędzi.
-
w prawo
liczba
Odległość osi X od prawej granicy.
-
góra
liczba
Odległość osi Y od górnej granicy.
LayoutPosition
Pozycja układu, czyli krawędź elementu nadrzędnego, do której jest dołączony wyświetlacz.
Typ wyliczeniowy
"top"
"right"
"bottom"
"left"
MirrorMode
Tryb odbicia lustrzanego, czyli różne sposoby powielania obrazu z jednego wyświetlacza na innych.
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 odzwierciedlany na wszystkich pozostałych wyświetlaczach.
"mixed"
Określa, że określony wyświetlacz źródłowy będzie odzwierciedlany na podanych wyświetlaczach docelowych. Wszystkie pozostałe podłączone wyświetlacze będą rozszerzone.
MirrorModeInfo
Właściwości
-
mirroringDestinationIds
string[] opcjonalne
Identyfikatory wyświetlaczy docelowych, na których ma być wyświetlane odbicie lustrzane. Ta wartość jest prawidłowa tylko w przypadku typu „mieszany”.
-
mirroringSourceId
ciąg znaków opcjonalny
Identyfikator źródłowego wyświetlacza, który jest dublowany. Ta wartość jest prawidłowa tylko w przypadku typu „mieszany”.
-
tryb
Tryb odbicia lustrzanego, który powinien być ustawiony.
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 dotknięcia odpowiadające punktowi wyświetlania.
TouchCalibrationPairQuad
Właściwości
-
pair1
Do kalibracji dotyku wymagana jest pierwsza para punktów dotyku i wyświetlania.
-
pair2
Do kalibracji dotyku wymagana jest druga para punktów dotyku i wyświetlania.
-
pair3
Do kalibracji dotyku wymagana jest trzecia para punktów dotyku i wyświetlania.
-
pair4
Do kalibracji dotyku wymagana jest czwarta para punktów dotyku i wyświetlania.
Metody
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Resetuje kalibrację dotyku wyświetlacza i przywraca go do stanu domyślnego, usuwając wszystkie dane kalibracji dotyku powiązane z wyświetlaczem.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustawia pary kalibracji dotykowej dla wyświetlacza. Te pairs zostaną użyte do skalibrowania ekranu dotykowego wyświetlacza za pomocą id wywołanego w funkcji startCustomTouchCalibration(). Zawsze wywołuj startCustomTouchCalibration przed wywołaniem tej metody. Jeśli trwa już inna kalibracja dotyku, spowoduje to błąd.
Parametry
-
Pary punktów używane do kalibracji wyświetlacza.
-
bounds
Granice wyświetlacza w momencie kalibracji dotykowej. Wartości
bounds.leftibounds.topsą ignorowane.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Włącza lub wyłącza funkcję ujednoliconego pulpitu. Jeśli ta opcja zostanie włączona, gdy aktywne jest dublowanie, tryb pulpitu nie zmieni się, dopóki dublowanie nie zostanie wyłączone. W przeciwnym razie tryb pulpitu natychmiast przełączy się na ujednolicony.
Parametry
-
aktywne
wartość logiczna
Wartość True, jeśli ujednolicony pulpit ma być włączony.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
): Promise<DisplayLayout[]>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Wysyła prośbę o informacje o układzie wszystkich wyświetlaczy.
Parametry
-
callback
function opcjonalne
Parametr
callbackwygląda tak:(layouts: DisplayLayout[]) => void
-
układy
-
Zwroty
-
Promise<DisplayLayout[]>
Chrome 91 lub nowsza wersjaObiekt Promise, który jest rozwiązywany za pomocą wyników.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
): Promise<DisplayUnitInfo[]>
Wysyła żądanie informacji o wszystkich podłączonych urządzeniach wyświetlających.
Parametry
-
flagi
GetInfoFlags opcjonalny
Chrome 59 lub nowsza wersjaOpcje wpływające na sposób zwracania informacji.
-
callback
function opcjonalne
Parametr
callbackwygląda tak:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Zwroty
-
Promise<DisplayUnitInfo[]>
Chrome 91 lub nowsza wersjaObiekt Promise, który jest rozwiązywany za pomocą wyników.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Dostosowuje bieżące wstawki overscanu dla wyświetlacza. Zwykle powinno to spowodować przesunięcie wyświetlacza wzdłuż osi (np. lewa i prawa strona mają tę samą wartość) lub przeskalowanie go wzdłuż osi (np. góra i dół mają przeciwne wartości). Każde wywołanie Adjust jest kumulowane z poprzednimi wywołaniami od momentu wywołania Start.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
-
Delta
Wartość, o którą mają zostać zmienione wstawki overscan.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Zakończ dostosowywanie overscanu wyświetlacza, zapisując bieżące wartości i ukrywając nakładkę.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Resetuje wstawki overscanu wyświetlacza do ostatniej zapisanej wartości (czyli sprzed wywołania funkcji Start).
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Rozpoczyna kalibrację nadmiernego skanowania wyświetlacza. Na ekranie pojawi się nakładka wskazująca bieżące wstawki nadmiernego skanowania. Jeśli trwa kalibracja overscanu wyświetlacza id, spowoduje to jej zresetowanie.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
): Promise<void>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustaw układ wszystkich wyświetlaczy. W przypadku wszystkich nieuwzględnionych wyświetlaczy zostanie użyty układ domyślny. Jeśli układ nakłada się na inny lub jest nieprawidłowy, zostanie dostosowany do prawidłowego układu. Po rozwiązaniu układu zostanie wywołane zdarzenie onDisplayChanged.
Parametry
-
układy
Informacje o układzie, wymagane w przypadku wszystkich wyświetlaczy oprócz głównego.
-
callback
function opcjonalne
Parametr
callbackwygląda tak:() => void
Zwroty
-
thought Promise<void>
Chrome 91 lub nowsza wersjaObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
): Promise<void>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Aktualizuje właściwości wyświetlacza określonego przez id zgodnie z informacjami podanymi w info. W przypadku niepowodzenia zostanie ustawiona wartość runtime.lastError.
Parametry
-
id
tekst
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 obiekcie
infozostanie określona jej nowa wartość. -
callback
function opcjonalne
Parametr
callbackwygląda tak:() => void
Zwroty
-
thought Promise<void>
Chrome 91 lub nowsza wersjaObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
): Promise<void>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Ustawia tryb wyświetlania na określony tryb odbicia lustrzanego. Każde wywołanie resetuje stan z poprzednich wywołań. Wywołanie funkcji setDisplayProperties() nie powiedzie się w przypadku wyświetlaczy docelowych kopii lustrzanej.
Parametry
-
informacje
Informacje o trybie odbicia lustrzanego, który powinien zostać zastosowany do trybu wyświetlania.
-
callback
function opcjonalne
Parametr
callbackwygląda tak:() => void
Zwroty
-
thought Promise<void>
Chrome 91 lub nowsza wersjaObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
): Promise<boolean>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Wyświetla natywny interfejs kalibracji dotykowej dla wyświetlacza o identyfikatorze id. Na ekranie pojawi się nakładka z instrukcjami, jak postępować. Wywołanie zwrotne zostanie wywołane tylko w przypadku pomyślnej kalibracji. Jeśli kalibracja się nie powiedzie, pojawi się błąd.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
-
callback
function opcjonalne
Parametr
callbackwygląda tak:(success: boolean) => void
-
sukces
wartość logiczna
-
Zwroty
-
Promise<boolean>
Chrome 91 lub nowsza wersjaObiekt Promise, który informuje rozmówcę o zakończeniu kalibracji dotykowej. Wartość logiczna informuje, czy kalibracja się powiodła.
Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Rozpoczyna niestandardową kalibrację dotykową wyświetlacza. Należy ją wywołać, gdy do zbierania danych kalibracyjnych używasz niestandardowego interfejsu użytkownika. Jeśli trwa już inna kalibracja dotyku, spowoduje to błąd.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
Wydarzenia
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Uruchamiane, gdy zmieni się konfiguracja wyświetlania.
Parametry
-
callback
funkcja
Parametr
callbackwygląda tak:() => void