chrome.system.display

คำอธิบาย

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

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

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

ค่าแจกแจง

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

"ไม่ทำงาน"

Bounds

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

  • ส่วนสูง

    ตัวเลข

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

  • ซ้าย

    ตัวเลข

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

  • ด้านบน

    ตัวเลข

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

  • ความกว้าง

    ตัวเลข

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

DisplayLayout

Chrome 53 ขึ้นไป

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

  • id

    สตริง

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

  • หักลบ

    ตัวเลข

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

  • parentId

    สตริง

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

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

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

  • คือหลัก

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

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

  • isUnified

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

    Chrome 59 ขึ้นไป

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

  • mirroringSourceId

    string ไม่บังคับ

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

    ใช้ setMirrorMode

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

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

    ชิ้นงาน ไม่บังคับ

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

  • การหมุน

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

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

    สตริง

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

  • isEnabled

    boolean

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

  • คือหลัก

    boolean

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

  • isUnified

    boolean

    Chrome 59 ขึ้นไป

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

  • mirroringDestinationIds

    สตริง[]

    Chrome 64 ขึ้นไป

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

  • mirroringSourceId

    สตริง

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

  • โหมด

    DisplayMode[]

    Chrome 52 ขึ้นไป

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

  • ชื่อ

    สตริง

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

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

    ชิ้นงาน

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

  • การหมุน

    ตัวเลข

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

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

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

ค่าแจกแจง

"ด้านบน"

"ขวา"

"bottom"

"ซ้าย"

MirrorMode

Chrome 65 ขึ้นไป

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

ค่าแจกแจง

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

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

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

MirrorModeInfo

Chrome 65 ขึ้นไป

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

  • mirroringDestinationIds

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

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

  • mirroringSourceId

    string ไม่บังคับ

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

  • โหมด

    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,
)

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

พารามิเตอร์

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

    boolean

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

getDisplayLayout()

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

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (layouts: DisplayLayout[]) => void

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

  • Promise<DisplayLayout[]>

    Chrome 91 ขึ้นไป

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

getInfo()

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

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

พารามิเตอร์

  • แฟล็ก

    GetInfoFlags ไม่บังคับ

    Chrome 59 ขึ้นไป

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

  • Callback

    ไม่บังคับ

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

    (displayInfo: DisplayUnitInfo[]) => void

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

  • Promise<DisplayUnitInfo[]>

    Chrome 91 ขึ้นไป

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

overscanCalibrationAdjust()

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

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

พารามิเตอร์

  • id

    สตริง

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

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

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 หมายเหตุ: วิธีนี้ใช้ได้เฉพาะกับแอปคีออสก์ของ Chrome OS และ UI บนเว็บเท่านั้น

พารามิเตอร์

  • เลย์เอาต์

    DisplayLayout[]

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

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

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

setDisplayProperties()

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

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

พารามิเตอร์

  • id

    สตริง

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

  • ข้อมูล

    DisplayProperties

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

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

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

setMirrorMode()

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

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

พารามิเตอร์

  • ข้อมูล

    MirrorModeInfo

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

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

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

showNativeTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

  • Callback

    ไม่บังคับ

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

    (success: boolean) => void

    • สำเร็จ

      boolean

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

  • Promise&lt;boolean&gt;

    Chrome 91 ขึ้นไป

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

startCustomTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

กิจกรรม

onDisplayChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    () => void