chrome.system.display

คำอธิบาย

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

สิทธิ์

system.display

ประเภท

ActiveState

Chrome 117 ขึ้นไป

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

ค่าแจกแจง

"active"

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

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

    หมายเหตุ: ฟีเจอร์นี้ใช้ได้กับแอป ChromeOS Kiosk และ 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")

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

    ระยะขอบ

    ระยะขอบของจอแสดงผลภายในขอบเขตของหน้าจอ ปัจจุบันแสดงเฉพาะใน 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 ขึ้นไป

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

ค่าแจกแจง

"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

    Point

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

  • touchPoint

    Point

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

TouchCalibrationPairQuad

Chrome 57 ขึ้นไป

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

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

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

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

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

เมธอด

clearTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

completeCustomTouchCalibration()

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

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

พารามิเตอร์

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

  • ขอบเขต

    ขอบเขต

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

enableUnifiedDesktop()

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

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

พารามิเตอร์

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

    บูลีน

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

getDisplayLayout()

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

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

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

getInfo()

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

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

พารามิเตอร์

  • ธง

    GetInfoFlags ไม่บังคับ

    Chrome 59 ขึ้นไป

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

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

overscanCalibrationAdjust()

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

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

พารามิเตอร์

  • id

    สตริง

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

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

overscanCalibrationComplete()

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

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

พารามิเตอร์

  • id

    สตริง

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

overscanCalibrationReset()

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

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

พารามิเตอร์

  • id

    สตริง

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

overscanCalibrationStart()

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

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

พารามิเตอร์

  • id

    สตริง

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

setDisplayLayout()

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

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

พารามิเตอร์

  • เลย์เอาต์

    DisplayLayout[]

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

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

  • Promise<void>

    Chrome 91 ขึ้นไป

setDisplayProperties()

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

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

พารามิเตอร์

  • id

    สตริง

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

  • ข้อมูล

    DisplayProperties

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

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

  • Promise<void>

    Chrome 91 ขึ้นไป

setMirrorMode()

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

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

พารามิเตอร์

  • ข้อมูล

    MirrorModeInfo

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

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

  • Promise<void>

    Chrome 91 ขึ้นไป

showNativeTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

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

  • Promise<boolean>

    Chrome 91 ขึ้นไป

startCustomTouchCalibration()

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

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

พารามิเตอร์

  • id

    สตริง

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

กิจกรรม

onDisplayChanged

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void