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 diputus sambungannya, misalnya.

Enum

"active"

"tidak aktif"

Bounds

Properti

  • tinggi

    angka

    Tinggi layar dalam piksel.

  • kiri

    angka

    Koordinat x sudut 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 diratakan.

  • parentId

    string

    ID unik tampilan induk. Kosong jika ini adalah root.

  • position

    LayoutPosition

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

DisplayMode

Chrome 52+

Properti

  • deviceScaleFactor

    angka

    Faktor penskalaan perangkat mode tampilan.

  • tinggi

    angka

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

  • heightInNativePixels

    angka

    Tinggi mode tampilan dalam piksel asli.

  • isInterlaced

    boolean opsional

    Chrome 74+

    Benar jika mode ini interlaced, salah jika tidak disediakan.

  • isNative

    boolean

    Benar jika mode adalah mode native layar.

  • isSelected

    boolean

    Benar jika mode tampilan saat ini dipilih.

  • refreshRate

    angka

    Chrome 67+

    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 bergantung pada perangkat (terlihat oleh pengguna).

  • widthInNativePixels

    angka

    Lebar mode tampilan dalam piksel asli.

DisplayProperties

Properti

  • boundsOriginX

    nomor opsional

    Jika disetel, akan memperbarui asal batas logis layar di sepanjang sumbu x. Diterapkan bersama dengan boundsOriginY. Nilai 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 pada layar utama.

  • boundsOriginY

    nomor opsional

    Jika disetel, akan memperbarui asal batas logis tampilan 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 lain akan tetap diterapkan.

  • displayZoomFactor

    nomor opsional

    Chrome 65+

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

  • isPrimary

    boolean opsional

    Jika disetel ke benar (true), menjadikan layar utama. Tidak ada operasi jika disetel ke salah (false). Catatan: Jika ditetapkan, tampilan dianggap sebagai tampilan 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), mengubah mode tampilan ke desktop terpadu (lihat enableUnifiedDesktop untuk mengetahui detailnya). Jika disetel ke salah (false), mode desktop terpadu akan dinonaktifkan. Ini hanya valid untuk layar utama. Jika diberikan, mirroringSourceId tidak boleh diberikan dan properti lainnya akan diabaikan. Tidak berpengaruh jika tidak diberikan.

  • mirroringSourceId

    string opsional

    Tidak digunakan lagi sejak Chrome 68

    Gunakan setMirrorMode.

    Khusus ChromeOS. Jika disetel dan tidak kosong, mengaktifkan pencerminan hanya untuk tampilan ini. Jika tidak, pencerminan 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 disetel, akan menyetel 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 pada monitor internal.

  • rotasi

    nomor opsional

    Jika disetel, 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 Kios ChromeOS dan UI Web.

  • hasTouchSupport

    boolean

    Chrome 57+

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

  • id

    string

    ID unik layar.

  • isEnabled

    boolean

    Benar (True) jika layar 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 layar sumber diduplikasi. Kosong jika tidak ada layar yang di-mirror. Nilai ini akan ditetapkan ke nilai yang sama untuk semua tampilan. Ini tidak boleh mencakup mirroringSourceId.

  • mirroringSourceId

    string

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

  • mode

    DisplayMode[]

    Chrome 52+

    Daftar mode tampilan yang tersedia. Mode saat ini akan memiliki isSelected=true. Hanya tersedia di ChromeOS. Akan disetel 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 tersedia 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 tersedia di ChromeOS. Akan disetel ke 0 di platform lain. Nilai -1 akan ditafsirkan sebagai putar otomatis saat perangkat dalam status tablet fisik.

  • workArea

    Batas

    Area kerja yang dapat digunakan pada layar 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 halaman 21 di Bagian 3.4.1. Diperlukan di v1.4.

  • productId

    string

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

  • yearOfManufacture

    angka

    Tahun pembuatan, Sec. 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 layar terpasang.

Enum

"top"

"kanan"

"bottom"

"kiri"

MirrorMode

Chrome 65+

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

Enum

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

"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 terhubung lainnya akan diperluas.

MirrorModeInfo

Chrome 65+

Properti

  • mirroringDestinationIds

    string[] opsional

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

  • mirroringSourceId

    string opsional

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

  • mode

    MirrorMode

    Mode pencerminan yang harus disetel.

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

  • Pasangan titik sentuh dan tampilan pertama diperlukan untuk kalibrasi sentuh.

  • Titik sentuh dan tampilan kedua diperlukan untuk kalibrasi sentuh.

  • Titik sentuh dan tampilan ketiga diperlukan untuk kalibrasi sentuh.

  • Pasangan keempat titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.

Metode

clearTouchCalibration()

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

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

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

  • 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,
): void

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 Kios ChromeOS dan UI Web.

Parameter

  • diaktifkan

    boolean

    Benar jika desktop terpadu harus diaktifkan.

getDisplayLayout()

Chrome 53+ 
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

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

Hasil

getInfo()

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

Meminta informasi untuk semua perangkat layar yang terhubung.

Parameter

  • flags

    GetInfoFlags opsional

    Chrome 59+

    Opsi yang memengaruhi cara informasi ditampilkan.

Hasil

overscanCalibrationAdjust()

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

Menyesuaikan inset overscan saat ini untuk layar. Biasanya, ini akan menggerakkan 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

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

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

Parameter

  • id

    string

    ID unik layar.

overscanCalibrationStart()

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

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

Chrome 53+ 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

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

Parameter

  • tata letak

    DisplayLayout[]

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

Hasil

  • Promise<void>

    Chrome 91+

setDisplayProperties()

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

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 Kios ChromeOS dan UI Web.

Parameter

  • id

    string

    ID unik layar.

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

Hasil

  • Promise<void>

    Chrome 91+

setMirrorMode()

Chrome 65+ 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

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

Parameter

  • Informasi mode pencerminan yang harus diterapkan ke mode tampilan.

Hasil

  • Promise<void>

    Chrome 91+

showNativeTouchCalibration()

Chrome 57+ 
chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

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.

Hasil

  • Promise<boolean>

    Chrome 91+

startCustomTouchCalibration()

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

Memulai kalibrasi sentuhan kustom untuk layar. Metode 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