cast. framework. system
Đây là vùng chứa tên cast.framework.system.
Lớp
ApplicationData
Siêu dữ liệu mô tả dữ liệu của ứng dụng đã khởi chạy.
Sự kiện
Một sự kiện do cast.framework.CastReceiverContext gửi đi, trong đó có thông tin hệ thống.
FeedbackStartedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi hệ thống bắt đầu tạo báo cáo phản hồi.
MaxVideoResolutionChangedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi hệ thống cần cập nhật hạn chế về độ phân giải video tối đa.
Tin nhắn
Một thông báo tuỳ chỉnh nhận được từ người gửi. Để theo dõi các sự kiện tuỳ chỉnh, hãy sử dụng phương thức cast.framework.CastReceiverContext#addCustomMessageListener.
ReadyEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi hệ thống đã sẵn sàng.
Người gửi
Đây là dữ liệu của một thiết bị gửi đã kết nối.
SenderConnectedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi một người gửi được kết nối.
SenderDisconnectedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi người gửi bị ngắt kết nối.
ShutdownEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi ứng dụng tắt.
StandbyChangedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi TV chuyển sang hoặc rời khỏi trạng thái chờ, vì vậy, ứng dụng phải luôn xác minh thuộc tính isStandby. Để biết trạng thái thực tế là không xác định hay không, ứng dụng có thể gọi phương thức cast.framework.CastReceiverContext#getStandbyState.
SystemVolumeChangedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi âm lượng hệ thống thay đổi.
SystemVolumeData
Đây là dữ liệu về ổ đĩa hệ thống.
VisibilityChangedEvent
Một sự kiện do cast.framework.CastReceiverContext gửi đi khi chế độ hiển thị của ứng dụng thay đổi – ví dụ: khi đầu vào HDMI thay đổi hoặc TV tắt.
Bảng liệt kê
DeviceCapabilities
chuỗi
Mô tả các chức năng của chế độ thiết lập hiện tại, bao gồm thiết bị có thể truyền và thiết bị hiển thị (nếu có) mà thiết bị đó kết nối.
Giá trị |
|
|---|---|
|
AUDIO_ASSISTANT |
chuỗi Hỗ trợ Trợ lý âm thanh. Ví dụ về các thiết bị hỗ trợ Cast có Trợ lý âm thanh bao gồm Google Home và Google Home Mini. |
|
BLUETOOTH_SUPPORTED |
chuỗi Hỗ trợ Bluetooth. |
|
DISPLAY_SUPPORTED |
chuỗi Hỗ trợ đầu ra hiển thị. Ví dụ về các thiết bị hỗ trợ truyền có màn hình bao gồm Chromecast và TV có tính năng truyền. Ví dụ về các thiết bị có thể truyền nhưng không hỗ trợ màn hình là Chromecast Audio và Google Home. |
|
HI_RES_AUDIO_SUPPORTED |
chuỗi Hỗ trợ âm thanh có độ phân giải cao (lên đến 24 bit / 96 KHz). |
|
IS_DV_SUPPORTED |
chuỗi Hỗ trợ Dolby Vision. |
|
IS_HDR_SUPPORTED |
chuỗi Hỗ trợ video HDR. |
|
CAST_LITE_ONLY |
chuỗi Thiết bị này có đang chạy trên nền tảng chỉ có âm thanh hay không. Một số API có thể không được hỗ trợ đầy đủ trên những nền tảng như vậy. |
|
DPAD_INPUT_SUPPORTED |
chuỗi Thiết bị này có hỗ trợ cơ chế đầu vào hay không, chẳng hạn như DPAD mở khoá. |
|
TOUCH_INPUT_SUPPORTED |
chuỗi Hỗ trợ thao tác chạm. Ví dụ về thiết bị có thể truyền và hỗ trợ thao tác chạm bao gồm Google Nest Hub và Google Nest Hub Max. |
|
IS_GROUP |
chuỗi Nếu thiết bị là một thiết bị ảo và đại diện cho một mục tiêu nhóm thay vì một thiết bị thực. |
|
IS_DEVICE_REGISTERED |
chuỗi Khi được đặt thành |
|
IS_CBCS_SUPPORTED |
chuỗi Khi được đặt thành |
|
IS_DOLBY_ATMOS_SUPPORTED |
chuỗi Khi được đặt thành |
DeviceInformation
chuỗi
Hằng số cho các khoá hợp lệ trong cast.framework.CastReceiverContext.DeviceInformationObj.
Giá trị |
|
|---|---|
|
MODEL_NAME |
chuỗi Tên của mẫu thiết bị (ví dụ: Google TV Streamer, Nest Hub, Nest Mini, v.v.) nếu có. "unknown" nếu không xác định được. |
|
BRAND_NAME |
chuỗi Tên thương hiệu của thiết bị (ví dụ: Google, LG, Sony, v.v.) nếu có. Một chuỗi trống nếu không xác định được. |
|
OS_NAME |
chuỗi Tên của hệ điều hành thiết bị (ví dụ: Android, Fuchsia, Linux, v.v.) nếu có. Một chuỗi trống nếu không xác định được, hoặc "không phải là thiết bị truyền" nếu đây không phải là thiết bị truyền. |
|
OS_VERSION |
chuỗi Phiên bản hệ điều hành của thiết bị (ví dụ: 14.0, v.v.) nếu có. Một chuỗi trống nếu không xác định được. |
|
MÔI TRƯỜNG |
chuỗi Loại môi trường mà thiết bị đang ở (ví dụ: nhà, ô tô, máy bay, khách sạn, v.v.) nếu biết. Thường là "trang chủ" đối với hầu hết các thiết bị. |
|
DEVICE_ID |
chuỗi Mã nhận dạng duy nhất của thiết bị nhận, nếu có. Sẽ có cùng giá trị với Mã nhận dạng thiết bị nhận Cast do Sender SDK hiển thị. Một chuỗi trống nếu không xác định. |
|
METADATA_FROM_FIRMWARE |
chuỗi Chương trình cơ sở có cung cấp thông tin thiết bị hay không. |
DisconnectReason
chuỗi
Biểu thị lý do ngắt kết nối.
Giá trị |
|
|---|---|
|
REQUESTED_BY_SENDER |
chuỗi Ứng dụng gửi đã chủ động yêu cầu đóng kết nối (thường do người dùng kích hoạt). |
|
ERROR (LỖI) |
chuỗi Đã xảy ra lỗi giao thức. |
|
KHÔNG XÁC ĐỊNH |
chuỗi Không rõ liệu người gửi có yêu cầu ngắt kết nối một cách thích hợp bằng cách gọi |
EventType
chuỗi
Các sự kiện hệ thống do cast.framework.CastReceiverContext gửi đi.
Giá trị |
|
|---|---|
|
SẴN SÀNG |
chuỗi Được kích hoạt khi hệ thống đã sẵn sàng. |
|
SHUTDOWN |
chuỗi Được kích hoạt khi ứng dụng bị chấm dứt. |
|
SENDER_CONNECTED |
chuỗi Được kích hoạt khi có một người gửi mới kết nối. |
|
SENDER_DISCONNECTED |
chuỗi Được kích hoạt khi người gửi đã ngắt kết nối. |
|
ERROR (LỖI) |
chuỗi Được kích hoạt khi có lỗi hệ thống. |
|
SYSTEM_VOLUME_CHANGED |
chuỗi Được kích hoạt khi âm lượng hệ thống thay đổi. |
|
VISIBILITY_CHANGED |
chuỗi Kích hoạt khi chế độ hiển thị của ứng dụng thay đổi (ví dụ: sau khi thay đổi nguồn đầu vào HDMI hoặc khi TV được bật hoặc tắt và thiết bị truyền có nguồn điện bên ngoài). Xin lưu ý rằng API này có tác dụng tương tự như sự kiện "webkitvisibilitychange" do trình duyệt tạo ra. Đây là API cast.framework.CastReceiverContext được cung cấp để thuận tiện và tránh phụ thuộc vào sự kiện có tiền tố webkit. |
|
STANDBY_CHANGED |
chuỗi Được kích hoạt khi trạng thái chờ của TV thay đổi. Sự kiện này có liên quan đến sự kiện cast.framework.system.EventType.VISIBILITY_CHANGED, vì nếu TV ở chế độ chờ, thì chế độ hiển thị sẽ là Các trạng thái hiển thị chi tiết hơn trạng thái chờ (vì trạng thái hiển thị cũng bao gồm lựa chọn kênh truyền hình) nhưng không được phát hiện một cách đáng tin cậy trên tất cả các TV. Bạn có thể sử dụng chế độ chờ trong những trường hợp đó vì hầu hết các TV đều triển khai chế độ này. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
chuỗi |
|
FEEDBACK_STARTED |
chuỗi Kích hoạt khi hệ thống bắt đầu tạo báo cáo phản hồi. |
LaunchedFrom
chuỗi
Đây là loại yêu cầu đã khởi chạy receiver.
Giá trị |
|
|---|---|
|
KHÔNG XÁC ĐỊNH |
chuỗi Không xác định được chủ sở hữu lượt khởi chạy. |
|
DIAL |
chuỗi Ứng dụng được khởi chạy bằng một yêu cầu DIAL. |
|
TRUYỀN |
chuỗi Ứng dụng được khởi chạy bằng một yêu cầu Cast phiên bản 2. |
|
CLOUD |
chuỗi Ứng dụng được khởi chạy theo yêu cầu của trợ lý (ví dụ: bằng lệnh của Trợ lý Google). |
MessageType
chuỗi
Các loại tin nhắn tuỳ chỉnh.
Giá trị |
|
|---|---|
|
STRING |
chuỗi Thông báo là các chuỗi dạng tự do. Ứng dụng chịu trách nhiệm mã hoá/giải mã thông tin được truyền. |
|
JSON |
chuỗi Thông báo được mã hoá bằng JSON. Phương thức truyền tải cơ bản sẽ sử dụng một chuỗi được mã hoá JSON. |
StandbyState
chuỗi
Đây là trạng thái chờ hiện tại do nền tảng báo cáo. Có thể là UNKNOWN nếu nền tảng Cast không xác định được trạng thái.
Giá trị |
|
|---|---|
|
CHẾ ĐỘ CHỜ |
chuỗi |
|
NOT_STANDBY |
chuỗi |
|
KHÔNG XÁC ĐỊNH |
chuỗi |
SystemState
chuỗi
Đây là trạng thái hiện tại của hệ thống.
Giá trị |
|
|---|---|
|
NOT_STARTED |
chuỗi Ứng dụng chưa được yêu cầu khởi động. |
|
STARTING_IN_BACKGROUND |
chuỗi Ứng dụng đang khởi động nhưng người dùng không thấy được. |
|
BẮT ĐẦU |
chuỗi Ứng dụng đang khởi động. |
|
SẴN SÀNG |
chuỗi Ứng dụng đang ở nền trước và sẵn sàng gửi cũng như nhận tin nhắn. |
|
STOPPING_IN_BACKGROUND |
chuỗi Ứng dụng dừng hoạt động khi ở chế độ nền. |
|
DỪNG |
chuỗi Ứng dụng đang dừng. |
VisibilityState
chuỗi
Đây là trạng thái hiển thị hiện tại do nền tảng báo cáo. Có thể là UNKNOWN nếu nền tảng Cast không xác định được trạng thái hiển thị.
Giá trị |
|
|---|---|
|
HIỆN |
chuỗi |
|
NOT_VISIBLE |
chuỗi |
|
KHÔNG XÁC ĐỊNH |
chuỗi |
Thuộc tính
DeviceCapabilities
chuỗi
Mô tả các chức năng của chế độ thiết lập hiện tại, bao gồm thiết bị có thể truyền và thiết bị hiển thị (nếu có) mà thiết bị đó kết nối.
Giá trị |
|
|---|---|
|
AUDIO_ASSISTANT |
chuỗi Hỗ trợ Trợ lý âm thanh. Ví dụ về các thiết bị hỗ trợ Cast có Trợ lý âm thanh bao gồm Google Home và Google Home Mini. |
|
BLUETOOTH_SUPPORTED |
chuỗi Hỗ trợ Bluetooth. |
|
DISPLAY_SUPPORTED |
chuỗi Hỗ trợ đầu ra hiển thị. Ví dụ về các thiết bị hỗ trợ truyền có màn hình bao gồm Chromecast và TV có tính năng truyền. Ví dụ về các thiết bị có thể truyền nhưng không hỗ trợ màn hình là Chromecast Audio và Google Home. |
|
HI_RES_AUDIO_SUPPORTED |
chuỗi Hỗ trợ âm thanh có độ phân giải cao (lên đến 24 bit / 96 KHz). |
|
IS_DV_SUPPORTED |
chuỗi Hỗ trợ Dolby Vision. |
|
IS_HDR_SUPPORTED |
chuỗi Hỗ trợ video HDR. |
|
CAST_LITE_ONLY |
chuỗi Thiết bị này có đang chạy trên nền tảng chỉ có âm thanh hay không. Một số API có thể không được hỗ trợ đầy đủ trên những nền tảng như vậy. |
|
DPAD_INPUT_SUPPORTED |
chuỗi Thiết bị này có hỗ trợ cơ chế đầu vào hay không, chẳng hạn như DPAD mở khoá. |
|
TOUCH_INPUT_SUPPORTED |
chuỗi Hỗ trợ thao tác chạm. Ví dụ về thiết bị có thể truyền và hỗ trợ thao tác chạm bao gồm Google Nest Hub và Google Nest Hub Max. |
|
IS_GROUP |
chuỗi Nếu thiết bị là một thiết bị ảo và đại diện cho một mục tiêu nhóm thay vì một thiết bị thực. |
|
IS_DEVICE_REGISTERED |
chuỗi Khi được đặt thành |
|
IS_CBCS_SUPPORTED |
chuỗi Khi được đặt thành |
|
IS_DOLBY_ATMOS_SUPPORTED |
chuỗi Khi được đặt thành |
DeviceInformation
chuỗi
Hằng số cho các khoá hợp lệ trong cast.framework.CastReceiverContext.DeviceInformationObj.
Giá trị |
|
|---|---|
|
MODEL_NAME |
chuỗi Tên của mẫu thiết bị (ví dụ: Google TV Streamer, Nest Hub, Nest Mini, v.v.) nếu có. "unknown" nếu không xác định được. |
|
BRAND_NAME |
chuỗi Tên thương hiệu của thiết bị (ví dụ: Google, LG, Sony, v.v.) nếu có. Một chuỗi trống nếu không xác định được. |
|
OS_NAME |
chuỗi Tên của hệ điều hành thiết bị (ví dụ: Android, Fuchsia, Linux, v.v.) nếu có. Một chuỗi trống nếu không xác định được, hoặc "không phải là thiết bị truyền" nếu đây không phải là thiết bị truyền. |
|
OS_VERSION |
chuỗi Phiên bản hệ điều hành của thiết bị (ví dụ: 14.0, v.v.) nếu có. Một chuỗi trống nếu không xác định được. |
|
MÔI TRƯỜNG |
chuỗi Loại môi trường mà thiết bị đang ở (ví dụ: nhà, ô tô, máy bay, khách sạn, v.v.) nếu biết. Thường là "trang chủ" đối với hầu hết các thiết bị. |
|
DEVICE_ID |
chuỗi Mã nhận dạng duy nhất của thiết bị nhận, nếu có. Sẽ có cùng giá trị với Mã nhận dạng thiết bị nhận Cast do Sender SDK hiển thị. Một chuỗi trống nếu không xác định. |
|
METADATA_FROM_FIRMWARE |
chuỗi Chương trình cơ sở có cung cấp thông tin thiết bị hay không. |
DisconnectReason
chuỗi
Biểu thị lý do ngắt kết nối.
Giá trị |
|
|---|---|
|
REQUESTED_BY_SENDER |
chuỗi Ứng dụng gửi đã chủ động yêu cầu đóng kết nối (thường do người dùng kích hoạt). |
|
ERROR (LỖI) |
chuỗi Đã xảy ra lỗi giao thức. |
|
KHÔNG XÁC ĐỊNH |
chuỗi Không rõ liệu người gửi có yêu cầu ngắt kết nối một cách thích hợp bằng cách gọi |
EventType
chuỗi
Các sự kiện hệ thống do cast.framework.CastReceiverContext gửi đi.
Giá trị |
|
|---|---|
|
SẴN SÀNG |
chuỗi Được kích hoạt khi hệ thống đã sẵn sàng. |
|
SHUTDOWN |
chuỗi Được kích hoạt khi ứng dụng bị chấm dứt. |
|
SENDER_CONNECTED |
chuỗi Được kích hoạt khi có một người gửi mới kết nối. |
|
SENDER_DISCONNECTED |
chuỗi Được kích hoạt khi người gửi đã ngắt kết nối. |
|
ERROR (LỖI) |
chuỗi Được kích hoạt khi có lỗi hệ thống. |
|
SYSTEM_VOLUME_CHANGED |
chuỗi Được kích hoạt khi âm lượng hệ thống thay đổi. |
|
VISIBILITY_CHANGED |
chuỗi Kích hoạt khi chế độ hiển thị của ứng dụng thay đổi (ví dụ: sau khi thay đổi nguồn đầu vào HDMI hoặc khi TV được bật hoặc tắt và thiết bị truyền có nguồn điện bên ngoài). Xin lưu ý rằng API này có tác dụng tương tự như sự kiện "webkitvisibilitychange" do trình duyệt tạo ra. Đây là API cast.framework.CastReceiverContext được cung cấp để thuận tiện và tránh phụ thuộc vào sự kiện có tiền tố webkit. |
|
STANDBY_CHANGED |
chuỗi Được kích hoạt khi trạng thái chờ của TV thay đổi. Sự kiện này có liên quan đến sự kiện cast.framework.system.EventType.VISIBILITY_CHANGED, vì nếu TV ở chế độ chờ, thì chế độ hiển thị sẽ là Các trạng thái hiển thị chi tiết hơn trạng thái chờ (vì trạng thái hiển thị cũng bao gồm lựa chọn kênh truyền hình) nhưng không được phát hiện một cách đáng tin cậy trên tất cả các TV. Bạn có thể sử dụng chế độ chờ trong những trường hợp đó vì hầu hết các TV đều triển khai chế độ này. |
|
MAX_VIDEO_RESOLUTION_CHANGED |
chuỗi |
|
FEEDBACK_STARTED |
chuỗi Kích hoạt khi hệ thống bắt đầu tạo báo cáo phản hồi. |
LaunchedFrom
chuỗi
Đây là loại yêu cầu đã khởi chạy receiver.
Giá trị |
|
|---|---|
|
KHÔNG XÁC ĐỊNH |
chuỗi Không xác định được chủ sở hữu lượt khởi chạy. |
|
DIAL |
chuỗi Ứng dụng được khởi chạy bằng một yêu cầu DIAL. |
|
TRUYỀN |
chuỗi Ứng dụng được khởi chạy bằng một yêu cầu Cast phiên bản 2. |
|
CLOUD |
chuỗi Ứng dụng được khởi chạy theo yêu cầu của trợ lý (ví dụ: bằng lệnh của Trợ lý Google). |
MessageType
chuỗi
Các loại tin nhắn tuỳ chỉnh.
Giá trị |
|
|---|---|
|
STRING |
chuỗi Thông báo là các chuỗi dạng tự do. Ứng dụng chịu trách nhiệm mã hoá/giải mã thông tin được truyền. |
|
JSON |
chuỗi Thông báo được mã hoá bằng JSON. Phương thức truyền tải cơ bản sẽ sử dụng một chuỗi được mã hoá JSON. |
StandbyState
chuỗi
Đây là trạng thái chờ hiện tại do nền tảng báo cáo. Có thể là UNKNOWN nếu nền tảng Cast không xác định được trạng thái.
Giá trị |
|
|---|---|
|
CHẾ ĐỘ CHỜ |
chuỗi |
|
NOT_STANDBY |
chuỗi |
|
KHÔNG XÁC ĐỊNH |
chuỗi |
SystemState
chuỗi
Đây là trạng thái hiện tại của hệ thống.
Giá trị |
|
|---|---|
|
NOT_STARTED |
chuỗi Ứng dụng chưa được yêu cầu khởi động. |
|
STARTING_IN_BACKGROUND |
chuỗi Ứng dụng đang khởi động nhưng người dùng không thấy được. |
|
BẮT ĐẦU |
chuỗi Ứng dụng đang khởi động. |
|
SẴN SÀNG |
chuỗi Ứng dụng đang ở nền trước và sẵn sàng gửi cũng như nhận tin nhắn. |
|
STOPPING_IN_BACKGROUND |
chuỗi Ứng dụng dừng hoạt động khi ở chế độ nền. |
|
DỪNG |
chuỗi Ứng dụng đang dừng. |
VisibilityState
chuỗi
Đây là trạng thái hiển thị hiện tại do nền tảng báo cáo. Có thể là UNKNOWN nếu nền tảng Cast không xác định được trạng thái hiển thị.
Giá trị |
|
|---|---|
|
HIỆN |
chuỗi |
|
NOT_VISIBLE |
chuỗi |
|
KHÔNG XÁC ĐỊNH |
chuỗi |
Loại trừu tượng
DeviceCapabilitiesObj
{audio_assistant: (boolean or undefined), bluetooth_supported: (boolean or undefined), display_supported: (boolean or undefined), hi_res_audio_supported: (boolean or undefined), is_dv_supported: (boolean or undefined), is_hdr_supported: (boolean or undefined), cast_lite_only: (boolean or undefined), dpad_input_supported: (boolean or undefined), touch_input_supported: (boolean or undefined), is_group: (boolean or undefined), remote_control_overlay_supported: (boolean or undefined), sleep_timer_overlay_supported: (boolean or undefined), app_foreground: (boolean or undefined), is_device_registered: (boolean or undefined), is_cbcs_supported: (boolean or undefined), is_dolby_atmos_supported: (boolean or undefined)}
Mô tả đối tượng do getDeviceCapabilities trả về
DeviceInformationObj
{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}
Mô tả đối tượng do getDeviceInformation trả về