chrome.system.display

คำอธิบาย

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

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

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

ค่าแจกแจง

Bounds

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

• ส่วนสูง

  ตัวเลข

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

• ฝั่งซ้าย

  ตัวเลข

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

• ครึ่งแรกของอินนิ่ง

  ตัวเลข

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

• ความกว้าง

  ตัวเลข

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

DisplayLayout

Chrome 53 ขึ้นไป

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

• id

  string

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

• ออฟเซ็ต

  ตัวเลข

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

• parentId

  string

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

• position

  LayoutPosition

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

DisplayMode

Chrome 52 ขึ้นไป

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

• 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

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

• activeState

  ActiveState

  Chrome 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 เท่านั้น ตัวระบุของจอแสดงผลที่กำลังมิเรอร์หากเปิดใช้การมิเรอร์ไว้ ไม่เช่นนั้นจะว่างเปล่า ระบบจะตั้งค่านี้สำหรับจอแสดงผลทั้งหมด (รวมถึงจอแสดงผลที่กำลังมิเรอร์)

• modes

  DisplayMode[]

  Chrome 52 ขึ้นไป

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

• ชื่อ

  string

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

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

  ส่วนที่ประกอบ

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

• การหมุน

  ตัวเลข

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

• workArea

  ขอบเขต

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

Edid

Chrome เวอร์ชัน 67 ขึ้นไป

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

• 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

Chrome 59 ขึ้นไป

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

• singleUnified

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

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

Insets

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

• ครึ่งหลังของอินนิ่ง

  ตัวเลข

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

• ฝั่งซ้าย

  ตัวเลข

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

• ฝั่งขวา

  ตัวเลข

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

• ครึ่งแรกของอินนิ่ง

  ตัวเลข

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

LayoutPosition

Chrome 53 ขึ้นไป

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

ค่าแจกแจง

MirrorMode

Chrome 65 ขึ้นไป

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

ค่าแจกแจง

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

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

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

MirrorModeInfo

Chrome 65 ขึ้นไป

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

• mirroringDestinationIds

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

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

• mirroringSourceId

  string ไม่บังคับ

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

• โหมด

  MirrorMode

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

Point

Chrome 57 ขึ้นไป

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

• x

  ตัวเลข

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

• y

  ตัวเลข

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

TouchCalibrationPair

Chrome 57 ขึ้นไป

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

• displayPoint

  จุด

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

• touchPoint

  จุด

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

TouchCalibrationPairQuad

Chrome 57 ขึ้นไป

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

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

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

• pair4

  TouchCalibrationPair

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

วิธีการ

clearTouchCalibration()

Chrome 57 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

completeCustomTouchCalibration()

Chrome 57 ขึ้นไป

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

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

พารามิเตอร์

• คู่

  TouchCalibrationPairQuad

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

• ขอบเขต

  ขอบเขต

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

enableUnifiedDesktop()

Chrome 46 ขึ้นไป

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

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

พารามิเตอร์

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

  boolean

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

getDisplayLayout()

คำมั่นสัญญา Chrome 53 ขึ้นไป

chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

พารามิเตอร์

• Callback

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

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

  (layouts: DisplayLayout[])=>void

  • เลย์เอาต์

    DisplayLayout[]

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

• Promise<DisplayLayout[]>

  Chrome 91 ขึ้นไป

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

getInfo()

สัญญา

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

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

พารามิเตอร์

• ธง

  GetInfoFlags ไม่บังคับ

  Chrome 59 ขึ้นไป

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

• Callback

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

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

  (displayInfo: DisplayUnitInfo[])=>void

  • displayInfo

    DisplayUnitInfo[]

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

• Promise<DisplayUnitInfo[]>

  Chrome 91 ขึ้นไป

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

overscanCalibrationAdjust()

Chrome 53 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

• Delta

  ส่วนที่ประกอบ

  ปริมาณการเปลี่ยนส่วนที่แทรกที่อยู่โอเวอร์สแกน

overscanCalibrationComplete()

Chrome 53 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

overscanCalibrationReset()

Chrome 53 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

overscanCalibrationStart()

Chrome 53 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

setDisplayLayout()

คำมั่นสัญญา Chrome 53 ขึ้นไป

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

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

พารามิเตอร์

• เลย์เอาต์

  DisplayLayout[]

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

• Callback

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

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

  ()=>void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

setDisplayProperties()

สัญญา

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

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

พารามิเตอร์

• id

  string

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

• ข้อมูล

  DisplayProperties

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

• Callback

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

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

  ()=>void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

setMirrorMode()

คำมั่นสัญญา Chrome 65 ขึ้นไป

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

พารามิเตอร์

• ข้อมูล

  MirrorModeInfo

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

• Callback

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

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

  ()=>void

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

• Promise<void>

  Chrome 91 ขึ้นไป

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

showNativeTouchCalibration()

คำมั่นสัญญา Chrome เวอร์ชัน 57 ขึ้นไป

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

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

พารามิเตอร์

• id

  string

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

• Callback

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

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

  (success: boolean)=>void

  • สำเร็จ

    boolean

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

• Promise<boolean>

  Chrome 91 ขึ้นไป

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

startCustomTouchCalibration()

Chrome 57 ขึ้นไป

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

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

พารามิเตอร์

• id

  string

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

กิจกรรม

onDisplayChanged

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

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

พารามิเตอร์

• Callback

  ฟังก์ชัน

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

  ()=>void