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

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

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

  • Pasangan ketiga titik sentuh dan layar diperlukan untuk kalibrasi sentuh.

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

Hasil

  • Promise<DisplayLayout[]>

    Chrome 91+

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

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

Hasil

  • Promise<DisplayUnitInfo[]>

    Chrome 91+

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

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

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.

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

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

  • Informasi mode mirror yang harus diterapkan ke mode tampilan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

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

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 hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan 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