chrome.system.display

Deskripsi

Gunakan system.display API untuk membuat kueri metadata yang ditampilkan.

Izin

system.display

Jenis

ActiveState

Chrome 117 dan yang lebih baru

Enum untuk memberi tahu 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 layar terputus.

Enum

"aktif"

"tidak aktif"

Bounds

Properti

• tinggi

  angka

  Tinggi tampilan dalam piksel.

• kiri

  angka

  Koordinat x dari sudut kiri atas.

• atas

  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 yang paling atas atau paling kiri disejajarkan.

• 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 atau yang lebih baru

Properti

• deviceScaleFactor

  angka

  Faktor skala perangkat mode tampilan.

• tinggi

  angka

  Tinggi mode tampilan dalam piksel yang tidak bergantung pada perangkat (dapat dilihat 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 modenya adalah mode native layar.

• isSelected

  boolean

  True jika mode tampilan saat ini dipilih.

• refreshRate

  angka

  Chrome 67 dan yang lebih baru

  Kecepatan refresh mode tampilan dalam hertz.

• uiScale

  angka opsional

  Tidak digunakan lagi sejak Chrome 70

  Gunakan displayZoomFactor

  Faktor penskalaan UI mode tampilan.

• lebar

  angka

  Lebar mode tampilan dalam piksel yang tidak bergantung pada perangkat (dapat dilihat pengguna).

• widthInNativePixels

  angka

  Lebar mode tampilan dalam piksel native.

DisplayProperties

Properti

• boundsOriginX

  angka opsional

  Jika disetel, asal batas logis tampilan akan diperbarui di sepanjang sumbu x. Diterapkan bersama dengan boundsOriginY. Setelan defaultnya adalah nilai saat ini jika tidak ditetapkan dan boundsOriginY akan ditetapkan. Perhatikan bahwa saat memperbarui asal tampilan, beberapa batasan akan diterapkan, sehingga asal batas akhir mungkin berbeda dari yang telah ditetapkan. Batas akhir dapat diambil menggunakan getInfo. Asal batas tidak dapat diubah di tampilan utama.

• boundsOriginY

  angka opsional

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

• displayMode

  DisplayMode opsional

  Chrome 52 atau yang lebih baru

  Jika ditetapkan, 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 tersebut tidak akan diterapkan dan error akan ditetapkan, tetapi properti lain akan tetap diterapkan.

• displayZoomFactor

  angka opsional

  Chrome 65 dan yang lebih baru

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

• Utama

  boolean opsional

  Jika disetel ke benar (true), tampilan akan menjadi tampilan utama. Tanpa pengoperasian 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 dan yang lebih baru

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

• mirroringSourceId

  string opsional

  Tidak digunakan lagi sejak Chrome 68

  Gunakan setMirrorMode.

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

• pemindaian berlebih

  Inset opsional

  Jika disetel, menyetel inset overscan tampilan ke nilai yang disediakan. Perhatikan bahwa nilai overscan tidak boleh negatif atau lebih besar dari setengah ukuran layar. Overscan tidak dapat diubah di monitor internal.

• rotasi

  angka opsional

  Jika disetel, rotasi tampilan akan diperbarui. Nilai hukum adalah [0, 90, 180, 270]. Rotasi disetel searah jarum jam, relatif terhadap 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

  Batas logis tampilan.

• displayZoomFactor

  angka

  Chrome 65 dan yang lebih baru

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

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

• hasTouchSupport

  boolean

  Chrome 57 dan yang lebih baru

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

• id

  string

  ID unik tampilan.

• isEnabled

  boolean

  True jika tampilan ini diaktifkan.

• Utama

  boolean

  True jika ini adalah tampilan utama.

• isUnified

  boolean

  Chrome 59 dan yang lebih baru

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

• mirroringDestinationIds

  {i>string<i}[]

  Chrome 64 dan yang lebih baru

  Khusus ChromeOS. ID tampilan tempat tampilan sumber dicerminkan. Kosong jika tidak ada layar yang dicerminkan. Ini akan ditetapkan ke nilai yang sama untuk semua layar. Informasi ini tidak boleh menyertakan mirroringSourceId.

• mirroringSourceId

  string

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

• moda

  DisplayMode[]

  Chrome 52 atau 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.

• nama

  string

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

• pemindaian berlebih

  Inset

  Inset tampilan 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 yang 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 tidak mencakup area tampilan yang disediakan untuk OS, misalnya taskbar dan peluncur.

Edid

Chrome 67 dan yang lebih baru

Properti

• manufacturerId

  string

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

• productId

  string

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

• yearOfManufacture

  angka

  Tahun produsen, Sec. 3.4.4 halaman 22. Wajib di v1.4.

GetInfoFlags

Chrome 59 dan yang lebih baru

Properti

• singleUnified

  boolean opsional

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

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

Posisi tata letak, yaitu tepi induk tempat layar terpasang.

Enum

"top"

"kanan"

"bottom"

"left"

MirrorMode

Chrome 65 dan yang lebih baru

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

Enum

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

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

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

MirrorModeInfo

Chrome 65 dan yang lebih baru

Properti

• mirroringDestinationIds

  string[] opsional

  ID tujuan pencerminan akan ditampilkan. Ini hanya berlaku untuk 'mixed'.

• mirroringSourceId

  string opsional

  ID tampilan sumber pencerminan. Ini hanya berlaku untuk 'mixed'.

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

TouchCalibrationPair

Chrome 57 dan yang lebih baru

Properti

• displayPoint

  Titik

  Koordinat titik tampilan.

• touchPoint

  Titik

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

• pair4

  TouchCalibrationPair

  Pasangan titik sentuh dan tampilan keempat 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 data kalibrasi sentuh apa pun 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,
)

Menetapkan pasangan kalibrasi sentuh untuk tampilan. pairs ini akan digunakan untuk mengkalibrasi layar sentuh dengan id yang dipanggil di startCustomTouchCalibration(). Selalu panggil startCustomTouchCalibration sebelum memanggil metode ini. Jika kalibrasi sentuh lainnya sedang berlangsung, error akan muncul.

Parameter

• pasangan

  TouchCalibrationPairQuad

  Pasangan titik yang digunakan untuk mengkalibrasi tampilan.

• batas

  Batas

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

enableUnifiedDesktop()

Chrome 46 dan yang lebih baru

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 segera beralih ke terpadu. CATATAN: Opsi ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.

Parameter

• diaktifkan

  boolean

  True jika desktop terpadu harus diaktifkan.

getDisplayLayout()

Janji Chrome 53 dan yang lebih baru

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

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

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (layouts: DisplayLayout[]) => void

  • tata letak

    DisplayLayout[]

Hasil

• Promise&lt;DisplayLayout[]&gt;

  Chrome 91 dan yang lebih baru

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

getInfo()

Janji

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

Meminta informasi untuk semua perangkat layar yang terpasang.

Parameter

• flags

  GetInfoFlags opsional

  Chrome 59 dan yang lebih baru

  Opsi yang memengaruhi cara informasi ditampilkan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

Hasil

• Promise&lt;DisplayUnitInfo[]&gt;

  Chrome 91 dan yang lebih baru

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

overscanCalibrationAdjust()

Chrome 53 dan yang lebih baru

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

Menyesuaikan inset overscan saat ini untuk tampilan. Biasanya ini harus memindahkan tampilan sepanjang sumbu (misalnya, kiri+kanan memiliki nilai yang sama) atau menskalakannya pada 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 dan yang lebih baru

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

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 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, kalibrasi ini akan direset.

Parameter

• id

  string

  ID unik layar.

setDisplayLayout()

Janji Chrome 53 dan yang lebih baru

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

Menyetel tata letak untuk semua tampilan. Semua tampilan yang tidak disertakan akan menggunakan tata letak default. Jika tata letak akan tumpang tindih atau tidak valid, tata letak tersebut akan disesuaikan dengan tata letak yang valid. Setelah tata letak diselesaikan, peristiwa onDisplayChanges akan dipicu. CATATAN: Opsi 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 ini:

  () => void

Hasil

• Janji<void>

  Chrome 91 dan yang lebih baru

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

setDisplayProperties()

Janji

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: Opsi 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 hanya akan diubah jika nilai baru untuknya ditentukan dalam info.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 91 dan yang lebih baru

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

setMirrorMode()

Janji Chrome 65 dan yang lebih baru

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

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

Parameter

• info

  MirrorModeInfo

  Informasi mode pencerminan yang harus diterapkan ke mode tampilan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 91 dan yang lebih baru

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

showNativeTouchCalibration()

Janji Chrome 57 dan yang lebih baru

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

Parameter

• id

  string

  ID unik layar.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (success: boolean) => void

  • berhasil

    boolean

Hasil

• Promise&lt;boolean&gt;

  Chrome 91 dan yang lebih baru

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

startCustomTouchCalibration()

Chrome 57 dan yang lebih baru

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

Memulai kalibrasi sentuh kustom untuk tampilan. Fungsi ini harus dipanggil saat menggunakan UX kustom untuk mengumpulkan data kalibrasi. Jika kalibrasi sentuh lainnya sedang berlangsung, error akan muncul.

Parameter

• id

  string

  ID unik layar.

Acara

onDisplayChanged

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

Diaktifkan jika ada perubahan pada konfigurasi tampilan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  () => void