chrome.system.display

คำอธิบาย

ใช้ system.display API เพื่อค้นหาข้อมูลเมตาของ Display

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

อาร์เรย์แบบจำกัดเพื่อระบุว่าระบบตรวจพบและใช้งานจอแสดงผลหรือไม่ ระบบจะถือว่าจอแสดงผล "ไม่ทำงาน" หากไม่ตรวจพบ (อาจไม่ได้เชื่อมต่ออยู่หรือถือว่าไม่ได้เชื่อมต่อเนื่องจากโหมดสลีป ฯลฯ) สถานะนี้ใช้เพื่อเก็บการแสดงผลที่มีอยู่เมื่อยกเลิกการเชื่อมต่อจอแสดงผลทั้งหมด เช่น

ค่าแจกแจง

"active"

"inactive"

Bounds

พร็อพเพอร์ตี้

  • ส่วนสูง

    ตัวเลข

    ความสูงของจอแสดงผลเป็นพิกเซล

  • ซ้าย

    ตัวเลข

    พิกัด x ของมุมซ้ายบน

  • ด้านบน

    ตัวเลข

    พิกัด Y ของมุมซ้ายบน

  • ความกว้าง

    ตัวเลข

    ความกว้างของจอแสดงผลเป็นพิกเซล

DisplayLayout

Chrome 53 ขึ้นไป

พร็อพเพอร์ตี้

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

  • ออฟเซ็ต

    ตัวเลข

    การเลื่อนของจอแสดงผลตามขอบที่เชื่อมต่อ 0 บ่งบอกว่ามุมบนสุดหรือซ้ายสุดอยู่ในแนวเดียวกัน

  • parentId

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผลหลัก เว้นว่างไว้หากเป็นรูท

  • position

    LayoutPosition

    ตำแหน่งเลย์เอาต์ของการแสดงผลนี้สัมพันธ์กับรายการหลัก ระบบจะไม่สนใจค่านี้สำหรับรูท

DisplayMode

Chrome 52 ขึ้นไป

พร็อพเพอร์ตี้

  • deviceScaleFactor

    ตัวเลข

    ปัจจัยที่มีผลต่อขนาดอุปกรณ์โหมดการแสดงผล

  • ส่วนสูง

    ตัวเลข

    ความสูงของโหมดการแสดงผลเป็นพิกเซลที่ไม่ขึ้นอยู่กับอุปกรณ์ (ผู้ใช้มองเห็นได้)

  • heightInNativePixels

    ตัวเลข

    ความสูงของโหมดการแสดงผลเป็นพิกเซลเดิม

  • isInterlaced

    บูลีน ไม่บังคับ

    Chrome 74 ขึ้นไป

    จริงหากโหมดนี้เป็นแบบอินเตอร์เลซ เป็นเท็จหากไม่ได้ระบุ

  • isNative

    บูลีน

    เป็นจริงหากโหมดเป็นโหมดเนทีฟของจอแสดงผล

  • isSelected

    บูลีน

    จริงหากเลือกโหมดการแสดงผลอยู่

  • 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 ขึ้นไป

    ChromeOS เท่านั้น หากตั้งค่าเป็น "จริง" ระบบจะเปลี่ยนโหมดการแสดงผลเป็นเดสก์ท็อปแบบรวม (ดูรายละเอียดที่ enableUnifiedDesktop) หากตั้งค่าเป็น "เท็จ" ระบบจะปิดใช้โหมดเดสก์ท็อปแบบรวม ซึ่งใช้ได้กับจอแสดงผลหลักเท่านั้น หากระบุ mirroringSourceId ไว้ คุณต้องไม่ระบุพร็อพเพอร์ตี้อื่นๆ และระบบจะละเว้นพร็อพเพอร์ตี้อื่นๆ จะไม่มีผลหากไม่ได้ระบุ

  • mirroringSourceId

    สตริง ไม่บังคับ

    เลิกใช้งานแล้วตั้งแต่ Chrome 68

    ใช้ setMirrorMode

    ChromeOS เท่านั้น หากตั้งค่าไว้และไม่ว่างเปล่า ระบบจะเปิดใช้การมิเรอร์สำหรับจอแสดงผลนี้เท่านั้น ไม่เช่นนั้นระบบจะปิดใช้การมิเรอร์สำหรับจอแสดงผลทั้งหมด ค่านี้ควรระบุรหัสของจอแสดงผลต้นทางที่จะมิเรอร์ ซึ่งต้องไม่เหมือนกับรหัสที่ส่งไปยัง setDisplayProperties หากตั้งค่าไว้ คุณจะตั้งค่าพร็อพเพอร์ตี้อื่นไม่ได้

  • Overscan

    Insets ไม่บังคับ

    หากตั้งค่าไว้ ระบบจะตั้งค่าส่วนเกินของการแสดงผลที่ตัดออกเป็นค่าที่ระบุ โปรดทราบว่าค่าการเลื่อนขอบต้องไม่เป็นค่าลบหรือมากกว่าครึ่งหนึ่งของขนาดหน้าจอ ไม่สามารถเปลี่ยนการเลื่อนหน้าจอบนจอแสดงผลภายในได้

  • การหมุน

    ตัวเลข ไม่บังคับ

    หากตั้งค่าไว้ ระบบจะอัปเดตการหมุนของจอแสดงผล ค่าที่ใช้ได้คือ [0, 90, 180, 270] การหมุนจะตั้งค่าตามเข็มนาฬิกาโดยสัมพันธ์กับตำแหน่งแนวตั้งของจอแสดงผล

DisplayUnitInfo

พร็อพเพอร์ตี้

  • activeState

    ActiveState

    Chrome 117 ขึ้นไป

    ใช้งานอยู่หากระบบตรวจพบและใช้จอแสดงผล

  • availableDisplayZoomFactors

    number[]

    Chrome 67 ขึ้นไป

    รายการค่าอัตราส่วนการซูมที่ตั้งค่าสำหรับจอแสดงผลได้

  • ขอบเขต

    ขอบเขต

    ขอบเขตเชิงตรรกะของจอแสดงผล

  • displayZoomFactor

    ตัวเลข

    Chrome 65 ขึ้นไป

    อัตราส่วนระหว่างการซูมปัจจุบันกับการซูมเริ่มต้นของจอแสดงผล เช่น ค่า 1 เทียบเท่ากับการซูม 100% และค่า 1.5 เทียบเท่ากับการซูม 150%

  • dpiX

    ตัวเลข

    จำนวนพิกเซลต่อนิ้วตามแกน X

  • dpiY

    ตัวเลข

    จํานวนพิกเซลต่อนิ้วตามแกน Y

  • edid

    Edid ไม่บังคับ

    Chrome 67 ขึ้นไป

    หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

  • hasTouchSupport

    บูลีน

    Chrome 57 ขึ้นไป

    จริงหากจอแสดงผลนี้มีอุปกรณ์อินพุตแบบสัมผัสที่เชื่อมโยงอยู่

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

  • isEnabled

    บูลีน

    จริงหากเปิดใช้จอแสดงผลนี้

  • isPrimary

    บูลีน

    เป็นจริงหากเป็นจอแสดงผลหลัก

  • isUnified

    บูลีน

    Chrome 59 ขึ้นไป

    จริงสำหรับจอแสดงผลทั้งหมดเมื่ออยู่ในโหมดเดสก์ท็อปแบบรวมหลายหน้าจอ ดูเอกสารประกอบของ enableUnifiedDesktop

  • mirroringDestinationIds

    string[]

    Chrome 64 ขึ้นไป

    ChromeOS เท่านั้น ตัวระบุของจอแสดงผลที่มิเรอร์จอแสดงผลต้นทาง ว่างเปล่าหากไม่มีการมิเรอร์จอแสดงผล ระบบจะตั้งค่านี้เป็นค่าเดียวกันสำหรับจอแสดงผลทั้งหมด แต่ไม่รวมถึง mirroringSourceId

  • mirroringSourceId

    สตริง

    ChromeOS เท่านั้น ตัวระบุของจอแสดงผลที่กำลังมิเรอร์หากเปิดใช้มิเรอร์ มิเช่นนั้นจะเป็นค่าว่าง ซึ่งจะเป็นการตั้งค่าสำหรับจอแสดงผลทั้งหมด (รวมถึงจอแสดงผลที่มิเรอร์)

  • โหมด

    DisplayMode[]

    Chrome 52 ขึ้นไป

    รายการโหมดการแสดงผลที่ใช้ได้ โหมดปัจจุบันจะมี isSelected=true ใช้ได้เฉพาะใน ChromeOS ระบบจะตั้งค่าเป็นอาร์เรย์ว่างในแพลตฟอร์มอื่นๆ

  • ชื่อ

    สตริง

    ชื่อที่เข้าใจง่าย (เช่น "จอแสดงผล LCD ของ HP")

  • Overscan

    Insets

    ส่วนที่เป็นขอบของจอแสดงผลภายในขอบเขตของหน้าจอ ขณะนี้มีให้บริการใน ChromeOS เท่านั้น ระบบจะตั้งค่าเป็นอินเซ็ตว่างในแพลตฟอร์มอื่นๆ

  • การหมุน

    ตัวเลข

    การหมุนตามเข็มนาฬิกาของจอแสดงผลเป็นองศาเทียบกับตำแหน่งแนวตั้ง ขณะนี้มีให้บริการใน ChromeOS เท่านั้น ระบบจะตั้งค่าเป็น 0 ในแพลตฟอร์มอื่นๆ ระบบจะตีความค่า -1 เป็นการหมุนอัตโนมัติเมื่ออุปกรณ์อยู่ในสถานะแท็บเล็ต

  • พื้นที่ทํางานที่ใช้งานได้ของจอแสดงผลภายในขอบเขตของจอแสดงผล พื้นที่ทํางานจะไม่รวมพื้นที่ของจอแสดงผลที่สงวนไว้สําหรับระบบปฏิบัติการ เช่น แถบงานและตัวเปิด

Edid

Chrome 67 ขึ้นไป

พร็อพเพอร์ตี้

  • manufacturerId

    สตริง

    รหัสผู้ผลิต 3 อักขระ โปรดดูส่วนที่ 3.4.1 หน้า 21 ต้องระบุใน v1.4

  • productId

    สตริง

    รหัส 2 ไบต์ที่ผู้ผลิตกำหนด ส่วน 3.4.2 หน้า 21 ต้องระบุใน v1.4

  • yearOfManufacture

    ตัวเลข

    ปีของผู้ผลิต ส่วน 3.4.4 หน้า 22 ต้องระบุใน v1.4

GetInfoFlags

Chrome 59 ขึ้นไป

พร็อพเพอร์ตี้

  • singleUnified

    บูลีน ไม่บังคับ

    หากตั้งค่าเป็น "จริง" getInfo จะแสดงผล DisplayUnitInfo เพียงรายการเดียวเมื่ออยู่ในโหมดเดสก์ท็อปแบบรวม (ดู enableUnifiedDesktop) ค่าเริ่มต้นคือ "เท็จ"

Insets

พร็อพเพอร์ตี้

  • ด้านล่าง

    ตัวเลข

    ระยะห่างของแกน y จากขอบเขตล่าง

  • ซ้าย

    ตัวเลข

    ระยะห่างของแกน x จากขอบเขตด้านซ้าย

  • ขวา

    ตัวเลข

    ระยะทางบนแกน x จากขอบขวา

  • ด้านบน

    ตัวเลข

    ระยะทางบนแกน Y จากขอบเขตบน

LayoutPosition

Chrome 53 ขึ้นไป

ตำแหน่งเลย์เอาต์ เช่น ขอบของส่วนหลักที่จอแสดงผลยึดอยู่

ค่าแจกแจง

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 ขึ้นไป

โหมดมิเรอร์ เช่น วิธีต่างๆ ในการมิเรอร์จอแสดงผลไปยังจอแสดงผลอื่นๆ

ค่าแจกแจง

"off"
ระบุโหมดเริ่มต้น (เดสก์ท็อปแบบขยายหรือแบบรวมหลายหน้าจอ)

"ปกติ"
ระบุว่าระบบจะมิเรอร์จอแสดงผลต้นทางเริ่มต้นไปยังจอแสดงผลอื่นๆ ทั้งหมด

"mixed"
ระบุว่าระบบจะมิเรอร์จอแสดงผลต้นทางที่ระบุไปยังจอแสดงผลปลายทางที่ระบุ จอแสดงผลอื่นๆ ทั้งหมดที่เชื่อมต่ออยู่จะขยายเวลา

MirrorModeInfo

Chrome 65 ขึ้นไป

พร็อพเพอร์ตี้

  • mirroringDestinationIds

    string[] ไม่บังคับ

    รหัสของปลายทางการมิเรอร์จะแสดงขึ้น ใช้ได้กับ "ผสม" เท่านั้น

  • mirroringSourceId

    สตริง ไม่บังคับ

    รหัสของการแสดงแหล่งที่มาของการมิเรอร์ ใช้ได้กับ "ผสม" เท่านั้น

  • โหมด

    MirrorMode

    โหมดมิเรอร์ที่ควรตั้งค่า

Point

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • x

    ตัวเลข

    พิกัด x ของจุด

  • y

    ตัวเลข

    พิกัด y ของจุด

TouchCalibrationPair

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • displayPoint

    จุด

    พิกัดของจุดแสดงผล

  • touchPoint

    จุด

    พิกัดของจุดสัมผัสที่สอดคล้องกับจุดแสดงผล

TouchCalibrationPairQuad

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • จุดสัมผัสและจุดแสดงผลคู่แรกที่จำเป็นสำหรับการปรับเทียบการสัมผัส

  • ต้องแตะจุดที่ 2 บนจอแสดงผลเพื่อปรับเทียบการสัมผัส

  • จุดสัมผัสและจุดแสดงผลคู่ที่ 3 ที่จําเป็นสําหรับการปรับเทียบการสัมผัส

  • จุดสัมผัสและจุดแสดงผลคู่ที่ 4 ที่จําเป็นสําหรับการปรับเทียบการสัมผัส

เมธอด

clearTouchCalibration()

Chrome 57 ขึ้นไป 
chrome.system.display.clearTouchCalibration(
  id: string,
)

รีเซ็ตการปรับเทียบการสัมผัสสำหรับจอแสดงผลและนำจอแสดงผลกลับสู่สถานะเริ่มต้นโดยล้างข้อมูลการปรับเทียบการสัมผัสที่เชื่อมโยงกับจอแสดงผล

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

completeCustomTouchCalibration()

Chrome 57 ขึ้นไป 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

ตั้งค่าคู่การปรับเทียบการสัมผัสสำหรับจอแสดงผล pairs เหล่านี้จะใช้เพื่อปรับเทียบหน้าจอสัมผัสสำหรับการแสดงผลด้วย id ที่เรียกใช้ใน startCustomTouchCalibration() โปรดเรียกใช้ startCustomTouchCalibration ก่อนเรียกใช้เมธอดนี้เสมอ หากมีการปรับเทียบการสัมผัสอื่นที่กำลังดำเนินอยู่ ระบบจะแสดงข้อผิดพลาด

พารามิเตอร์

  • คู่จุดที่ใช้ปรับเทียบจอแสดงผล

  • ขอบเขต

    ขอบเขต

    ขอบเขตของจอแสดงผลเมื่อทำการปรับเทียบการสัมผัส ระบบจะไม่สนใจค่า bounds.left และ bounds.top

enableUnifiedDesktop()

Chrome 46 ขึ้นไป 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

เปิด/ปิดใช้ฟีเจอร์เดสก์ท็อปแบบรวมหลายหน้าจอ หากเปิดใช้ขณะที่การมิเรอร์ทำงานอยู่ โหมดเดสก์ท็อปจะไม่เปลี่ยนแปลงจนกว่าจะปิดการมิเรอร์ มิเช่นนั้นโหมดเดสก์ท็อปจะเปลี่ยนเป็นโหมดรวมทันที หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

พารามิเตอร์

  • เปิดใช้อยู่

    บูลีน

    เป็นจริงหากควรเปิดใช้เดสก์ท็อปแบบรวมหลายหน้าจอ

getDisplayLayout()

สัญญา Chrome 53 ขึ้นไป 
chrome.system.display.getDisplayLayout(
  callback?: function,
)

ขอข้อมูลเลย์เอาต์สำหรับจอแสดงผลทั้งหมด หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (layouts: DisplayLayout[]) => void

การคืนสินค้า

  • Promise<DisplayLayout[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getInfo()

สัญญา 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

ขอข้อมูลสำหรับอุปกรณ์แสดงผลที่เชื่อมต่อทั้งหมด

พารามิเตอร์

  • ธง

    GetInfoFlags ไม่บังคับ

    Chrome 59 ขึ้นไป

    ตัวเลือกที่ส่งผลต่อวิธีแสดงข้อมูล

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (displayInfo: DisplayUnitInfo[]) => void

การคืนสินค้า

  • Promise<DisplayUnitInfo[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

overscanCalibrationAdjust()

Chrome 53 ขึ้นไป 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

ปรับส่วนเกินที่แสดงเกินขอบของจอแสดงผลในปัจจุบัน โดยปกติแล้ว การดำเนินการนี้ควรย้ายการแสดงผลไปตามแกน (เช่น ซ้าย+ขวามีค่าเดียวกัน) หรือปรับขนาดไปตามแกน (เช่น บน+ล่างมีค่าตรงข้ามกัน) การเรียกใช้ "ปรับ" แต่ละครั้งจะรวมกับคําเรียกใช้ก่อนหน้านับตั้งแต่ "เริ่ม"

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

  • Delta

    Insets

    จำนวนที่จะเปลี่ยนส่วนเกินของภาพ

overscanCalibrationComplete()

Chrome 53 ขึ้นไป 
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

ปรับการเลื่อนขอบของจอแสดงผลให้เสร็จสมบูรณ์โดยบันทึกค่าปัจจุบันและซ่อนการวางซ้อน

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

overscanCalibrationReset()

Chrome 53 ขึ้นไป 
chrome.system.display.overscanCalibrationReset(
  id: string,
)

รีเซ็ตส่วนเกินของการสแกนสำหรับจอแสดงผลเป็นค่าที่บันทึกล่าสุด (เช่น ก่อนเรียกใช้ Start)

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

overscanCalibrationStart()

Chrome 53 ขึ้นไป 
chrome.system.display.overscanCalibrationStart(
  id: string,
)

เริ่มการปรับเทียบการเลื่อนขอบของจอแสดงผล ซึ่งจะแสดงการวางซ้อนบนหน้าจอที่ระบุส่วนเกินของการสแกนในปัจจุบัน หากการปรับเทียบการเลื่อนขอบของจอแสดงผล id กำลังดำเนินอยู่ การดำเนินการนี้จะรีเซ็ตการปรับเทียบ

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

setDisplayLayout()

สัญญา Chrome 53 ขึ้นไป 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

ตั้งค่าเลย์เอาต์สำหรับจอแสดงผลทั้งหมด จอแสดงผลที่ไม่ได้รวมไว้จะใช้เลย์เอาต์เริ่มต้น หากเลย์เอาต์ซ้อนทับกันหรือไม่ถูกต้อง ระบบจะปรับเลย์เอาต์ให้ถูกต้อง หลังจากแก้ไขเลย์เอาต์แล้ว ระบบจะเรียกเหตุการณ์ onDisplayChanged หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

พารามิเตอร์

  • layouts

    DisplayLayout[]

    ข้อมูลเลย์เอาต์ที่จำเป็นสำหรับจอแสดงผลทั้งหมดยกเว้นจอแสดงผลหลัก

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

setDisplayProperties()

สัญญา 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

อัปเดตพร็อพเพอร์ตี้สำหรับจอแสดงผลที่ระบุโดย id ตามข้อมูลที่ให้ไว้ใน info หากดำเนินการไม่สำเร็จ ระบบจะตั้งค่า runtime.lastError หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

  • ข้อมูล

    DisplayProperties

    ข้อมูลเกี่ยวกับพร็อพเพอร์ตี้การแสดงผลที่ควรเปลี่ยนแปลง ระบบจะเปลี่ยนพร็อพเพอร์ตี้ก็ต่อเมื่อมีการกำหนดค่าใหม่ใน info

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

setMirrorMode()

สัญญา Chrome 65 ขึ้นไป 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

ตั้งค่าโหมดการแสดงผลเป็นโหมดมิเรอร์ที่ระบุ การโทรแต่ละครั้งจะรีเซ็ตสถานะจากการโทรครั้งก่อนหน้า การเรียก setDisplayProperties() จะดำเนินการไม่สำเร็จสำหรับจอแสดงผลปลายทางที่มิเรอร์ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอปคีออสก์ ChromeOS และ Web UI เท่านั้น

พารามิเตอร์

  • ข้อมูล

    MirrorModeInfo

    ข้อมูลของโหมดมิเรอร์ที่ควรใช้กับโหมดการแสดงผล

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

showNativeTouchCalibration()

สัญญา Chrome 57 ขึ้นไป 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

แสดง UX การปรับเทียบระบบสัมผัสแบบเนทีฟสำหรับจอแสดงผลที่มี id เป็นรหัสจอแสดงผล ซึ่งจะแสดงการวางซ้อนบนหน้าจอพร้อมวิธีการที่จำเป็นในการดําเนินการต่อ ระบบจะเรียกใช้การเรียกกลับในกรณีที่ปรับเทียบสําเร็จเท่านั้น หากการสอบเทียบไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (success: boolean) => void

    • สำเร็จ

      บูลีน

การคืนสินค้า

  • Promise<boolean>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

startCustomTouchCalibration()

Chrome 57 ขึ้นไป 
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

เริ่มการปรับเทียบการสัมผัสที่กำหนดเองสำหรับจอแสดงผล ควรเรียกใช้เมื่อใช้ UX ที่กําหนดเองสําหรับรวบรวมข้อมูลการปรับเทียบ หากมีการปรับเทียบการสัมผัสอื่นที่กำลังดำเนินอยู่ ระบบจะแสดงข้อผิดพลาด

พารามิเตอร์

  • id

    สตริง

    ตัวระบุที่ไม่ซ้ำกันของจอแสดงผล

กิจกรรม

onDisplayChanged

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

เรียกใช้เมื่อมีการเปลี่ยนแปลงใดๆ ในการกำหนดค่าการแสดงผล

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void