chrome.system.display

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan system.display API untuk mengkueri metadata tampilan.

Izin

system.display

Jenis

ActiveState

Chrome 117+

Enum untuk mengetahui apakah layar terdeteksi dan digunakan oleh sistem. Layar dianggap 'tidak aktif' jika tidak terdeteksi oleh sistem (mungkin terputus, atau dianggap terputus karena mode tidur, dll.). Status ini digunakan untuk mempertahankan tampilan yang ada saat semua layar terputus, misalnya.

Enum

"active"

"inactive"

Bounds

Properti

• tinggi

  angka

  Tinggi layar dalam piksel.

• kiri

  angka

  Koordinat x dari pojok kiri atas.

• atas

  angka

  Koordinat y dari sudut kiri atas.

• lebar

  angka

  Lebar layar dalam piksel.

DisplayLayout

Chrome 53+

Properti

• id

  string

  ID unik layar.

• offset

  angka

  Offset layar di sepanjang tepi yang terhubung. 0 menunjukkan bahwa sudut paling atas atau paling kiri sejajar.

• parentId

  string

  ID unik layar induk. Kosong jika ini adalah root.

• position

  LayoutPosition

  Posisi tata letak layar ini relatif terhadap induk. Ini akan diabaikan untuk root.

DisplayMode

Chrome 52+

Properti

• deviceScaleFactor

  angka

  Faktor skala perangkat mode tampilan.

• tinggi

  angka

  Tinggi mode tampilan dalam piksel yang tidak bergantung pada perangkat (terlihat oleh pengguna).

• heightInNativePixels

  angka

  Tinggi mode tampilan dalam piksel native.

• isInterlaced

  boolean opsional

  Chrome 74+

  True jika mode ini interlaced, false jika tidak disediakan.

• isNative

  boolean

  True jika mode adalah mode native layar.

• isSelected

  boolean

  True jika mode tampilan saat ini dipilih.

• refreshRate

  angka

  Chrome 67+

  Kecepatan refresh mode tampilan dalam hertz.

• uiScale

  number opsional

  Tidak digunakan lagi sejak Chrome 70

  Gunakan displayZoomFactor

  Faktor skala UI mode tampilan.

• lebar

  angka

  Lebar mode tampilan dalam piksel yang tidak bergantung pada perangkat (terlihat oleh pengguna).

• widthInNativePixels

  angka

  Lebar mode tampilan dalam piksel native.

DisplayProperties

Properti

• boundsOriginX

  number opsional

  Jika ditetapkan, akan memperbarui asal batas logis layar di sepanjang sumbu x. Diterapkan bersama dengan boundsOriginY. Ditetapkan secara default ke nilai saat ini jika tidak ditetapkan dan boundsOriginY ditetapkan. Perhatikan bahwa saat memperbarui origin tampilan, beberapa batasan akan diterapkan, sehingga origin batas akhir mungkin berbeda dari yang ditetapkan. Batas akhir dapat diambil menggunakan getInfo. Asal batas tidak dapat diubah di layar utama.

• boundsOriginY

  number opsional

  Jika ditetapkan, memperbarui asal batas logis layar di sepanjang sumbu y. Lihat dokumentasi untuk parameter boundsOriginX.

• displayMode

  DisplayMode opsional

  Chrome 52+

  Jika ditetapkan, akan memperbarui mode tampilan ke mode yang cocok dengan nilai ini. Jika parameter lain tidak valid, parameter ini tidak akan diterapkan. Jika mode tampilan tidak valid, mode tersebut tidak akan diterapkan dan error akan ditetapkan, tetapi properti lainnya akan tetap diterapkan.

• displayZoomFactor

  number opsional

  Chrome 65+

  Jika disetel, akan memperbarui zoom yang terkait dengan layar. Zoom ini melakukan tata letak ulang dan pengecatan ulang sehingga menghasilkan zoom berkualitas lebih baik daripada sekadar melakukan pembesaran peregangan piksel demi piksel.

• isPrimary

  boolean opsional

  Jika disetel ke benar (true), layar akan menjadi layar utama. Tidak ada operasi jika disetel ke salah (false). Catatan: Jika ditetapkan, layar dianggap sebagai layar utama untuk semua properti lainnya (yaitu, isUnified dapat ditetapkan dan asal batas mungkin tidak).

• isUnified

  boolean opsional

  Chrome 59+

  Khusus ChromeOS. Jika disetel ke benar (true), mode tampilan akan diubah ke desktop terpadu (lihat enableUnifiedDesktop untuk mengetahui detailnya). Jika disetel ke salah (false), mode desktop terpadu akan dinonaktifkan. Hal ini hanya berlaku untuk layar utama. Jika diberikan, mirroringSourceId tidak boleh diberikan dan properti lainnya akan diabaikan. Hal ini tidak berpengaruh jika tidak diberikan.

• mirroringSourceId

  string opsional

  Tidak digunakan lagi sejak Chrome 68

  Gunakan setMirrorMode.

  Khusus ChromeOS. Jika disetel dan tidak kosong, kebijakan ini akan mengaktifkan pencerminan hanya untuk layar ini. Jika tidak, nonaktifkan pencerminan untuk semua layar. Nilai ini harus menunjukkan ID tampilan sumber yang akan diduplikasi, yang tidak boleh sama dengan ID yang diteruskan ke setDisplayProperties. Jika ditetapkan, tidak ada properti lain yang dapat ditetapkan.

• overscan

  Inset opsional

  Jika ditetapkan, setel inset overscan layar ke nilai yang diberikan. Perhatikan bahwa nilai overscan tidak boleh negatif atau lebih besar dari setengah ukuran layar. Overscan tidak dapat diubah di monitor internal.

• rotasi

  number opsional

  Jika disetel, akan memperbarui rotasi layar. Nilai yang sah adalah [0, 90, 180, 270]. Rotasi ditetapkan searah jarum jam, relatif terhadap posisi vertikal layar.

DisplayUnitInfo

Properti

• activeState

  ActiveState

  Chrome 117+

  Aktif jika layar terdeteksi dan digunakan oleh sistem.

• availableDisplayZoomFactors

  number[]

  Chrome 67+

  Daftar nilai faktor zoom yang dapat ditetapkan untuk layar.

• batas

  Batas

  Batas logis layar.

• displayZoomFactor

  angka

  Chrome 65+

  Rasio antara zoom layar saat ini dan default. Misalnya, nilai 1 setara dengan zoom 100%, dan nilai 1,5 setara dengan zoom 150%.

• dpiX

  angka

  Jumlah piksel per inci di sepanjang sumbu x.

• dpiY

  angka

  Jumlah piksel per inci di sepanjang sumbu y.

• edid

  Edid opsional

  Chrome 67+

  CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS.

• hasTouchSupport

  boolean

  Chrome 57+

  True jika layar ini memiliki perangkat input sentuh yang terkait dengannya.

• id

  string

  ID unik layar.

• isEnabled

  boolean

  True jika layar ini diaktifkan.

• isPrimary

  boolean

  True jika ini adalah layar utama.

• isUnified

  boolean

  Chrome 59+

  Benar untuk semua layar saat dalam mode desktop terpadu. Lihat dokumentasi untuk enableUnifiedDesktop.

• mirroringDestinationIds

  string[]

  Chrome 64+

  Khusus ChromeOS. ID layar yang menjadi tujuan pencerminan layar sumber. Kosong jika tidak ada layar yang diduplikasi. Nilai ini akan ditetapkan ke nilai yang sama untuk semua layar. Nilai ini tidak boleh menyertakan mirroringSourceId.

• mirroringSourceId

  string

  Khusus ChromeOS. ID layar yang diduplikasi jika pencerminan diaktifkan, jika tidak, kosong. Setelan ini akan ditetapkan untuk semua layar (termasuk layar yang dicerminkan).

• mode

  DisplayMode[]

  Chrome 52+

  Daftar mode tampilan yang tersedia. Mode saat ini akan memiliki isSelected=true. Hanya tersedia di ChromeOS. Akan ditetapkan ke array kosong di platform lain.

• nama

  string

  Nama yang mudah digunakan (misalnya, "Monitor LCD HP").

• overscan

  Inset

  Inset layar dalam batas layarnya. Saat ini hanya ditampilkan di ChromeOS. Akan ditetapkan ke inset kosong di platform lain.

• rotasi

  angka

  Rotasi searah jarum jam layar dalam derajat relatif terhadap posisi vertikal. Saat ini hanya ditampilkan di ChromeOS. Akan ditetapkan ke 0 di platform lain. Nilai -1 akan ditafsirkan sebagai putar otomatis saat perangkat dalam status tablet fisik.

• workArea

  Batas

  Area kerja layar yang dapat digunakan dalam batas layar. Area kerja tidak mencakup area layar yang dicadangkan untuk OS, misalnya taskbar dan peluncur.

Edid

Chrome 67+

Properti

• manufacturerId

  string

  Kode produsen 3 karakter. Lihat Bag. 3.4.1 halaman 21. Diperlukan di v1.4.

• productId

  string

  Kode yang ditetapkan produsen sebesar 2 byte, Bag. 3.4.2 halaman 21. Diperlukan di v1.4.

• yearOfManufacture

  angka

  Tahun pembuatan, Bag. 3.4.4 halaman 22. Diperlukan di v1.4.

GetInfoFlags

Chrome 59+

Properti

• singleUnified

  boolean opsional

  Jika disetel ke benar (true), hanya satu DisplayUnitInfo yang akan ditampilkan oleh getInfo saat dalam mode desktop terpadu (lihat enableUnifiedDesktop). Defaultnya adalah salah (false).

Insets

Properti

• bawah

  angka

  Jarak sumbu y dari batas bawah.

• kiri

  angka

  Jarak sumbu x dari batas kiri.

• kanan

  angka

  Jarak sumbu x dari batas kanan.

• atas

  angka

  Jarak sumbu y dari batas atas.

LayoutPosition

Chrome 53+

Posisi tata letak, yaitu tepi induk tempat tampilan dipasang.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65+

Mode pencerminan, yaitu berbagai cara untuk mencerminkan layar ke layar lain.

Enum

"off"
Menentukan mode default (desktop yang diperluas atau terpadu).

"normal"
Menentukan bahwa tampilan sumber default akan dicerminkan ke semua tampilan lainnya.

"mixed"
Menentukan bahwa layar sumber yang ditentukan akan diduplikasi ke layar tujuan yang disediakan. Semua layar lain yang terhubung akan diperluas.

MirrorModeInfo

Chrome 65+

Properti

• mirroringDestinationIds

  string[] opsional

  ID layar tujuan pencerminan. Ini hanya valid untuk 'mixed'.

• mirroringSourceId

  string opsional

  ID layar sumber pencerminan. Ini hanya valid untuk 'mixed'.

• mode

  MirrorMode

  Mode pencerminan yang harus ditetapkan.

Point

Chrome 57+

Properti

• x

  angka

  Koordinat x titik.

• y

  angka

  Koordinat y dari titik.

TouchCalibrationPair

Chrome 57+

Properti

• displayPoint

  Titik

  Koordinat titik tampilan.

• touchPoint

  Titik

  Koordinat titik sentuh yang sesuai dengan titik tampilan.

TouchCalibrationPairQuad

Chrome 57+

Properti

• pair1

  TouchCalibrationPair

  Pasangan titik sentuh dan tampilan pertama diperlukan untuk kalibrasi sentuh.

• pair2

  TouchCalibrationPair

  Pasangan titik sentuh dan tampilan kedua diperlukan untuk kalibrasi sentuh.

• pair3

  TouchCalibrationPair

  Pasangan titik sentuh dan tampilan ketiga diperlukan untuk kalibrasi sentuh.

• pair4

  TouchCalibrationPair

  Pasangan keempat titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

Metode

clearTouchCalibration()

Chrome 57+

chrome.system.display.clearTouchCalibration(
  id: string,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Mereset kalibrasi sentuh untuk layar dan mengembalikannya ke status default dengan menghapus data kalibrasi sentuh yang terkait dengan layar.

Parameter

• id

  string

  ID unik layar.

completeCustomTouchCalibration()

Chrome 57+

chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Menetapkan pasangan kalibrasi sentuh untuk layar. pairs ini akan digunakan untuk mengkalibrasi layar sentuh untuk tampilan dengan id yang dipanggil di startCustomTouchCalibration(). Selalu panggil startCustomTouchCalibration sebelum memanggil metode ini. Jika kalibrasi sentuh lain sedang berlangsung, tindakan ini akan menampilkan error.

Parameter

• pasang

  TouchCalibrationPairQuad

  Pasangan titik yang digunakan untuk mengkalibrasi layar.

• batas

  Batas

  Batas tampilan saat kalibrasi sentuh dilakukan. Nilai bounds.left dan bounds.top akan diabaikan.

enableUnifiedDesktop()

Chrome 46+

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Mengaktifkan/menonaktifkan fitur desktop terpadu. Jika diaktifkan saat pencerminan aktif, mode desktop tidak akan berubah hingga pencerminan dinonaktifkan. Jika tidak, mode desktop akan langsung beralih ke mode terpadu.

Parameter

• aktif

  boolean

  True jika desktop terpadu harus diaktifkan.

getDisplayLayout()

Promise Chrome 53+

chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Meminta info tata letak untuk semua layar.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (layouts: DisplayLayout[]) => void

  • tata letak

    DisplayLayout[]

Hasil

• Promise<DisplayLayout[]>

  Chrome 91+

  Promise yang di-resolve dengan hasilnya.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getInfo()

Promise

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

Meminta informasi untuk semua perangkat layar yang terpasang.

Parameter

• flags

  GetInfoFlags opsional

  Chrome 59+

  Opsi yang memengaruhi cara informasi ditampilkan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

Hasil

• Promise<DisplayUnitInfo[]>

  Chrome 91+

  Promise yang di-resolve dengan hasilnya.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

overscanCalibrationAdjust()

Chrome 53+

chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Menyesuaikan inset overscan saat ini untuk layar. Biasanya, tindakan ini akan memindahkan tampilan di sepanjang sumbu (misalnya, kiri+kanan memiliki nilai yang sama) atau menskalakannya di sepanjang sumbu (misalnya, atas+bawah memiliki nilai yang berlawanan). Setiap panggilan Adjust bersifat kumulatif dengan panggilan sebelumnya sejak Start.

Parameter

• id

  string

  ID unik layar.

• Delta

  Inset

  Jumlah untuk mengubah inset overscan.

overscanCalibrationComplete()

Chrome 53+

chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Selesaikan penyesuaian overscan untuk layar dengan menyimpan nilai saat ini dan menyembunyikan overlay.

Parameter

• id

  string

  ID unik layar.

overscanCalibrationReset()

Chrome 53+

chrome.system.display.overscanCalibrationReset(
  id: string,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Mereset inset overscan untuk layar ke nilai terakhir yang disimpan (yaitu sebelum Start dipanggil).

Parameter

• id

  string

  ID unik layar.

overscanCalibrationStart()

Chrome 53+

chrome.system.display.overscanCalibrationStart(
  id: string,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Memulai kalibrasi overscan untuk layar. Tindakan ini akan menampilkan overlay di layar yang menunjukkan inset overscan saat ini. Jika kalibrasi overscan untuk layar id sedang berlangsung, tindakan ini akan mereset kalibrasi.

Parameter

• id

  string

  ID unik layar.

setDisplayLayout()

Promise Chrome 53+

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Menetapkan tata letak untuk semua layar. Layar yang tidak disertakan akan menggunakan tata letak default. Jika tata letak tumpang-tindih atau tidak valid, tata letak tersebut akan disesuaikan menjadi tata letak yang valid. Setelah tata letak diselesaikan, peristiwa onDisplayChanged akan dipicu.

Parameter

• tata letak

  DisplayLayout[]

  Informasi tata letak, yang diperlukan untuk semua layar kecuali layar utama.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise yang di-resolve saat fungsi selesai.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setDisplayProperties()

Promise

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Memperbarui properti untuk layar yang ditentukan oleh id, sesuai dengan informasi yang diberikan di info. Jika gagal, runtime.lastError akan ditetapkan.

Parameter

• id

  string

  ID unik layar.

• info

  DisplayProperties

  Informasi tentang properti tampilan yang harus diubah. Properti hanya akan diubah jika nilai baru untuk properti tersebut ditentukan di info.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise yang di-resolve saat fungsi selesai.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setMirrorMode()

Promise Chrome 65+

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Menetapkan mode tampilan ke mode pencerminan yang ditentukan. Setiap panggilan akan mereset status dari panggilan sebelumnya. Memanggil setDisplayProperties() akan gagal untuk layar tujuan pencerminan.

Parameter

• info

  MirrorModeInfo

  Informasi mode pencerminan yang harus diterapkan ke mode tampilan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise yang di-resolve saat fungsi selesai.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

showNativeTouchCalibration()

Promise Chrome 57+

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Menampilkan UX kalibrasi sentuh native untuk layar dengan id sebagai ID layar. Tindakan ini akan menampilkan overlay di layar dengan petunjuk yang diperlukan tentang cara melanjutkan. Callback hanya akan dipanggil jika kalibrasi berhasil. Jika kalibrasi gagal, tindakan ini akan menampilkan error.

Parameter

• id

  string

  ID unik layar.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (success: boolean) => void

  • berhasil

    boolean

Hasil

• Promise<boolean>

  Chrome 91+

  Promise yang di-resolve untuk memberi tahu pemanggil bahwa kalibrasi sentuh telah berakhir. Nilai boolean menginformasikan apakah kalibrasi berhasil atau tidak.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

startCustomTouchCalibration()

Chrome 57+

chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

CATATAN: Fitur ini hanya tersedia untuk aplikasi Kios ChromeOS. Memulai kalibrasi sentuh kustom untuk layar. Ini harus dipanggil saat menggunakan UX kustom untuk mengumpulkan data kalibrasi. Jika kalibrasi sentuh lain sedang berlangsung, tindakan ini akan menampilkan error.

Parameter

• id

  string

  ID unik layar.

Acara

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Diaktifkan saat ada perubahan pada konfigurasi tampilan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  () => void