chrome.system.display

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

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

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

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

ค่าแจกแจง

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

"inactive"

Bounds

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

• ความสูง

  ตัวเลข

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

• ซ้าย

  ตัวเลข

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

• ด้านบน

  ตัวเลข

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

• ความกว้าง

  ตัวเลข

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

DisplayLayout

Chrome 53 ขึ้นไป

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

• id

  สตริง

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

• offset

  ตัวเลข

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

• parentId

  สตริง

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

• position

  LayoutPosition

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

DisplayMode

Chrome 52 ขึ้นไป

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

• deviceScaleFactor

  ตัวเลข

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

• ความสูง

  ตัวเลข

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

• heightInNativePixels

  ตัวเลข

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

• isInterlaced

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

  Chrome 74 ขึ้นไป

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

• isNative

  บูลีน

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

• isSelected

  บูลีน

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

• refreshRate

  ตัวเลข

  Chrome 67 ขึ้นไป

  อัตราการรีเฟรชของโหมดการแสดงผลเป็นเฮิร์ตซ์

• uiScale

  number ไม่บังคับ

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

  ใช้ displayZoomFactor

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

• ความกว้าง

  ตัวเลข

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

• widthInNativePixels

  ตัวเลข

  ความกว้างของโหมดการแสดงผลเป็นพิกเซลแบบเนทีฟ

DisplayProperties

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

• boundsOriginX

  number ไม่บังคับ

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

• boundsOriginY

  number ไม่บังคับ

  หากตั้งค่าไว้ ระบบจะอัปเดตจุดเริ่มต้นขอบเขตเชิงตรรกะของจอแสดงผลตามแกน Y ดูเอกสารประกอบสำหรับพารามิเตอร์ boundsOriginX

• displayMode

  DisplayMode ไม่บังคับ

  Chrome 52 ขึ้นไป

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

• displayZoomFactor

  number ไม่บังคับ

  Chrome 65 ขึ้นไป

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

• isPrimary

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

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

• isUnified

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

  Chrome 59 ขึ้นไป

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

• mirroringSourceId

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

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

  ใช้ setMirrorMode

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

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

  Insets ไม่บังคับ

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

• การหมุนเวียน

  number ไม่บังคับ

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

• 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 เป็นหมุนอัตโนมัติเมื่ออุปกรณ์อยู่ในสถานะแท็บเล็ตจริง

• workArea

  ขอบเขต

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

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"
ระบุโหมดเริ่มต้น (เดสก์ท็อปแบบขยายหรือแบบรวม)

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

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

MirrorModeInfo

Chrome 65 ขึ้นไป

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

• mirroringDestinationIds

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

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

• mirroringSourceId

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

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

• โหมด

  MirrorMode

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

Point

Chrome 57 ขึ้นไป

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

• x

  ตัวเลข

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

• y

  ตัวเลข

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

TouchCalibrationPair

Chrome 57 ขึ้นไป

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

• displayPoint

  Point

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

• touchPoint

  Point

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

TouchCalibrationPairQuad

Chrome 57 ขึ้นไป

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

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

  ต้องใช้จุดสัมผัสและจุดแสดงผลคู่ที่ 3 เพื่อปรับเทียบการสัมผัส

• pair4

  TouchCalibrationPair

  ต้องใช้จุดสัมผัสและจุดแสดงผลคู่ที่ 4 เพื่อปรับเทียบการสัมผัส

เมธอด

clearTouchCalibration()

Chrome 57 ขึ้นไป

chrome.system.display.clearTouchCalibration(
  id: string,
): void

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

พารามิเตอร์

• id

  สตริง

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

completeCustomTouchCalibration()

Chrome 57 ขึ้นไป

chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

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

พารามิเตอร์

• คู่

  TouchCalibrationPairQuad

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

• ขอบเขต

  ขอบเขต

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

enableUnifiedDesktop()

Chrome 46 ขึ้นไป

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

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

พารามิเตอร์

• เปิดอยู่

  บูลีน

  True หากควรเปิดใช้เดสก์ท็อปแบบรวม

getDisplayLayout()

Promise Chrome 53 ขึ้นไป

chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

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

พารามิเตอร์

• callback

  function ไม่บังคับ

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

  (layouts: DisplayLayout[]) => void

  • เลย์เอาต์

    DisplayLayout[]

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

• Promise<DisplayLayout[]>

  Chrome 91 ขึ้นไป

  Promise ที่แก้ไขด้วยผลลัพธ์

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

getInfo()

Promise

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

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

พารามิเตอร์

• แฟล็ก

  GetInfoFlags ไม่บังคับ

  Chrome 59 ขึ้นไป

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

• callback

  function ไม่บังคับ

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

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

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

• Promise<DisplayUnitInfo[]>

  Chrome 91 ขึ้นไป

  Promise ที่แก้ไขด้วยผลลัพธ์

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

overscanCalibrationAdjust()

Chrome 53 ขึ้นไป

chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

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

พารามิเตอร์

• id

  สตริง

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

• Delta

  ส่วนแทรก

  จำนวนที่จะเปลี่ยนส่วนแทรก Overscan

overscanCalibrationComplete()

Chrome 53 ขึ้นไป

chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

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

พารามิเตอร์

• id

  สตริง

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

overscanCalibrationReset()

Chrome 53 ขึ้นไป

chrome.system.display.overscanCalibrationReset(
  id: string,
): void

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

พารามิเตอร์

• id

  สตริง

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

overscanCalibrationStart()

Chrome 53 ขึ้นไป

chrome.system.display.overscanCalibrationStart(
  id: string,
): void

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

พารามิเตอร์

• id

  สตริง

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

setDisplayLayout()

Promise Chrome 53 ขึ้นไป

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

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

พารามิเตอร์

• เลย์เอาต์

  DisplayLayout[]

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

• callback

  function ไม่บังคับ

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

  () => void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

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

setDisplayProperties()

Promise

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

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

พารามิเตอร์

• id

  สตริง

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

• ข้อมูล

  DisplayProperties

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

• callback

  function ไม่บังคับ

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

  () => void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

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

setMirrorMode()

Promise Chrome 65 ขึ้นไป

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

• ข้อมูล

  MirrorModeInfo

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

• callback

  function ไม่บังคับ

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

  () => void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

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

showNativeTouchCalibration()

Promise Chrome 57 ขึ้นไป

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

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

พารามิเตอร์

• id

  สตริง

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

• callback

  function ไม่บังคับ

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

  (success: boolean) => void

  • สำเร็จ

    บูลีน

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

• Promise<boolean>

  Chrome 91 ขึ้นไป

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

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

startCustomTouchCalibration()

Chrome 57 ขึ้นไป

chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

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

พารามิเตอร์

• id

  สตริง

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

กิจกรรม

onDisplayChanged

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

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

พารามิเตอร์

• callback

  ฟังก์ชัน

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

  () => void