refresh date: 2026-09-25 robots: noindex
Opis
Użyj interfejsu system.display API, aby wysyłać zapytania o wyświetlane metadane.
Uprawnienia
system.displayTypy
ActiveState
Wyliczenie określające, 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 uznawany za odłączony z powodu trybu uśpienia itp.). Ten stan jest używany do zachowania istniejącego wyświetlacza, gdy wszystkie wyświetlacze są odłączone, na przykład.
Typ wyliczeniowy
„aktywny”
„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.
-
odliczyć
liczba
Przesunięcie wyświetlacza wzdłuż połączonej krawędzi. Wartość 0 oznacza, że górne lub lewe rogi są wyrównane.
-
parentId
tekst
Unikalny identyfikator wyświetlacza nadrzędnego. Puste, jeśli jest to katalog główny.
-
position
Położenie tego wyświetlacza w układzie względem elementu nadrzędnego. W przypadku elementu 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
wartość logiczna opcjonalna
Chrome 74 lub nowszaWartość „prawda”, jeśli ten tryb jest przeplatany. Wartość „fałsz”, jeśli nie podano.
-
isNative
wartość logiczna
Wartość Prawda, jeśli tryb jest trybem natywnym wyświetlacza.
-
isSelected
wartość logiczna
Wartość „Prawda”, jeśli tryb wyświetlania jest obecnie wybrany.
-
refreshRate
liczba
Chrome 67 lub nowszaCzęstotliwość odświeżania trybu wyświetlania w hercach.
-
uiScale
number opcjonalny
Wycofane w 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 opcjonalny
Jeśli jest ustawiony, aktualizuje początek logicznych granic wyświetlacza wzdłuż osi X. Zastosowano razem z
boundsOriginY. Jeśli nie zostanie ustawiona, domyślnie przyjmuje aktualną wartość, a parametrboundsOriginYjest ustawiony. Pamiętaj, że podczas aktualizowania źródła wyświetlania zostaną zastosowane pewne ograniczenia, więc ostateczne źródło granic może się różnić od ustawionego. Ostateczne granice można pobrać za pomocą funkcjigetInfo. Nie można zmienić początku zakresu na wyświetlaczu głównym. -
boundsOriginY
number opcjonalny
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 nowszaJeśli jest ustawiona, aktualizuje tryb wyświetlania do trybu pasującego do tej wartości. Jeśli inne parametry są nieprawidłowe, to ustawienie nie zostanie zastosowane. Jeśli tryb wyświetlania jest nieprawidłowy, nie zostanie zastosowany i zostanie ustawiony błąd, ale inne właściwości nadal będą stosowane.
-
displayZoomFactor
number opcjonalny
Chrome 65 lub nowszaJeśli jest ustawione, aktualizuje powiększenie powiązane z wyświetlaczem. Ten zoom zmienia układ i ponownie rysuje obraz, co zapewnia lepszą jakość powiększenia niż zwykłe rozciąganie pikseli.
-
isPrimary
wartość logiczna opcjonalna
Jeśli ma wartość Prawda, wyświetlacz staje się głównym. Jeśli ma wartość Fałsz, nie ma żadnego efektu. Uwaga: jeśli to ustawienie jest włączone, wyświetlanie jest uznawane za podstawowe w przypadku wszystkich innych usług (np. można ustawić
isUnified, ale nie można ustawić źródła granic). -
isUnified
wartość logiczna opcjonalna
Chrome 59 lub nowszaTylko w ChromeOS. Jeśli ma wartość Prawda, zmienia tryb wyświetlania na ujednolicony pulpit (szczegóły znajdziesz w sekcji
enableUnifiedDesktop). Jeśli zasada ma wartość Fałsz, tryb ujednoliconego pulpitu zostanie 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 zostanie podana, nie będzie miała żadnego wpływu. -
mirroringSourceId
ciąg znaków opcjonalny
Wycofane w Chrome 68Użyj
setMirrorMode.Tylko w ChromeOS. Jeśli ta opcja jest ustawiona 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 wyświetlacza źródłowego do odzwierciedlenia, który nie może być taki sam jak identyfikator przekazany do setDisplayProperties. Jeśli ta właściwość jest ustawiona, nie można ustawić żadnej innej.
-
nadmiarowość obrazu,
Wstawki opcjonalne
Jeśli jest ustawiona, określa wstawki overscanu wyświetlacza na podstawie podanych wartości. Pamiętaj, że wartości overscanu nie mogą być ujemne ani większe niż połowa rozmiaru ekranu. Nie można zmienić nadmiernego skanowania na monitorze wewnętrznym.
-
obrót,
number opcjonalny
Jeśli jest ustawiona, aktualizuje obrót wyświetlacza. Prawidłowe wartości to [0, 90, 180, 270]. Obrót jest ustawiony w prawo względem pozycji w pionie wyświetlacza.
DisplayUnitInfo
Właściwości
-
activeStateChrome 117 lub nowsza
Aktywny, jeśli wyświetlacz jest wykrywany i używany przez system.
-
availableDisplayZoomFactors
number[]
Chrome 67 lub nowszaLista wartości współczynnika powiększenia, które można ustawić na wyświetlaczu.
-
granice
Logiczne granice wyświetlacza.
-
displayZoomFactor
liczba
Chrome 65 lub nowszaStosunek bieżącego powiększenia wyświetlacza do powiększenia domyślnego. Na przykład wartość 1 odpowiada powiększeniu o 100%, a 1, 5 – powiększeniu o 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 nowszaUWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS.
-
hasTouchSupport
wartość logiczna
Chrome 57 lub nowszaWartość Prawda, jeśli z tym wyświetlaczem jest powiązane urządzenie wejściowe dotykowe.
-
id
tekst
Unikalny identyfikator wyświetlacza.
-
isEnabled
wartość logiczna
Wartość True, jeśli ten wyświetlacz jest włączony.
-
isPrimary
wartość logiczna
Wartość True, jeśli jest to wyświetlacz główny.
-
isUnified
wartość logiczna
Chrome 59 lub nowszaDotyczy wszystkich wyświetlaczy w trybie ujednoliconego pulpitu. Więcej informacji znajdziesz w dokumentacji
enableUnifiedDesktop. -
mirroringDestinationIds
string[]
Chrome 64+Tylko w ChromeOS. Identyfikatory wyświetlaczy, na których dublowany jest wyświetlacz źródłowy. Puste, jeśli żaden wyświetlacz nie jest klonowany. W przypadku wszystkich wyświetlaczy będzie ona miała tę samą wartość. Nie może to obejmować
mirroringSourceId. -
mirroringSourceId
tekst
Tylko w ChromeOS. Identyfikator wyświetlacza, który jest klonowany, jeśli klonowanie jest włączone, w przeciwnym razie pusty. To ustawienie będzie obowiązywać na wszystkich wyświetlaczach (w tym na wyświetlaczu, który jest dublowany).
-
trybyChrome 52 lub nowsza
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 ustawiona jako pusta tablica.
-
nazwa
tekst
Przyjazna dla użytkownika nazwa (np. „Monitor LCD HP”).
-
nadmiarowość obrazu,
Wyświetlacz jest wstawiony w granice ekranu. Obecnie jest dostępna tylko w ChromeOS. Na innych platformach będzie ustawiona wartość pustych wstawień.
-
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 będzie ustawiona wartość 0. Wartość -1 będzie interpretowana jako autoobracanie, gdy urządzenie jest w fizycznym stanie tabletu.
-
workArea
Użyteczny obszar roboczy wyświetlacza w jego granicach. Obszar roboczy nie obejmuje obszarów wyświetlacza zarezerwowanych dla systemu operacyjnego, np. paska aplikacji i launchera.
Edid
Właściwości
-
manufacturerId
tekst
3-znakowy kod producenta. Zobacz sekcję 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, strona 22. Wymagane w wersji 1.4.
GetInfoFlags
Właściwości
-
singleUnified
wartość logiczna opcjonalna
Jeśli ta zasada ma wartość Prawda, funkcja
getInfow trybie ujednoliconego pulpitu zwraca tylko jeden elementDisplayUnitInfo(patrzenableUnifiedDesktop). 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ść osi X od lewej granicy.
-
w prawo
liczba
Odległość osi X od prawej granicy.
-
góra
liczba
Odległość od górnej granicy na osi Y.
LayoutPosition
Pozycja układu, czyli krawędź elementu nadrzędnego, do której przymocowany jest wyświetlacz.
Typ wyliczeniowy
„top”
„right”
„bottom”
„left”
MirrorMode
Tryb odbicia lustrzanego, czyli różne sposoby powielania obrazu z wyświetlacza na inne wyświetlacze.
Typ wyliczeniowy
„off”
Określa domyślny tryb (rozszerzony lub zunifikowany pulpit).
„normal”
Określa, że domyślny wyświetlacz źródłowy będzie dublowany na wszystkich innych wyświetlaczach.
„mixed”
Określa, że wyświetlacz źródłowy będzie dublowany na podanych wyświetlaczach docelowych. Wszystkie pozostałe podłączone wyświetlacze zostaną rozszerzone.
MirrorModeInfo
Właściwości
-
mirroringDestinationIds
string[] opcjonalnie
Wyświetlą się identyfikatory miejsca docelowego dublowania. Dotyczy to tylko wartości „mixed”.
-
mirroringSourceId
ciąg znaków opcjonalny
Identyfikator wyświetlacza źródłowego dublowania. Dotyczy to tylko wartości „mixed”.
-
tryb
Tryb odbicia lustrzanego, który ma zostać 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 dotyku odpowiadające punktowi wyświetlania.
TouchCalibrationPairQuad
Właściwości
-
pair1
Pierwsza para punktów dotyku i wyświetlania wymagana do kalibracji dotyku.
-
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
Czwarta para punktów dotyku i wyświetlania wymagana do kalibracji dotyku.
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 ją 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 będą używane do kalibracji ekranu dotykowego na potrzeby wyświetlania z wywołaniem id w funkcji startCustomTouchCalibration(). Zawsze wywołuj startCustomTouchCalibration przed wywołaniem tej metody. Jeśli trwa już inna kalibracja dotyku, ta funkcja zgłosi błąd.
Parametry
-
pary,
Pary punktów użyte do kalibracji wyświetlacza.
-
granice
Granice wyświetlacza w momencie przeprowadzania kalibracji dotyku. 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 i wyłącza funkcję ujednoliconego pulpitu. Jeśli ta opcja jest włączona, gdy aktywne jest odbicie lustrzane, tryb pulpitu nie zmieni się, dopóki odbicie lustrzane nie zostanie wyłączone. W przeciwnym razie tryb pulpitu natychmiast przełączy się na ujednolicony.
Parametry
-
aktywne
wartość logiczna
Wartość „true”, jeśli ma być włączony ujednolicony pulpit.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
): Promise<DisplayLayout[]>
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Żąda informacji o układzie wszystkich wyświetlaczy.
Parametry
-
callback
funkcja opcjonalna
Parametr
callbackwygląda tak:(layouts: DisplayLayout[]) => void
-
układy,
-
Zwroty
-
Promise<DisplayLayout[]>
Chrome 91 lub nowszyObietnica, która jest spełniana wraz z wynikami.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
): Promise<DisplayUnitInfo[]>
Wysyła prośbę o informacje o wszystkich podłączonych urządzeniach wyświetlających.
Parametry
-
flagi
GetInfoFlags opcjonalny
Chrome 59 lub nowszaOpcje wpływające na sposób zwracania informacji.
-
callback
funkcja opcjonalna
Parametr
callbackwygląda tak:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
Zwroty
-
Promise<DisplayUnitInfo[]>
Chrome 91 lub nowszyObietnica, która jest spełniana wraz z wynikami.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 wcięcia nadmiernego skanowania na wyświetlaczu. Zwykle powinno to przesuwać wyświetlacz wzdłuż osi (np. lewo i prawo mają tę samą wartość) lub skalować go wzdłuż osi (np. góra i dół mają przeciwne wartości). Każde wywołanie Adjust jest kumulatywne w stosunku do poprzednich wywołań od momentu rozpoczęcia.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
-
Delta
Wartość, o którą mają zostać zmienione wcięcia overscanu.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
UWAGA: ta opcja jest dostępna tylko w przypadku aplikacji kiosku w ChromeOS. Dokończ dostosowywanie nadmiernego skanowania 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. Przywraca ostatnio zapisaną wartość wstawki overscanu na wyświetlaczu (czyli wartość 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ę nadskanowania wyświetlacza. Na ekranie pojawi się nakładka wskazująca bieżące wcięcia nadmiernego skanowania. Jeśli kalibracja nadmiernego skanowania dla wyświetlacza id jest w toku, spowoduje to zresetowanie kalibracji.
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 dla wszystkich wyświetlaczy. W przypadku wyświetlaczy, które nie zostały uwzględnione, używany będzie układ domyślny. Jeśli układ nakłada się na inny lub jest nieprawidłowy z innych powodów, zostanie dostosowany do prawidłowego układu. Po rozwiązaniu problemu z układem zostanie wywołane zdarzenie onDisplayChanged.
Parametry
-
układy,
Informacje o układzie, wymagane w przypadku wszystkich wyświetlaczy z wyjątkiem wyświetlacza głównego.
-
callback
funkcja opcjonalna
Parametr
callbackwygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 91 lub nowszyObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 razie 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 parametrze
infozostanie podana jej nowa wartość. -
callback
funkcja opcjonalna
Parametr
callbackwygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 91 lub nowszyObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 połączenie resetuje stan z poprzednich połączeń. Wywołanie funkcji setDisplayProperties() nie powiedzie się w przypadku wyświetlaczy docelowych, które są kopiami lustrzanymi.
Parametry
-
informacje
Informacje o trybie dublowania, które powinny być zastosowane w trybie wyświetlania.
-
callback
funkcja opcjonalna
Parametr
callbackwygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 91 lub nowszyObietnica, która zostanie spełniona po zakończeniu działania funkcji.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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ć dalej. 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
funkcja opcjonalna
Parametr
callbackwygląda tak:(success: boolean) => void
-
sukces
wartość logiczna
-
Zwroty
-
Promise<boolean>
Chrome 91 lub nowszyObietnica, która informuje rozmówcę o zakończeniu kalibracji dotyku. Wartość logiczna informuje, czy kalibracja się powiodła.
Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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ę dotyku na wyświetlaczu. Tę funkcję należy wywołać, gdy do zbierania danych kalibracyjnych używasz niestandardowego interfejsu. Jeśli trwa już inna kalibracja dotyku, ta funkcja zgłosi błąd.
Parametry
-
id
tekst
Unikalny identyfikator wyświetlacza.
Wydarzenia
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Wywoływane, gdy w konfiguracji wyświetlacza nastąpią jakiekolwiek zmiany.
Parametry
-
callback
funkcja
Parametr
callbackwygląda tak:() => void