chrome.system.display

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ system.display API เพื่อค้นหาข้อมูลเมตาที่แสดงผล

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

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

ค่าแจกแจง

"ใช้งานอยู่"

"ไม่ได้ใช้งาน"

Bounds

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

  • ความสูง

    ตัวเลข

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

  • ซ้าย

    ตัวเลข

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

  • ด้านบน

    ตัวเลข

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

  • ความกว้าง

    ตัวเลข

    ความกว้างของจอแสดงผลในหน่วยพิกเซล

DisplayLayout

Chrome 53 ขึ้นไป

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

  • id

    สตริง

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

  • หักลบ

    ตัวเลข

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

  • parentId

    สตริง

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

  • position

    LayoutPosition

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

DisplayMode

Chrome 52 ขึ้นไป

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

  • deviceScaleFactor

    ตัวเลข

    ค่าตัวคูณมาตราส่วนของอุปกรณ์ในโหมดการแสดงผล

  • ความสูง

    ตัวเลข

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

  • heightInNativePixels

    ตัวเลข

    ความสูงของโหมดการแสดงผลในหน่วยพิกเซลดั้งเดิม

  • isInterlaced

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

    Chrome 74 ขึ้นไป

    เป็นจริงหากโหมดนี้เป็นแบบ Interlaced เป็นเท็จหากไม่ได้ระบุ

  • 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 ต้องไม่เป็นค่าลบหรือใหญ่กว่าครึ่งหนึ่งของขนาดหน้าจอ คุณเปลี่ยน Overscan ในจอภาพภายในไม่ได้

  • การหมุน

    หมายเลข ไม่บังคับ

    หากตั้งค่าไว้ จะอัปเดตการหมุนของจอแสดงผล ค่าที่ถูกต้องคือ [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 ขึ้นไป

    หมายเหตุ: ตัวเลือกนี้ใช้ได้กับแอป Kiosk ของ ChromeOS เท่านั้น

  • hasTouchSupport

    บูลีน

    Chrome 57 ขึ้นไป

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

  • id

    สตริง

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

  • isEnabled

    บูลีน

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

  • isPrimary

    บูลีน

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

  • isUnified

    บูลีน

    Chrome 59 ขึ้นไป

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

  • mirroringDestinationIds

    string[]

    Chrome 64 ขึ้นไป

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

  • mirroringSourceId

    สตริง

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

  • โหมด

    DisplayMode[]

    Chrome 52 ขึ้นไป

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

  • name

    สตริง

    ชื่อที่จำได้ง่าย (เช่น "จอ LCD ของ HP")

  • โอเวอร์สแกน

    ขอบ

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

  • การหมุน

    ตัวเลข

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

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

Edid

Chrome 67 ขึ้นไป

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

  • manufacturerId

    สตริง

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

  • productId

    สตริง

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

  • yearOfManufacture

    ตัวเลข

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

GetInfoFlags

Chrome 59 ขึ้นไป

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

  • singleUnified

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

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

Insets

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

  • ด้านล่าง

    ตัวเลข

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

  • ซ้าย

    ตัวเลข

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

  • ขวา

    ตัวเลข

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

  • ด้านบน

    ตัวเลข

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

LayoutPosition

Chrome 53 ขึ้นไป

ตำแหน่งเลย์เอาต์ เช่น ขอบขององค์ประกอบหลักที่แนบจอแสดงผล

ค่าแจกแจง

"ด้านบน"

"ขวา"

"ด้านล่าง"

"ซ้าย"

MirrorMode

Chrome 65 ขึ้นไป

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

ค่าแจกแจง

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

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

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

MirrorModeInfo

Chrome 65 ขึ้นไป

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

  • mirroringDestinationIds

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

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

  • mirroringSourceId

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

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

  • โหมด

    MirrorMode

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

Point

Chrome 57 ขึ้นไป

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

  • x

    ตัวเลข

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

  • y

    ตัวเลข

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

TouchCalibrationPair

Chrome 57 ขึ้นไป

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

  • displayPoint

    Point

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

  • touchPoint

    Point

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

TouchCalibrationPairQuad

Chrome 57 ขึ้นไป

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

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

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

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

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

เมธอด

clearTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

completeCustomTouchCalibration()

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

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

พารามิเตอร์

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

  • ขอบเขต

    ขอบเขต

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

enableUnifiedDesktop()

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

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

พารามิเตอร์

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

    บูลีน

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

getDisplayLayout()

Promise Chrome 53 ขึ้นไป 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

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

พารามิเตอร์

  • callback

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

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

    (layouts: DisplayLayout[]) => void

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

  • Promise<DisplayLayout[]>

    Chrome 91 ขึ้นไป

    Promise ที่จะแสดงผลลัพธ์

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

getInfo()

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

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

พารามิเตอร์

  • แฟล็ก

    GetInfoFlags ไม่บังคับ

    Chrome 59 ขึ้นไป

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

  • callback

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

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

    (displayInfo: DisplayUnitInfo[]) => void

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

  • Promise<DisplayUnitInfo[]>

    Chrome 91 ขึ้นไป

    Promise ที่จะแสดงผลลัพธ์

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

overscanCalibrationAdjust()

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

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

พารามิเตอร์

  • id

    สตริง

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

  • Delta

    ขอบ

    จำนวนที่จะเปลี่ยนขอบด้านในของการสแกนเกิน

overscanCalibrationComplete()

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

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

พารามิเตอร์

  • id

    สตริง

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

overscanCalibrationReset()

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

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

พารามิเตอร์

  • id

    สตริง

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

overscanCalibrationStart()

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

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

พารามิเตอร์

  • id

    สตริง

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

setDisplayLayout()

Promise Chrome 53 ขึ้นไป 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • เลย์เอาต์

    DisplayLayout[]

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

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    Promise ที่จะได้รับการแก้ไขเมื่อฟังก์ชันเสร็จสิ้น

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

setDisplayProperties()

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

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

พารามิเตอร์

  • id

    สตริง

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

  • ข้อมูล

    DisplayProperties

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

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    Promise ที่จะได้รับการแก้ไขเมื่อฟังก์ชันเสร็จสิ้น

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

setMirrorMode()

Promise Chrome 65 ขึ้นไป 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • ข้อมูล

    MirrorModeInfo

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

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    Promise ที่จะได้รับการแก้ไขเมื่อฟังก์ชันเสร็จสิ้น

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

showNativeTouchCalibration()

Promise Chrome 57 ขึ้นไป 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

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

พารามิเตอร์

  • id

    สตริง

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

  • callback

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

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

    (success: boolean) => void

    • สำเร็จ

      บูลีน

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

  • Promise<boolean>

    Chrome 91 ขึ้นไป

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

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

startCustomTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

กิจกรรม

onDisplayChanged

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

ทริกเกอร์เมื่อมีการเปลี่ยนแปลงการกำหนดค่าการแสดงผล

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void