เนมสเปซ: ระบบ

แคสต์เฟรมเวิร์กระบบ

namespace คงที่

นี่คือเนมสเปซ cast.framework.system

ชั้นเรียน

ข้อมูลแอปพลิเคชัน

ข้อมูลเมตาที่อธิบายข้อมูลของแอปพลิเคชันที่เปิดใช้งาน

เหตุการณ์

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext ซึ่งมีข้อมูลระบบ

เริ่มกิจกรรมความคิดเห็น

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อระบบเริ่มสร้างรายงานความคิดเห็น

เหตุการณ์การเปลี่ยนแปลงความละเอียดสูงสุดของวิดีโอ

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อระบบต้องอัปเดตข้อจํากัดเกี่ยวกับความละเอียดสูงสุดของวิดีโอ

พร้อมกิจกรรม

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อระบบพร้อมใช้งาน

ผู้ส่ง

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

SenderConnectEvent

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อเชื่อมต่อผู้ส่ง

ผู้ส่งยกเลิกการเชื่อมต่อกิจกรรม

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อผู้ส่งยกเลิกการเชื่อมต่อ

ปิดระบบ

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อแอปพลิเคชันปิดลง

เหตุการณ์สแตนด์บายเปลี่ยน

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อทีวีเข้าสู่หรือออกจากสถานะสแตนด์บาย ดังนั้นแอปพลิเคชันควรยืนยันพร็อพเพอร์ตี้ isStandby เสมอ หากต้องการทราบว่าไม่ทราบสถานะจริง แอปพลิเคชันจะเรียกใช้เมธอด cast.framework.CastReceiverContext#getStandbyState ได้

เหตุการณ์ระดับเสียงของระบบที่เปลี่ยน

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อระดับเสียงของระบบมีการเปลี่ยนแปลง

ข้อมูลระดับเสียงของระบบ

ข้อมูลนี้แสดงถึงข้อมูลระดับเสียงของระบบ

EventChangedEvent

เหตุการณ์ที่ส่งโดย cast.framework.CastReceiverContext เมื่อระดับการเข้าถึงของแอปพลิเคชันเปลี่ยนไป เช่น เมื่ออินพุต HDMI เปลี่ยนไป หรือเมื่อทีวีปิดอยู่

การแจกแจง

ความสามารถของอุปกรณ์

คงที่

สตริง

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

ค่า
เสียง	สตริง การรองรับ Assistant แบบเสียง ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับเสียง Assistant ได้แก่ Google Home และ Google Home Mini
บลูทูธ	สตริง การรองรับบลูทูธ
แสดง	สตริง รองรับการแสดงผลเอาต์พุต ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับการแสดงผล ได้แก่ Chromecast และแคสต์ทีวี ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่ไม่มีการรองรับจอแสดงผล ได้แก่ Chromecast Audio และ Google Home
HI_RES_AUDIO_SUPPORTED	สตริง รองรับเสียงความละเอียดสูง (สูงสุด 24 บิต / 96KHz)
IS_DV_SUPPORTED	สตริง รองรับ Dolby Vision
IS_HDR_SUPPORTED	สตริง รองรับวิดีโอ HDR
ข้อกําหนดในการให้บริการ	สตริง การรองรับการป้อนข้อมูลด้วยการสัมผัส ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับการป้อนข้อมูลด้วยการสัมผัส ได้แก่ Google Nest Hub และ Google Nest Hub Max
IS_GROUP	สตริง หากอุปกรณ์เป็นอุปกรณ์เสมือนและแสดงถึงเป้าหมายกลุ่ม ไม่ใช่อุปกรณ์จริง
IS_DEVICE_REGISTERED	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้บ่งชี้ว่าอุปกรณ์ Cast จดทะเบียนใน Play Developer Console
IS_CBCS_SUPPORT	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้ระบุว่ารองรับสคีม CBCS (SAMPLE-AES)
IS_DOLBY_ATMOS_SUPPORTED	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้ระบุว่ารองรับ Dolby Atmos ผ่านการส่งผ่านเสียง

เหตุผลที่ยกเลิกการเชื่อมต่อ

คงที่

สตริง

แสดงเหตุผลที่ยกเลิกการเชื่อมต่อ

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

ประเภทกิจกรรม

คงที่

สตริง

เหตุการณ์ของระบบที่ส่งโดย cast.framework.CastReceiverContext

ค่า
พร้อมให้บริการ	สตริง เริ่มทํางานเมื่อระบบพร้อมใช้งาน
ปิดเครื่อง	สตริง เริ่มทํางานเมื่อแอปพลิเคชันสิ้นสุดลง
เชื่อมต่อกับผู้ส่งแล้ว	สตริง เริ่มทํางานเมื่อผู้ส่งใหม่เชื่อมต่อแล้ว
ยกเลิกการเชื่อมต่อแล้ว	สตริง เริ่มทํางานเมื่อผู้ส่งยกเลิกการเชื่อมต่อ
ข้อผิดพลาด	สตริง เริ่มทํางานเมื่อเกิดข้อผิดพลาดของระบบ
ระบบมีการเปลี่ยนแปลง	สตริง เริ่มทํางานเมื่อระดับเสียงของระบบมีการเปลี่ยนแปลง
เปลี่ยนภาพ	สตริง เริ่มทํางานเมื่อระดับการเข้าถึงของแอปพลิเคชันมีการเปลี่ยนแปลง (เช่น หลังจากเปลี่ยนอินพุต HDMI หรือเมื่อทีวีปิดหรือเปิด และอุปกรณ์แคสต์เปิดอยู่) โปรดทราบว่า API นี้มีผลกระทบเช่นเดียวกับเหตุการณ์ "webkitvisiblechange" ที่ได้จากเบราว์เซอร์ ซึ่งจัดเตรียมเป็น API cast.framework.CastReceiverContext เพื่อความสะดวกและเพื่อหลีกเลี่ยงการใช้เหตุการณ์ที่คํานําหน้า webkit
มีการเปลี่ยนแปลง	สตริง เริ่มทํางานเมื่อสถานะสแตนด์บายของทีวีมีการเปลี่ยนแปลง เหตุการณ์นี้เกี่ยวข้องกับเหตุการณ์ cast.framework.system.EventType.VISIBILITY_CHANGED เนื่องจากหากทีวีอยู่ในโหมดสแตนด์บาย ระดับการเข้าถึงจะเป็น false สถานะระดับการมองเห็นจะละเอียดยิ่งขึ้นกว่าสถานะสแตนด์บาย (เนื่องจากระดับการมองเห็นมีการเลือกระดับช่องทีวีด้วย) แต่ตรวจไม่พบความเสถียรในทีวีทั้งหมด การสแตนด์บายสามารถใช้ได้ในกรณีเหล่านั้นเนื่องจากทีวีส่วนใหญ่ใช้งาน
วิดีโอมีการเปลี่ยนแปลงสูงสุด	สตริง
เริ่มความคิดเห็นแล้ว	สตริง เริ่มทํางานเมื่อระบบเริ่มสร้างรายงานความคิดเห็น

เปิดใช้งานจาก

คงที่

สตริง

ค่านี้แสดงถึงประเภทคําขอที่เปิดตัวรับผู้รับ

ค่า
ไม่ทราบ	สตริง ไม่สามารถกําหนดเจ้าของการเปิดตัวได้
ดิจิทัล	สตริง มีการเปิดแอปโดยคําขอ DIAL
แคสต์	สตริง แอปเปิดตัวโดยคําขอแคสต์ V2
ระบบคลาวด์	สตริง มีการเปิดแอปโดยคําขอผู้ช่วย (เช่น โดยคําสั่ง Google Assistant)

ประเภทข้อความ

คงที่

สตริง

ประเภทของข้อความที่กําหนดเอง

ค่า
STRING	สตริง ข้อความเป็นสตริงรูปแบบอิสระ แอปพลิเคชันมีหน้าที่เข้ารหัส/ถอดรหัสข้อมูลที่ส่ง
JSON	สตริง ข้อความมีการเข้ารหัส JSON การรับส่งข้อมูลพื้นฐานจะใช้สตริงที่เข้ารหัส JSON-

สถานะสแตนด์บาย

คงที่

สตริง

ค่านี้แสดงถึงสถานะสแตนด์บายปัจจุบันที่แพลตฟอร์มรายงาน อาจเป็น UNKNOWN หากแพลตฟอร์มแคสต์ระบุสถานะไม่ได้

ค่า
มาตรฐาน	สตริง
ไม่มาตรฐาน	สตริง
ไม่ทราบ	สตริง

สถานะของระบบ

คงที่

สตริง

ค่านี้แสดงถึงสถานะปัจจุบันของระบบ

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

สถานะการแสดงผล

คงที่

สตริง

ค่านี้แสดงถึงสถานะระดับการเข้าถึงปัจจุบันที่แพลตฟอร์มรายงาน อาจเป็น UNKNOWN หากแพลตฟอร์มแคสต์ระบุสถานะระดับการมองเห็นไม่ได้

ค่า
มองเห็นได้	สตริง
ไม่เห็น	สตริง
ไม่ทราบ	สตริง

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

ความสามารถของอุปกรณ์

คงที่

สตริง

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

ค่า
เสียง	สตริง การรองรับ Assistant แบบเสียง ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับเสียง Assistant ได้แก่ Google Home และ Google Home Mini
บลูทูธ	สตริง การรองรับบลูทูธ
แสดง	สตริง รองรับการแสดงผลเอาต์พุต ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับการแสดงผล ได้แก่ Chromecast และแคสต์ทีวี ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่ไม่มีการรองรับจอแสดงผล ได้แก่ Chromecast Audio และ Google Home
HI_RES_AUDIO_SUPPORTED	สตริง รองรับเสียงความละเอียดสูง (สูงสุด 24 บิต / 96KHz)
IS_DV_SUPPORTED	สตริง รองรับ Dolby Vision
IS_HDR_SUPPORTED	สตริง รองรับวิดีโอ HDR
ข้อกําหนดในการให้บริการ	สตริง การรองรับการป้อนข้อมูลด้วยการสัมผัส ตัวอย่างอุปกรณ์ที่พร้อมใช้งาน Cast ที่รองรับการป้อนข้อมูลด้วยการสัมผัส ได้แก่ Google Nest Hub และ Google Nest Hub Max
IS_GROUP	สตริง หากอุปกรณ์เป็นอุปกรณ์เสมือนและแสดงถึงเป้าหมายกลุ่ม ไม่ใช่อุปกรณ์จริง
IS_DEVICE_REGISTERED	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้บ่งชี้ว่าอุปกรณ์ Cast จดทะเบียนใน Play Developer Console
IS_CBCS_SUPPORT	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้ระบุว่ารองรับสคีม CBCS (SAMPLE-AES)
IS_DOLBY_ATMOS_SUPPORTED	สตริง เมื่อตั้งค่าเป็น true แฟล็กนี้ระบุว่ารองรับ Dolby Atmos ผ่านการส่งผ่านเสียง

เหตุผลที่ยกเลิกการเชื่อมต่อ

คงที่

สตริง

แสดงเหตุผลที่ยกเลิกการเชื่อมต่อ

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

ประเภทกิจกรรม

คงที่

สตริง

เหตุการณ์ของระบบที่ส่งโดย cast.framework.CastReceiverContext

ค่า
พร้อมให้บริการ	สตริง เริ่มทํางานเมื่อระบบพร้อมใช้งาน
ปิดเครื่อง	สตริง เริ่มทํางานเมื่อแอปพลิเคชันสิ้นสุดลง
เชื่อมต่อกับผู้ส่งแล้ว	สตริง เริ่มทํางานเมื่อผู้ส่งใหม่เชื่อมต่อแล้ว
ยกเลิกการเชื่อมต่อแล้ว	สตริง เริ่มทํางานเมื่อผู้ส่งยกเลิกการเชื่อมต่อ
ข้อผิดพลาด	สตริง เริ่มทํางานเมื่อเกิดข้อผิดพลาดของระบบ
ระบบมีการเปลี่ยนแปลง	สตริง เริ่มทํางานเมื่อระดับเสียงของระบบมีการเปลี่ยนแปลง
เปลี่ยนภาพ	สตริง เริ่มทํางานเมื่อระดับการเข้าถึงของแอปพลิเคชันมีการเปลี่ยนแปลง (เช่น หลังจากเปลี่ยนอินพุต HDMI หรือเมื่อทีวีปิดหรือเปิด และอุปกรณ์แคสต์เปิดอยู่) โปรดทราบว่า API นี้มีผลกระทบเช่นเดียวกับเหตุการณ์ "webkitvisiblechange" ที่ได้จากเบราว์เซอร์ ซึ่งจัดเตรียมเป็น API cast.framework.CastReceiverContext เพื่อความสะดวกและเพื่อหลีกเลี่ยงการใช้เหตุการณ์ที่คํานําหน้า webkit
มีการเปลี่ยนแปลง	สตริง เริ่มทํางานเมื่อสถานะสแตนด์บายของทีวีมีการเปลี่ยนแปลง เหตุการณ์นี้เกี่ยวข้องกับเหตุการณ์ cast.framework.system.EventType.VISIBILITY_CHANGED เนื่องจากหากทีวีอยู่ในโหมดสแตนด์บาย ระดับการเข้าถึงจะเป็น false สถานะระดับการมองเห็นจะละเอียดยิ่งขึ้นกว่าสถานะสแตนด์บาย (เนื่องจากระดับการมองเห็นมีการเลือกระดับช่องทีวีด้วย) แต่ตรวจไม่พบความเสถียรในทีวีทั้งหมด การสแตนด์บายสามารถใช้ได้ในกรณีเหล่านั้นเนื่องจากทีวีส่วนใหญ่ใช้งาน
วิดีโอมีการเปลี่ยนแปลงสูงสุด	สตริง
เริ่มความคิดเห็นแล้ว	สตริง เริ่มทํางานเมื่อระบบเริ่มสร้างรายงานความคิดเห็น

เปิดใช้งานจาก

คงที่

สตริง

ค่านี้แสดงถึงประเภทคําขอที่เปิดตัวรับผู้รับ

ค่า
ไม่ทราบ	สตริง ไม่สามารถกําหนดเจ้าของการเปิดตัวได้
ดิจิทัล	สตริง มีการเปิดแอปโดยคําขอ DIAL
แคสต์	สตริง แอปเปิดตัวโดยคําขอแคสต์ V2
ระบบคลาวด์	สตริง มีการเปิดแอปโดยคําขอผู้ช่วย (เช่น โดยคําสั่ง Google Assistant)

ประเภทข้อความ

คงที่

สตริง

ประเภทของข้อความที่กําหนดเอง

ค่า
STRING	สตริง ข้อความเป็นสตริงรูปแบบอิสระ แอปพลิเคชันมีหน้าที่เข้ารหัส/ถอดรหัสข้อมูลที่ส่ง
JSON	สตริง ข้อความมีการเข้ารหัส JSON การรับส่งข้อมูลพื้นฐานจะใช้สตริงที่เข้ารหัส JSON-

สถานะสแตนด์บาย

คงที่

สตริง

ค่านี้แสดงถึงสถานะสแตนด์บายปัจจุบันที่แพลตฟอร์มรายงาน อาจเป็น UNKNOWN หากแพลตฟอร์มแคสต์ระบุสถานะไม่ได้

ค่า
มาตรฐาน	สตริง
ไม่มาตรฐาน	สตริง
ไม่ทราบ	สตริง

สถานะของระบบ

คงที่

สตริง

ค่านี้แสดงถึงสถานะปัจจุบันของระบบ

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

สถานะการแสดงผล

คงที่

สตริง

ค่านี้แสดงถึงสถานะระดับการเข้าถึงปัจจุบันที่แพลตฟอร์มรายงาน อาจเป็น UNKNOWN หากแพลตฟอร์มแคสต์ระบุสถานะระดับการมองเห็นไม่ได้

ค่า
มองเห็นได้	สตริง
ไม่เห็น	สตริง
ไม่ทราบ	สตริง