chrome.system.display

Deskripsi

Gunakan system.display API untuk membuat kueri metadata tampilan.

Izin

system.display

Jenis

ActiveState

Chrome 117 dan yang lebih baru

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

Enum

Bounds

Properti

• tinggi

  angka

  Tinggi tampilan dalam piksel.

• left

  angka

  Koordinat x dari sudut kiri atas.

• paruh pertama inning

  angka

  Koordinat y dari sudut kiri atas.

• lebar

  angka

  Lebar tampilan dalam piksel.

DisplayLayout

Chrome 53 dan yang lebih baru

Properti

• id

  string

  ID unik tampilan.

• offset

  angka

  Offset layar 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. Tindakan ini akan diabaikan untuk root.

DisplayMode

Chrome 52 dan yang lebih baru

Properti

• deviceScaleFactor

  angka

  Faktor skala perangkat mode tampilan.

• tinggi

  angka

  Tinggi mode tampilan dalam piksel yang tidak tergantung perangkat (terlihat pengguna).

• heightInNativePixels

  angka

  Tinggi mode tampilan dalam piksel native.

• isInterlaced

  boolean opsional

  Chrome 74 dan yang lebih baru

  True jika mode ini saling bertautan, false jika tidak diberikan.

• isNative

  boolean

  True jika mode adalah mode native tampilan.

• isSelected

  boolean

  True jika mode tampilan saat ini dipilih.

• refreshRate

  angka

  Chrome 67 dan yang lebih baru

  Kecepatan refresh mode tampilan dalam hertz.

• uiScale

  nomor opsional

  Tidak digunakan lagi sejak Chrome 70

  Gunakan displayZoomFactor

  Faktor skala UI mode tampilan.

• lebar

  angka

  Lebar mode tampilan dalam piksel yang tidak tergantung perangkat (terlihat pengguna).

• widthInNativePixels

  angka

  Lebar mode tampilan dalam piksel native.

DisplayProperties

Properti

• boundsOriginX

  nomor opsional

  Jika ditetapkan, akan mengupdate asal batas logis tampilan di sepanjang sumbu x. Diterapkan bersama dengan boundsOriginY. Jika tidak ditetapkan, setelan default-nya adalah nilai saat ini dan boundsOriginY ditetapkan. Perhatikan bahwa saat mengupdate 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 tampilan utama.

• boundsOriginY

  nomor opsional

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

• displayMode

  DisplayMode opsional

  Chrome 52 dan yang lebih baru

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

• displayZoomFactor

  nomor opsional

  Chrome 65 dan yang lebih baru

  Jika disetel, akan memperbarui zoom yang terkait dengan tampilan. Zoom ini melakukan penataan ulang dan penggambaran ulang sehingga menghasilkan zoom dengan kualitas yang lebih baik daripada hanya melakukan pembesaran regangan piksel demi piksel.

• isPrimary

  boolean opsional

  Jika disetel ke benar (true), tampilan akan diubah menjadi layar utama. Tanpa pengoperasian jika disetel ke salah (false). Catatan: Jika ditetapkan, tampilan akan dianggap utama untuk semua properti lain (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 menjadi desktop terpadu (lihat enableUnifiedDesktop untuk mengetahui detailnya). Jika disetel ke salah (false), mode desktop terpadu akan dinonaktifkan. Ini hanya valid untuk tampilan 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, aktifkan pencerminan hanya untuk tampilan ini. Jika tidak, akan menonaktifkan pencerminan untuk semua tampilan. Nilai ini harus menunjukkan ID tampilan sumber yang akan diduplikasi, yang tidak boleh sama dengan ID yang diteruskan ke setDisplayProperties. Jika ditetapkan, properti lain tidak dapat ditetapkan.

• pemindaian berlebihan

  Inset opsional

  Jika disetel, akan menyetel inset overscan pada layar ke nilai yang diberikan. Perhatikan bahwa nilai overscan tidak boleh negatif atau lebih besar dari setengah ukuran layar. Pemindaian berlebih tidak dapat diubah di monitor internal.

• rotasi

  nomor opsional

  Jika disetel, rotasi tampilan akan diperbarui. Nilai hukum adalah [0, 90, 180, 270]. Rotasi disetel searah jarum jam, sesuai dengan posisi vertikal layar.

DisplayUnitInfo

Properti

• activeState

  ActiveState

  Chrome 117 dan yang lebih baru

  Aktif jika layar terdeteksi dan digunakan oleh sistem.

• availableDisplayZoomFactors

  angka[]

  Chrome 67 dan yang lebih baru

  Daftar nilai faktor zoom yang dapat ditetapkan untuk tampilan.

• batas

  Batas

  Batasan logis tampilan.

• displayZoomFactor

  angka

  Chrome 65 dan yang lebih baru

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

• dpiX

  angka

  Jumlah {i>pixel<i} per inci di sepanjang sumbu x.

• dpiY

  angka

  Jumlah {i>pixel<i} per inci di sepanjang sumbu y.

• Eid

  Edid opsional

  Chrome 67 dan yang lebih baru

  CATATAN: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

• hasTouchSupport

  boolean

  Chrome 57 dan yang lebih baru

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

• id

  string

  ID unik tampilan.

• isEnabled

  boolean

  True jika tampilan ini diaktifkan.

• isPrimary

  boolean

  True jika layar ini adalah tampilan utama.

• isUnified

  boolean

  Chrome 59+

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

• mirroringDestinationIds

  string[]

  Chrome 64 dan yang lebih baru

  Khusus ChromeOS. ID tampilan yang tampilan sumbernya dicerminkan. Kosong jika tidak ada layar yang dicerminkan. Nilai ini akan ditetapkan ke nilai yang sama untuk semua tampilan. Data ini tidak boleh menyertakan mirroringSourceId.

• mirroringSourceId

  string

  Khusus ChromeOS. ID tampilan yang dicerminkan jika pencerminan diaktifkan, jika tidak, kosong. Ini akan disetel untuk semua layar (termasuk layar yang dicerminkan).

• modes

  DisplayMode[]

  Chrome 52 dan yang lebih baru

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

• name

  string

  Nama yang mudah digunakan (mis. "monitor LCD HP").

• pemindaian berlebihan

  Inset

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

• rotasi

  angka

  Rotasi layar searah jarum jam dalam derajat secara 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 layar yang disiapkan untuk OS, misalnya taskbar dan peluncur.

Edid

Chrome 67 dan yang lebih baru

Properti

• manufacturerId

  string

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

• productId

  string

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

• yearOfManufacture

  angka

  Tahun produksi, Bagian 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). Nilai defaultnya adalah salah (false).

Insets

Properti

• paruh kedua inning

  angka

  Jarak sumbu y dari batas bawah.

• left

  angka

  Jarak sumbu x dari batas kiri.

• right

  angka

  Jarak sumbu x dari batas kanan.

• paruh pertama inning

  angka

  Jarak sumbu y dari batas atas.

LayoutPosition

Chrome 53 dan yang lebih baru

Posisi tata letak, yaitu tepi induk tempat layar dikaitkan.

Enum

MirrorMode

Chrome 65 dan yang lebih baru

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

Enum

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

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

"mixed"
Menentukan bahwa tampilan sumber yang ditentukan akan dicerminkan ke layar tujuan yang disediakan. Semua layar lainnya yang terhubung akan diperluas.

MirrorModeInfo

Chrome 65 dan yang lebih baru

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 cermin yang harus disetel.

Point

Chrome 57 dan yang lebih baru

Properti

• x

  angka

  Koordinat x dari titik.

• y

  angka

  Koordinat y dari titik tersebut.

TouchCalibrationPair

Chrome 57 dan yang lebih baru

Properti

• displayPoint

  Poin

  Koordinat titik tampilan.

• touchPoint

  Poin

  Koordinat titik sentuh yang sesuai dengan titik tampilan.

TouchCalibrationPairQuad

Chrome 57 dan yang lebih baru

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 ketiga titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

• pair4

  TouchCalibrationPair

  Pasangan keempat titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

Metode

clearTouchCalibration()

Chrome 57 dan yang lebih baru

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

Mereset kalibrasi sentuh untuk layar dan mengembalikannya ke status default dengan menghapus semua data kalibrasi sentuh yang terkait dengan layar.

Parameter

• id

  string

  ID unik layar.

completeCustomTouchCalibration()

Chrome 57 dan yang lebih baru

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

Mengatur pasangan kalibrasi sentuh untuk tampilan. 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, error akan muncul.

Parameter

• pasangan

  TouchCalibrationPairQuad

  Pasangan titik yang digunakan untuk mengalibrasi layar.

• batas

  Batas

  Batas layar 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: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• diaktifkan

  boolean

  True jika desktop terpadu harus diaktifkan.

getDisplayLayout()

Promise Chrome 53+

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

Meminta info tata letak untuk semua tampilan. CATATAN: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (layouts: DisplayLayout[])=>void

  • tata letak

    DisplayLayout[]

Hasil

• Promise<DisplayLayout[]>

  Chrome 91 dan yang lebih baru

  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

• flag

  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 dan yang lebih baru

  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 dan yang lebih baru

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

Menyesuaikan inset pemindaian overscan saat ini untuk tampilan. Biasanya, tindakan ini akan memindahkan layar di sepanjang sumbu (misalnya kiri+kanan memiliki nilai yang sama) atau menskalakannya di sepanjang sumbu (mis. 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 yang akan mengubah inset overscan.

overscanCalibrationComplete()

Chrome 53 dan yang lebih baru

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

Selesaikan penyesuaian overscan untuk tampilan dengan menyimpan nilai saat ini dan menyembunyikan overlay.

Parameter

• id

  string

  ID unik layar.

overscanCalibrationReset()

Chrome 53 dan yang lebih baru

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

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

Parameter

• id

  string

  ID unik layar.

overscanCalibrationStart()

Chrome 53 dan yang lebih baru

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

Memulai kalibrasi pemindaian berlebih untuk tampilan. Tindakan ini akan menampilkan overlay di layar yang menunjukkan inset overscan saat ini. Jika kalibrasi overscan untuk tampilan id sedang berlangsung, hal ini akan mereset kalibrasi.

Parameter

• id

  string

  ID unik layar.

setDisplayLayout()

Promise Chrome 53+

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

Menyetel tata letak untuk semua tampilan. Setiap tampilan 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: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• tata letak

  DisplayLayout[]

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

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 91 dan yang lebih baru

  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, berdasarkan informasi yang diberikan di info. Jika gagal, runtime.lastError akan disetel. CATATAN: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• id

  string

  ID unik layar.

• info

  DisplayProperties

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

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 91 dan yang lebih baru

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

Menyetel mode tampilan ke mode cermin yang ditentukan. Setiap panggilan akan mereset status dari panggilan sebelumnya. Memanggil setDisplayProperties() akan gagal untuk tampilan tujuan pencerminan. CATATAN: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• info

  MirrorModeInfo

  Informasi mode cermin yang harus diterapkan ke mode tampilan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 91 dan yang lebih baru

  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 tampilan. Tindakan ini akan menampilkan overlay di layar dengan petunjuk yang diperlukan tentang cara melanjutkan. Callback akan dipanggil hanya jika kalibrasi berhasil. Jika kalibrasi gagal, pesan error akan muncul.

Parameter

• id

  string

  ID unik layar.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (success: boolean)=>void

  • berhasil

    boolean

Hasil

• Promise<boolean>

  Chrome 91 dan yang lebih baru

  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 dan yang lebih baru

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

Parameter

• id

  string

  ID unik layar.

Peristiwa

onDisplayChanged

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

Diaktifkan jika ada perubahan pada konfigurasi tampilan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  ()=>void