chrome.system.display

Deskripsi

Gunakan system.display API untuk membuat kueri 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 tampilan terputus, misalnya.

Enum

"active"

"nonaktif"

Bounds

Properti

• tinggi

  angka

  Tinggi layar dalam piksel.

• kiri

  angka

  Koordinat x 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 tampilan di sepanjang tepi yang terhubung. 0 menunjukkan bahwa sudut paling atas atau paling kiri sejajar.

• parentId

  string

  ID unik tampilan induk. Kosong jika ini adalah root.

• position

  LayoutPosition

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

DisplayMode

Chrome 52+

Properti

• deviceScaleFactor

  angka

  Faktor penskalaan perangkat mode tampilan.

• tinggi

  angka

  Tinggi mode tampilan dalam piksel independen perangkat (terlihat pengguna).

• heightInNativePixels

  angka

  Tinggi mode tampilan dalam piksel native.

• isInterlaced

  boolean opsional

  Chrome 74+

  Benar jika mode ini interlaced, salah jika tidak diberikan.

• isNative

  boolean

  Benar jika mode adalah mode native tampilan.

• isSelected

  boolean

  Benar 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 tampilan di sepanjang sumbu x. Diterapkan bersama dengan boundsOriginY. Setelan defaultnya adalah nilai saat ini jika tidak ditetapkan dan boundsOriginY ditetapkan. Perhatikan bahwa saat memperbarui asal tampilan, beberapa batasan akan diterapkan, sehingga asal batas akhir mungkin berbeda dengan yang ditetapkan. Batas akhir dapat diambil menggunakan getInfo. Asal batas tidak dapat diubah di layar utama.

• boundsOriginY

  number opsional

  Jika ditetapkan, akan memperbarui asal batas logika tampilan di sepanjang sumbu y. Lihat dokumentasi untuk parameter boundsOriginX.

• displayMode

  DisplayMode opsional

  Chrome 52+

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

• displayZoomFactor

  number opsional

  Chrome 65+

  Jika ditetapkan, akan memperbarui zoom yang terkait dengan tampilan. Zoom ini melakukan tata letak ulang dan pengecatan ulang sehingga menghasilkan zoom berkualitas lebih baik daripada hanya melakukan perbesaran regangan piksel demi piksel.

• isPrimary

  boolean opsional

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

• isUnified

  boolean opsional

  Chrome 59+

  Khusus ChromeOS. Jika disetel ke benar (true), mode tampilan akan diubah menjadi desktop terpadu (lihat enableUnifiedDesktop untuk mengetahui detailnya). Jika disetel ke salah (false), mode desktop terpadu akan dinonaktifkan. 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 ditetapkan dan tidak kosong, akan mengaktifkan pencerminan hanya untuk layar ini. Jika tidak, duplikasi akan dinonaktifkan untuk semua layar. Nilai ini harus menunjukkan ID tampilan sumber yang akan dicerminkan, yang tidak boleh sama dengan ID yang diteruskan ke setDisplayProperties. Jika ditetapkan, tidak ada properti lain yang dapat ditetapkan.

• overscan

  Inset opsional

  Jika ditetapkan, akan menetapkan 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 ditetapkan, akan memperbarui rotasi layar. Nilai yang valid 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 tampilan.

• batas

  Batas

  Batas logis tampilan.

• displayZoomFactor

  angka

  Chrome 65+

  Rasio antara zoom saat ini dan default layar. 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 Kiosk ChromeOS dan UI Web.

• hasTouchSupport

  boolean

  Chrome 57+

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

• id

  string

  ID unik layar.

• isEnabled

  boolean

  True jika tampilan ini diaktifkan.

• isPrimary

  boolean

  Benar 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 tempat tampilan sumber diduplikasi. Kosong jika tidak ada tampilan yang dicerminkan. Nilai ini akan ditetapkan ke nilai yang sama untuk semua layar. Ini tidak boleh menyertakan mirroringSourceId.

• mirroringSourceId

  string

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

• 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 tampilan dalam batas layarnya. Saat ini hanya ditampilkan di ChromeOS. Akan disetel 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 tampilan yang dapat digunakan dalam batas tampilan. Area kerja mengecualikan area tampilan yang dicadangkan untuk OS, misalnya taskbar dan peluncur.

Edid

Chrome 67+

Properti

• manufacturerId

  string

  Kode produsen 3 karakter. Lihat Bagian 3.4.1 halaman 21. Wajib di v1.4.

• productId

  string

  Kode 2 byte yang ditetapkan produsen, Bagian 3.4.2 halaman 21. Wajib di v1.4.

• yearOfManufacture

  angka

  Tahun produsen, Pasal 3.4.4 halaman 22. Wajib 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). Secara default, nilainya 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 dilampirkan.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65+

Mode pencerminan, yaitu berbagai cara tampilan dicerminkan ke layar lain.

Enum

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

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

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

MirrorModeInfo

Chrome 65+

Properti

• mirroringDestinationIds

  string[] opsional

  ID tujuan pencerminan akan ditampilkan. Ini hanya valid untuk 'campuran'.

• mirroringSourceId

  string opsional

  ID tampilan sumber pencerminan. Ini hanya valid untuk 'campuran'.

• mode

  MirrorMode

  Mode pencerminan yang harus ditetapkan.

Point

Chrome 57+

Properti

• x

  angka

  Koordinat x titik.

• y

  angka

  Koordinat y titik.

TouchCalibrationPair

Chrome 57+

Properti

• displayPoint

  Point

  Koordinat titik tampilan.

• touchPoint

  Point

  Koordinat titik sentuh yang sesuai dengan titik tampilan.

TouchCalibrationPairQuad

Chrome 57+

Properti

• pair1

  TouchCalibrationPair

  Pasangan pertama titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

• pair2

  TouchCalibrationPair

  Pasangan kedua titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

• pair3

  TouchCalibrationPair

  Pasangan ketiga titik sentuh dan layar 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,
)

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,
)

Menetapkan pasangan kalibrasi sentuh untuk layar. pairs ini akan digunakan untuk mengkalibrasi layar sentuh untuk ditampilkan 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

• pasangan

  TouchCalibrationPairQuad

  Pasangan titik yang digunakan untuk mengkalibrasi layar.

• batas

  Batas

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

enableUnifiedDesktop()

Chrome 46+

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

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. CATATAN: Fitur ini hanya tersedia untuk aplikasi Kiosk ChromeOS dan UI Web.

Parameter

• diaktifkan

  boolean

  Benar jika desktop terpadu harus diaktifkan.

getDisplayLayout()

Promise Chrome 53+

chrome.system.display.getDisplayLayout(
  callback?: function,
)

Meminta info tata letak untuk semua layar. CATATAN: Fitur ini hanya tersedia untuk aplikasi Kiosk ChromeOS dan UI Web.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (layouts: DisplayLayout[]) => void

  • layouts

    DisplayLayout[]

Hasil

• Promise<DisplayLayout[]>

  Chrome 91+

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getInfo()

Promise

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

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 didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

overscanCalibrationAdjust()

Chrome 53+

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

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 Mulai.

Parameter

• id

  string

  ID unik layar.

• Delta

  Inset

  Jumlah untuk mengubah inset overscan.

overscanCalibrationComplete()

Chrome 53+

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

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,
)

Mereset inset overscan untuk tampilan ke nilai terakhir yang disimpan (yaitu sebelum Start dipanggil).

Parameter

• id

  string

  ID unik layar.

overscanCalibrationStart()

Chrome 53+

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

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,
)

Menetapkan tata letak untuk semua layar. Tampilan apa pun yang tidak disertakan akan menggunakan tata letak default. Jika tata letak akan tumpang-tindih atau tidak valid, tata letak akan disesuaikan dengan tata letak yang valid. Setelah tata letak diselesaikan, peristiwa onDisplayChanged akan dipicu. CATATAN: Fitur ini hanya tersedia untuk aplikasi Kiosk ChromeOS dan UI Web.

Parameter

• layouts

  DisplayLayout[]

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

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setDisplayProperties()

Promise

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

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

Parameter

• id

  string

  ID unik layar.

• info

  DisplayProperties

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

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setMirrorMode()

Promise Chrome 65+

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

Parameter

• info

  MirrorModeInfo

  Informasi mode mirror yang harus diterapkan ke mode tampilan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 91+

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

showNativeTouchCalibration()

Promise Chrome 57+

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

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, error akan ditampilkan.

Parameter

• id

  string

  ID unik layar.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (success: boolean) => void

  • berhasil

    boolean

Hasil

• Promise<boolean>

  Chrome 91+

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

startCustomTouchCalibration()

Chrome 57+

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

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