Deskripsi
Gunakan system.display
API untuk membuat kueri metadata tampilan.
Izin
system.display
Jenis
ActiveState
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
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
Posisi tata letak tampilan ini relatif terhadap induk. Tindakan ini akan diabaikan untuk root.
DisplayMode
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 baruTrue 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 baruKecepatan refresh mode tampilan dalam hertz.
-
uiScale
nomor opsional
Tidak digunakan lagi sejak Chrome 70Gunakan
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 danboundsOriginY
ditetapkan. Perhatikan bahwa saat mengupdate asal tampilan, beberapa batasan akan diterapkan, sehingga asal batas akhir mungkin berbeda dengan yang ditetapkan. Batas akhir dapat diambil menggunakangetInfo
. 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 baruJika 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 baruJika 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 68Gunakan
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
-
activeStateChrome 117 dan yang lebih baru
Aktif jika layar terdeteksi dan digunakan oleh sistem.
-
availableDisplayZoomFactors
angka[]
Chrome 67 dan yang lebih baruDaftar nilai faktor zoom yang dapat ditetapkan untuk tampilan.
-
batas
Batasan logis tampilan.
-
displayZoomFactor
angka
Chrome 65 dan yang lebih baruRasio 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 baruCATATAN: Ini hanya tersedia untuk aplikasi Kios Chrome OS dan UI Web.
-
hasTouchSupport
boolean
Chrome 57 dan yang lebih baruTrue 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 baruKhusus 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).
-
modesChrome 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 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
Area kerja tampilan yang dapat digunakan dalam batas tampilan. Area kerja mengecualikan area layar yang disiapkan untuk OS, misalnya taskbar dan peluncur.
Edid
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
Properti
-
singleUnified
boolean opsional
Jika disetel ke benar (true), hanya satu
DisplayUnitInfo
yang akan ditampilkan olehgetInfo
saat dalam mode desktop terpadu (lihatenableUnifiedDesktop
). 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
Posisi tata letak, yaitu tepi induk tempat layar dikaitkan.
Enum
MirrorMode
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
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
Mode cermin yang harus disetel.
Point
Properti
-
x
angka
Koordinat x dari titik.
-
y
angka
Koordinat y dari titik tersebut.
TouchCalibrationPair
Properti
-
displayPoint
Koordinat titik tampilan.
-
touchPoint
Koordinat titik sentuh yang sesuai dengan titik tampilan.
TouchCalibrationPairQuad
Properti
-
pair1
Pasangan titik sentuh dan tampilan pertama diperlukan untuk kalibrasi sentuh.
-
pair2
Pasangan titik sentuh dan tampilan kedua diperlukan untuk kalibrasi sentuh.
-
pair3
Pasangan ketiga titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.
-
pair4
Pasangan keempat titik sentuh dan tampilan diperlukan untuk kalibrasi sentuh.
Metode
clearTouchCalibration()
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.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
Pasangan titik yang digunakan untuk mengalibrasi layar.
-
batas
Batas layar saat kalibrasi sentuh dilakukan. Nilai
bounds.left
danbounds.top
diabaikan.
enableUnifiedDesktop()
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()
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
-
Hasil
-
Promise<DisplayLayout[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getInfo()
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
-
Hasil
-
Promise<DisplayUnitInfo[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
overscanCalibrationAdjust()
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
Jumlah yang akan mengubah inset overscan.
overscanCalibrationComplete()
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.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.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()
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
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 baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
setDisplayProperties()
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
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 baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
setMirrorMode()
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
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 baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
showNativeTouchCalibration()
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 baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
startCustomTouchCalibration()
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