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

cast.เฟรมเวิร์ก.ระบบ

Namespace   static

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

คลาส

ApplicationData

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

เหตุการณ์

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

FeedbackStartedEvent

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

MaxVideoResolutionChangedEvent

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

ข้อความ

ข้อความที่กำหนดเองที่ได้รับจากผู้ส่ง หากต้องการฟังเหตุการณ์ที่กำหนดเอง ให้ใช้เมธอด cast.framework.CastReceiverContext#addCustomMessageListener

ReadyEvent

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

ผู้ส่ง

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

SenderConnectedEvent

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

SenderDisconnectedEvent

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

ShutdownEvent

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

StandbyChangedEvent

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

SystemVolumeChangedEvent

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

SystemVolumeData

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

VisibilityChangedEvent

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

การแจกแจง

DeviceCapabilities

คงที่

สตริง

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

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

DisconnectReason

คงที่

สตริง

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

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

EventType

คงที่

สตริง

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

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

LaunchedFrom

คงที่

สตริง

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

ค่า
ไม่ทราบ	สตริง ไม่สามารถระบุเจ้าของการเปิดตัวได้
โทรออก	สตริง แอปเปิดขึ้นโดยคำขอ DIAL
CAST	สตริง แอปเปิดขึ้นตามคำขอ Cast V2
เมฆ	สตริง แอปเปิดขึ้นตามคำขอ Assistant (เช่น ด้วยคำสั่ง Google Assistant)

MessageType

คงที่

สตริง

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

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

StandbyState

คงที่

สตริง

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

ค่า
สแตนด์บาย	สตริง
NOT_STANDBY	สตริง
ไม่ทราบ	สตริง

SystemState

คงที่

สตริง

ข้อมูลนี้แสดงสถานะปัจจุบันของระบบ

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

VisibilityState

คงที่

สตริง

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

ค่า
เปิดเผย	สตริง
NOT_VISIBLE	สตริง
ไม่ทราบ	สตริง

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

DeviceCapabilities

คงที่

สตริง

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

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

DisconnectReason

คงที่

สตริง

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

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

EventType

คงที่

สตริง

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

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

LaunchedFrom

คงที่

สตริง

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

ค่า
ไม่ทราบ	สตริง ไม่สามารถระบุเจ้าของการเปิดตัวได้
โทรออก	สตริง แอปเปิดขึ้นโดยคำขอ DIAL
CAST	สตริง แอปเปิดขึ้นตามคำขอ Cast V2
เมฆ	สตริง แอปเปิดขึ้นตามคำขอ Assistant (เช่น ด้วยคำสั่ง Google Assistant)

MessageType

คงที่

สตริง

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

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

StandbyState

คงที่

สตริง

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

ค่า
สแตนด์บาย	สตริง
NOT_STANDBY	สตริง
ไม่ทราบ	สตริง

SystemState

คงที่

สตริง

ข้อมูลนี้แสดงสถานะปัจจุบันของระบบ

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

VisibilityState

คงที่

สตริง

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

ค่า
เปิดเผย	สตริง
NOT_VISIBLE	สตริง
ไม่ทราบ	สตริง