คำอธิบาย
ใช้ system.display
API เพื่อค้นหาข้อมูลเมตาที่แสดงผล
สิทธิ์
system.display
ประเภท
ActiveState
enum ที่จะบอกว่าระบบตรวจพบและใช้งานจอแสดงผลหรือไม่ จอแสดงผลจะถือว่า "ไม่มีการใช้งาน" หากระบบตรวจไม่พบ (อาจยกเลิกการเชื่อมต่อหรือถือว่าไม่ได้เชื่อมต่อเนื่องจากสลีปโหมด ฯลฯ) เช่น สถานะนี้ใช้เพื่อเก็บจอแสดงผลที่มีอยู่ไว้เมื่อจอแสดงผลทั้งหมดไม่ได้เชื่อมต่อ
ค่าแจกแจง
Bounds
พร็อพเพอร์ตี้
-
ส่วนสูง
ตัวเลข
ความสูงของหน้าจอในหน่วยพิกเซล
-
ฝั่งซ้าย
ตัวเลข
พิกัด x ของมุมบนซ้าย
-
ครึ่งแรกของอินนิ่ง
ตัวเลข
พิกัด y ของมุมบนซ้าย
-
ความกว้าง
ตัวเลข
ความกว้างของการแสดงผลเป็นพิกเซล
DisplayLayout
พร็อพเพอร์ตี้
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
-
ออฟเซ็ต
ตัวเลข
ค่าออฟเซ็ตของการแสดงผลตามขอบที่เชื่อมต่อกัน 0 หมายความว่ามุมบนสุดหรือซ้ายสุดอยู่ในแนวเดียวกัน
-
parentId
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผลหลัก เว้นว่างไว้หากนี่คือรูท
-
position
ตำแหน่งเลย์เอาต์ของจอแสดงผลนี้สัมพัทธ์กับระดับบนสุด ระบบจะไม่สนใจการดำเนินการนี้สำหรับรูท
DisplayMode
พร็อพเพอร์ตี้
-
deviceScaleFactor
ตัวเลข
ปัจจัยที่มีผลต่อขนาดของอุปกรณ์ในโหมดการแสดงผล
-
ส่วนสูง
ตัวเลข
ความสูงของโหมดการแสดงผลในพิกเซลอิสระของอุปกรณ์ (ที่ผู้ใช้เห็น)
-
heightInNativePixels
ตัวเลข
ความสูงของโหมดการแสดงผลในหน่วยพิกเซลดั้งเดิม
-
isInterlaced
บูลีน ไม่บังคับ
Chrome เวอร์ชัน 74 ขึ้นไปจริง หากโหมดนี้เป็นแบบอินเทอร์เลซ จะเป็น "เท็จ" หากไม่ได้ระบุไว้
-
isNative
boolean
เป็นจริงหากโหมดดังกล่าวเป็นโหมดดั้งเดิมของจอแสดงผล
-
isSelected
boolean
เป็นจริงหากเลือกโหมดการแสดงผลอยู่
-
refreshRate
ตัวเลข
Chrome เวอร์ชัน 67 ขึ้นไปอัตราการรีเฟรชโหมดการแสดงผลเป็นเฮิรตซ์
-
uiScale
ตัวเลข ไม่บังคับ
เลิกใช้งานตั้งแต่ Chrome 70 เป็นต้นไปใช้
displayZoomFactor
ปัจจัยที่มีผลต่อขนาด UI ของโหมดการแสดงผล
-
ความกว้าง
ตัวเลข
ความกว้างของโหมดการแสดงผลในหน่วยพิกเซลอิสระ (ที่ผู้ใช้เห็นได้) ในอุปกรณ์
-
widthInNativePixels
ตัวเลข
ความกว้างของโหมดการแสดงผลในหน่วยพิกเซลดั้งเดิม
DisplayProperties
พร็อพเพอร์ตี้
-
boundsOriginX
ตัวเลข ไม่บังคับ
หากตั้งค่าไว้ ให้อัปเดตต้นทางขอบเขตเชิงตรรกะของจอแสดงผลตามแกน X ใช้ร่วมกับ
boundsOriginY
ค่าเริ่มต้นเป็นค่าปัจจุบันหากไม่ได้กำหนดและตั้งค่าboundsOriginY
ไว้ โปรดทราบว่าเมื่ออัปเดตต้นทางการแสดงผล จะมีการนำข้อจำกัดบางอย่างไปใช้ ดังนั้นต้นทางขอบเขตสุดท้ายอาจแตกต่างจากชุดแรก คุณสามารถเรียกดูขอบเขตสุดท้ายได้โดยใช้getInfo
ไม่สามารถเปลี่ยนต้นทางของขอบเขตในจอแสดงผลหลักได้ -
boundsOriginY
ตัวเลข ไม่บังคับ
หากตั้งค่าไว้ ให้อัปเดตต้นทางของขอบเขตเชิงตรรกะของจอแสดงผลตามแกน Y ดูเอกสารประกอบเกี่ยวกับพารามิเตอร์
boundsOriginX
-
displayMode
DisplayMode ไม่บังคับ
Chrome 52 ขึ้นไปหากตั้งค่าไว้ ให้อัปเดตโหมดการแสดงผลเป็นโหมดที่ตรงกับค่านี้ หากพารามิเตอร์อื่นๆ ไม่ถูกต้อง ระบบจะไม่นำพารามิเตอร์นี้ไปใช้ หากโหมดการแสดงผลไม่ถูกต้อง ระบบจะไม่นำโหมดนี้ไปใช้และระบบจะตั้งค่าให้เกิดข้อผิดพลาด แต่จะยังคงนำพร็อพเพอร์ตี้อื่นๆ ไปใช้
-
displayZoomFactor
ตัวเลข ไม่บังคับ
Chrome 65 ขึ้นไปหากตั้งค่าไว้ ให้อัปเดตการซูมที่เกี่ยวข้องกับจอแสดงผล การซูมนี้จะทำการจัดเรียงและวาดใหม่ จึงทำให้ได้มีคุณภาพดีกว่าการซูมแบบพิกเซลต่อขยายเป็นพิกเซล
-
isPrimary
บูลีน ไม่บังคับ
หากตั้งค่าเป็น "จริง" กำหนดให้จอแสดงผลหลัก ไม่ดำเนินการหากตั้งค่าเป็น "เท็จ" หมายเหตุ: หากตั้งค่าแล้ว ระบบจะถือว่าการแสดงนั้นเป็นพร็อพเพอร์ตี้หลักสำหรับพร็อพเพอร์ตี้อื่นๆ ทั้งหมด (เช่น อาจมีการตั้งค่า
isUnified
และต้นทางของขอบเขตอาจไม่) -
isUnified
บูลีน ไม่บังคับ
Chrome 59 ขึ้นไปChrome OS เท่านั้น หากตั้งค่าเป็น "จริง" ให้เปลี่ยนโหมดการแสดงผลเป็นเดสก์ท็อปแบบรวม (ดูรายละเอียดที่หัวข้อ
enableUnifiedDesktop
) หากตั้งค่าเป็น "เท็จ" ระบบจะปิดใช้โหมดเดสก์ท็อปแบบรวม ใช้ได้กับจอแสดงผลหลักเท่านั้น หากระบุ ต้องไม่ระบุ mirroringSourceId และระบบจะไม่สนใจพร็อพเพอร์ตี้อื่นๆ ซึ่งจะไม่มีผลหากไม่ได้ระบุ -
mirroringSourceId
string ไม่บังคับ
เลิกใช้งานตั้งแต่ Chrome 68ใช้
setMirrorMode
Chrome OS เท่านั้น หากตั้งค่าไว้และต้องไม่ว่างเปล่า จะเป็นการเปิดใช้การมิเรอร์สำหรับจอแสดงผลนี้เท่านั้น มิเช่นนั้นจะปิดการมิเรอร์สำหรับจอแสดงผลทั้งหมด ค่านี้ควรระบุรหัสของจอแสดงผลต้นทางที่จะมิเรอร์ ซึ่งต้องไม่เหมือนกับรหัสที่ส่งไปยัง setDisplayProperties หากตั้งค่าแล้ว ระบบจะไม่ตั้งค่าพร็อพเพอร์ตี้อื่นๆ อีก
-
โอเวอร์สแกน
Insets ไม่บังคับ
หากตั้งค่าไว้ ให้ตั้งค่าโอเวอร์สแกนของจอแสดงผลเป็นค่าที่ระบุ โปรดทราบว่าค่าโอเวอร์สแกนต้องไม่เป็นค่าลบหรือใหญ่กว่าขนาดของหน้าจอครึ่งหนึ่ง ไม่สามารถเปลี่ยนโอเวอร์สแกนบนจอภาพภายในได้
-
การหมุน
ตัวเลข ไม่บังคับ
หากตั้งค่าไว้ ให้อัปเดตการหมุนจอแสดงผล ค่าทางกฎหมายคือ [0, 90, 180, 270] มีการตั้งค่าการหมุนตามเข็มนาฬิกาโดยสัมพันธ์กับตำแหน่งแนวตั้งของจอแสดงผล
DisplayUnitInfo
พร็อพเพอร์ตี้
-
activeStateChrome 117 ขึ้นไป
ทำงานอยู่ถ้าระบบตรวจพบและใช้งานจอแสดงผล
-
availableDisplayZoomFactors
ตัวเลข[]
Chrome เวอร์ชัน 67 ขึ้นไปรายการค่าปัจจัยการซูมที่ตั้งได้สำหรับการแสดงผล
-
ขอบเขต
ขอบเขตเชิงตรรกะของจอแสดงผล
-
displayZoomFactor
ตัวเลข
Chrome 65 ขึ้นไปอัตราส่วนระหว่างการซูมปัจจุบันและการซูมเริ่มต้นของจอแสดงผล เช่น ค่า 1 เท่ากับการซูม 100% และค่า 1.5 เท่ากับการซูม 150%
-
dpiX
ตัวเลข
จำนวนพิกเซลต่อนิ้วตามแกน x
-
dpiY
ตัวเลข
จำนวนพิกเซลต่อนิ้วตามแกน y
-
Edid
Edid ไม่บังคับ
Chrome เวอร์ชัน 67 ขึ้นไปหมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
-
hasTouchSupport
boolean
Chrome 57 ขึ้นไปจริง หากจอแสดงผลนี้มีอุปกรณ์ป้อนข้อมูลด้วยการสัมผัสเชื่อมโยงอยู่
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
-
isEnabled
boolean
เป็นจริงหากเปิดใช้จอแสดงผลนี้
-
isPrimary
boolean
เป็นจริงหากเป็นจอแสดงผลหลัก
-
isUnified
boolean
Chrome 59 ขึ้นไป"จริง" สำหรับจอแสดงผลทั้งหมดเมื่ออยู่ในโหมดเดสก์ท็อปแบบรวมหลายหน้าจอ ดูเอกสารประกอบสำหรับ
enableUnifiedDesktop
-
mirroringDestinationIds
สตริง[]
Chrome 64 ขึ้นไปChrome OS เท่านั้น ตัวระบุของจอแสดงผลที่กำลังมิเรอร์จอแสดงผลต้นทาง ว่างเปล่าหากไม่มีหน้าจอที่มิเรอร์ ค่านี้จะตั้งเป็นค่าเดียวกันสำหรับจอแสดงผลทั้งหมด โดยต้องไม่มี
mirroringSourceId
-
mirroringSourceId
string
Chrome OS เท่านั้น ตัวระบุของจอแสดงผลที่กำลังมิเรอร์หากเปิดใช้การมิเรอร์ไว้ ไม่เช่นนั้นจะว่างเปล่า ระบบจะตั้งค่านี้สำหรับจอแสดงผลทั้งหมด (รวมถึงจอแสดงผลที่กำลังมิเรอร์)
-
modesChrome 52 ขึ้นไป
รายการโหมดการแสดงผลที่ใช้ได้ โหมดปัจจุบันจะมี isSelected=true ใช้ได้ใน Chrome OS เท่านั้น จะตั้งค่าเป็นอาร์เรย์ว่างในแพลตฟอร์มอื่นๆ
-
ชื่อ
string
ชื่อที่เข้าใจง่าย (เช่น "จอ LCD HP")
-
โอเวอร์สแกน
การแสดงผลภายในขอบเขตของจอแสดงผล ขณะนี้ใช้ได้ใน ChromeOS เท่านั้น จะตั้งค่าเป็นส่วนแทรกที่ว่างเปล่าในแพลตฟอร์มอื่นๆ
-
การหมุน
ตัวเลข
การหมุนตามเข็มนาฬิกาของจอแสดงผลเป็นองศาที่สัมพันธ์กับตำแหน่งแนวตั้ง ขณะนี้ใช้ได้ใน ChromeOS เท่านั้น จะตั้งค่าเป็น 0 ในแพลตฟอร์มอื่นๆ ระบบจะตีความค่า -1 เป็นการหมุนอัตโนมัติเมื่ออุปกรณ์อยู่ในสถานะแท็บเล็ตจริง
-
workArea
พื้นที่ทำงานที่ใช้งานได้ของการแสดงผลภายในขอบเขตการแสดงผล พื้นที่ทำงานจะไม่รวมพื้นที่แสดงผลที่สงวนไว้สำหรับระบบปฏิบัติการ เช่น แถบงานและ Launcher
Edid
พร็อพเพอร์ตี้
-
manufacturerId
string
รหัสผู้ผลิต 3 อักขระ ดูข้อ 3.4.1 หน้า 21 ต้องระบุใน v1.4
-
productId
string
รหัสที่ผู้ผลิตกำหนดแบบ 2 ไบต์ หน้า 21 วินาที 3.4.2 ต้องระบุใน v1.4
-
yearOfManufacture
ตัวเลข
ปีของผู้ผลิต วินาที 3.4.4 หน้า 22 ต้องระบุใน v1.4
GetInfoFlags
พร็อพเพอร์ตี้
-
singleUnified
บูลีน ไม่บังคับ
หากตั้งค่าเป็น "จริง"
getInfo
จะแสดงผลเฉพาะDisplayUnitInfo
เพียงรายการเดียวเมื่ออยู่ในโหมดเดสก์ท็อปแบบรวม (ดูenableUnifiedDesktop
) ค่าเริ่มต้นคือ "เท็จ"
Insets
พร็อพเพอร์ตี้
-
ครึ่งหลังของอินนิ่ง
ตัวเลข
ระยะห่างของแกน y จากขอบเขตด้านล่าง
-
ฝั่งซ้าย
ตัวเลข
ระยะห่างแกน x จากขอบเขตด้านซ้าย
-
ฝั่งขวา
ตัวเลข
ระยะห่างแกน x จากขอบเขตด้านขวา
-
ครึ่งแรกของอินนิ่ง
ตัวเลข
ระยะห่างของแกน y จากขอบเขตบน
LayoutPosition
ตำแหน่งเลย์เอาต์ เช่น ขอบของระดับบนสุดที่แนบจอแสดงผล
ค่าแจกแจง
MirrorMode
โหมดมิเรอร์ เช่น การมิเรอร์จอแสดงผลไปยังหน้าจออื่นๆ ด้วยวิธีต่างๆ
ค่าแจกแจง
"off"
ระบุโหมดเริ่มต้น (เดสก์ท็อปขยายหรือเดสก์ท็อปแบบรวม)
"normal"
ระบุว่าจอแสดงผลต้นฉบับเริ่มต้นจะมิเรอร์ไปยังหน้าจออื่นๆ ทั้งหมด
"ผสม"
ระบุว่าจอแสดงผลต้นฉบับที่ระบุจะมิเรอร์ไปยังหน้าจอปลายทางที่ระบุ และระบบจะขยายจอแสดงผลอื่นๆ ที่เชื่อมต่ออยู่ทั้งหมด
MirrorModeInfo
พร็อพเพอร์ตี้
-
mirroringDestinationIds
string[] ไม่บังคับ
รหัสของปลายทางการมิเรอร์จะปรากฏขึ้น ฟีเจอร์นี้ใช้ได้กับ "แบบผสม" เท่านั้น
-
mirroringSourceId
string ไม่บังคับ
รหัสของหน้าจอต้นทางที่มิเรอร์ ฟีเจอร์นี้ใช้ได้กับ "แบบผสม" เท่านั้น
-
โหมด
โหมดมิเรอร์ที่ควรตั้งค่า
Point
พร็อพเพอร์ตี้
-
x
ตัวเลข
พิกัด x ของจุด
-
y
ตัวเลข
พิกัด y ของจุด
TouchCalibrationPair
พร็อพเพอร์ตี้
-
displayPoint
พิกัดของจุดที่แสดง
-
touchPoint
พิกัดของจุดสัมผัสที่สอดคล้องกับจุดที่แสดง
TouchCalibrationPairQuad
พร็อพเพอร์ตี้
-
pair1
ต้องใช้จุดสัมผัสกับจอแสดงผลคู่แรกสำหรับการปรับเทียบการสัมผัส
-
pair2
ต้องใช้จุดแตะคู่ที่ 2 และจุดแสดงผลสำหรับการปรับเทียบการสัมผัส
-
pair3
ต้องใช้จุดแตะคู่ที่ 3 และจุดแสดงผลสำหรับการปรับเทียบการสัมผัส
-
pair4
ต้องใช้จุดสัมผัสคู่ที่ 4 และจุดแสดงผลสำหรับการปรับเทียบการสัมผัส
วิธีการ
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
รีเซ็ตการปรับเทียบการแตะสำหรับจอแสดงผลและนำกลับสู่สถานะเริ่มต้นโดยการล้างข้อมูลการปรับเทียบการแตะทั้งหมดที่เชื่อมโยงกับจอแสดงผล
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
ตั้งค่าคู่การปรับเทียบการสัมผัสสำหรับจอแสดงผล ระบบจะใช้ pairs
เหล่านี้เพื่อปรับเทียบหน้าจอสัมผัสสำหรับการแสดงผลที่มี id
ที่เรียกใช้ startCustomTouchCalibration() โปรดเรียก startCustomTouchCalibration
ก่อนเรียกใช้เมธอดนี้เสมอ หากการปรับเทียบการแตะรายการอื่นอยู่ระหว่างดำเนินการ จะทำให้เกิดข้อผิดพลาด
พารามิเตอร์
-
คู่ของจุดที่ใช้ในการปรับเทียบจอแสดงผล
-
ขอบเขต
ขอบเขตของจอแสดงผลเมื่อปรับเทียบการแตะ ระบบจะไม่สนใจค่า
bounds.left
และbounds.top
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
เปิด/ปิดใช้ฟีเจอร์เดสก์ท็อปแบบรวม หากเปิดใช้ขณะที่มีการมิเรอร์ โหมดเดสก์ท็อปจะไม่เปลี่ยนแปลงจนกว่าจะปิดการมิเรอร์ มิเช่นนั้น โหมดเดสก์ท็อปจะเปลี่ยนเป็นแบบรวมทันที หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
พารามิเตอร์
-
เปิดใช้อยู่
boolean
เป็นจริงหากควรเปิดใช้เดสก์ท็อปแบบรวม
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
ขอข้อมูลเลย์เอาต์สำหรับจอแสดงผลทั้งหมด หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
พารามิเตอร์
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(layouts: DisplayLayout[]) => void
-
เลย์เอาต์
-
การคืนสินค้า
-
Promise<DisplayLayout[]>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
ขอข้อมูลสำหรับอุปกรณ์แสดงผลที่แนบมาทั้งหมด
พารามิเตอร์
-
ธง
GetInfoFlags ไม่บังคับ
Chrome 59 ขึ้นไปตัวเลือกที่ส่งผลต่อวิธีแสดงข้อมูล
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
การคืนสินค้า
-
Promise<DisplayUnitInfo[]>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
ปรับส่วนแทรกปัจจุบันของโอเวอร์สแกนสำหรับจอแสดงผล โดยทั่วไปวิธีนี้ควรย้ายการแสดงผลตามแกน (เช่น ซ้าย+ขวามีค่าเท่ากัน) หรือปรับขนาดตามแกน (เช่น บน+ล่าง มีค่าตรงกันข้าม) การเรียกใช้ Adjust แต่ละครั้งจะสะสมร่วมกับการเรียกก่อนหน้าตั้งแต่เริ่ม
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
-
Delta
ปริมาณการเปลี่ยนส่วนที่แทรกที่อยู่โอเวอร์สแกน
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
ทำการปรับโอเวอร์สแกนให้เสร็จสิ้นสำหรับจอแสดงผลโดยการบันทึกค่าปัจจุบันและซ่อนการวางซ้อน
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
รีเซ็ตส่วนแทรกของโอเวอร์สแกนสำหรับการแสดงผลเป็นค่าที่บันทึกไว้ล่าสุด (เช่น ก่อนที่จะเรียกใช้ Start)
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
เริ่มการปรับเทียบโอเวอร์สแกนสำหรับจอแสดงผล ตัวเลือกนี้จะแสดงการซ้อนทับบนหน้าจอที่ระบุส่วนส่วนที่แทรกในปัจจุบันของโอเวอร์สแกน หากการปรับเทียบโอเวอร์สแกนสำหรับจอแสดงผล id
อยู่ระหว่างดำเนินการ ระบบจะรีเซ็ตการปรับเทียบ
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
ตั้งค่าเลย์เอาต์สำหรับจอแสดงผลทั้งหมด จอแสดงผลที่ไม่ได้รวมไว้จะใช้เลย์เอาต์เริ่มต้น หากเลย์เอาต์ทับซ้อนหรือไม่ถูกต้อง ระบบจะปรับเลย์เอาต์ให้เป็นเลย์เอาต์ที่ถูกต้อง หลังจากแก้ไขเลย์เอาต์แล้ว ระบบจะทริกเกอร์เหตุการณ์ onDisplayChanged หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
พารามิเตอร์
-
เลย์เอาต์
ข้อมูลเลย์เอาต์ที่จำเป็นสำหรับจอแสดงผลทั้งหมด ยกเว้นจอแสดงผลหลัก
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
Promise<void>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
อัปเดตพร็อพเพอร์ตี้สำหรับจอแสดงผลที่ระบุโดย id
ตามข้อมูลที่ให้ไว้ใน info
หากไม่สำเร็จ ระบบจะตั้งค่า runtime.lastError
หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
-
ข้อมูล
ข้อมูลเกี่ยวกับคุณสมบัติการแสดงผลที่ควรเปลี่ยนแปลง คุณสมบัติจะมีการเปลี่ยนแปลงเฉพาะในกรณีที่ระบุค่าใหม่ไว้ใน
info
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
Promise<void>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
ตั้งค่าโหมดการแสดงผลเป็นโหมดมิเรอร์ที่ระบุ การโทรแต่ละครั้งจะรีเซ็ตสถานะจากการเรียกก่อนหน้า การเรียกใช้ setDisplayProperties() จะล้มเหลวสำหรับการแสดงปลายทางการมิเรอร์ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น
พารามิเตอร์
-
ข้อมูล
ข้อมูลของโหมดมิเรอร์ที่ควรนำไปใช้กับโหมดการแสดงผล
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
Promise<void>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
แสดง UX การปรับเทียบแบบดั้งเดิมสำหรับจอแสดงผลที่มี id
เป็นรหัสการแสดงผล ซึ่งจะแสดงการวางซ้อนบนหน้าจอพร้อมคำแนะนำที่จำเป็นเกี่ยวกับวิธีดำเนินการต่อ ระบบจะเรียกใช้โค้ดเรียกกลับในกรณีที่ปรับเทียบสำเร็จเท่านั้น หากปรับเทียบไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(success: boolean) => void
-
สำเร็จ
boolean
-
การคืนสินค้า
-
Promise<boolean>
Chrome 91 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
เริ่มการปรับเทียบการแตะที่กำหนดเองสำหรับจอแสดงผล ควรมีการเรียกใช้เมื่อใช้ UX ที่กำหนดเองในการเก็บรวบรวมข้อมูลการปรับเทียบ หากการปรับเทียบการแตะรายการอื่นอยู่ระหว่างดำเนินการ จะทำให้เกิดข้อผิดพลาด
พารามิเตอร์
-
id
string
ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล
กิจกรรม
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
เริ่มทำงานเมื่อมีการเปลี่ยนแปลงการกำหนดค่าจอแสดงผล
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้() => void