Ứng dụng dành cho người gửi Google Cast kiểm soát việc phát trên thiết bị nhận bằng cách gửi thông báo ở định dạng JSON đến ứng dụng nhận. Tương tự như vậy, người nhận cũng gửi thư lại cho người gửi dưới dạng JSON. Tin nhắn có thể là các lệnh từ người gửi để thay đổi trạng thái trình phát, phản hồi cho những lệnh đó từ trình nhận hoặc cấu trúc dữ liệu mô tả nội dung nghe nhìn cho ứng dụng của trình nhận.
Theo Điều khoản dịch vụ bổ sung dành cho nhà phát triển SDK Google Cast, ứng dụng nội dung nghe nhìn Cast phải sử dụng các thông báo này như được xác định ở đây để điều khiển việc phát nội dung nghe nhìn trên bộ thu. Làm như vậy sẽ mang lại cho ứng dụng đa phương tiện trải nghiệm người dùng nhất quán trên các nền tảng, đồng thời đảm bảo rằng ứng dụng Truyền sẽ hỗ trợ các trường hợp sử dụng mới và trong tương lai. Các cấu trúc này cũng hỗ trợ dữ liệu tuỳ chỉnh (khi thích hợp), đồng thời ứng dụng có thể xác định thông báo riêng cho các lệnh không được SDK hỗ trợ.
Không gian tên cho thông báo phát nội dung nghe nhìn được xác định là urn:x-cast:com.google.cast.media.
Lưu ý: Thông báo và cấu trúc trong bản đặc tả kỹ thuật này có kích thước tối đa ngầm định được xác định bằng kích thước tối đa của thông báo truyền tải. Không có giới hạn nào đối với từng trường riêng lẻ. Kích thước tối đa của thông báo truyền tải hiện là 64 KBytes.
Các cấu trúc dữ liệu không gian tên phổ biến
Tập hợp mẹ của các cấu trúc dữ liệu mà tất cả cấu phần phần mềm không gian tên nội dung nghe nhìn sử dụng sẽ được xác định trong một không gian tên chung.
Bài đăng có hình ảnh
Đây là nội dung mô tả hình ảnh, bao gồm một lượng nhỏ siêu dữ liệu để cho phép ứng dụng gửi lựa chọn hình ảnh, tuỳ thuộc vào cách ứng dụng hiển thị hình ảnh.
Bạn chỉ chọn chiều cao và chiều rộng cho một mục trong một mảng Hình ảnh. Ví dụ: nếu có một mục được trả về thì mục đó là không bắt buộc; nếu có hai mục được trả về, một mục phải chỉ định chiều cao và chiều rộng, nhưng người gửi có thể chọn sử dụng tuỳ chọn "mặc định" nếu mục đó không giống với mục được chuyển kèm theo các tham số cụ thể.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| url | URI | URI cho hình ảnh |
| height (chiều cao) | số nguyên | không bắt buộc Chiều cao của hình ảnh |
| chiều_rộng | số nguyên | optional Chiều rộng của hình ảnh |
Âm lượng
Âm lượng luồng nội dung nghe nhìn. Dùng cho các hiệu ứng mờ dần/hiệu ứng mờ dần trong luồng nội dung đa phương tiện. (Lưu ý: âm lượng hệ thống được thay đổi bằng cách sử dụng API người gửi.) Bạn không được dùng âm lượng của luồng phát trực tiếp cùng với thanh trượt âm lượng hoặc các nút âm lượng để điều chỉnh âm lượng của thiết bị. Bạn phải truyền ít nhất một trong các thông số sau đây để thay đổi âm lượng luồng.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| cấp độ | gấp đôi | không bắt buộc Mức âm lượng luồng hiện tại ở dạng giá trị từ 0 đến 1,0, trong đó 1 là âm lượng tối đa. |
| bị ẩn | boolean | không bắt buộc Liệu Thiết bị truyền có đang tắt tiếng hay không, bất kể mức âm lượng |
Cấu trúc dữ liệu không gian tên nội dung nghe nhìn
Những thông báo này mô tả trạng thái của trình phát nội dung đa phương tiện. Không gian tên là urn:x-cast:com.google.cast.media.
MediaInformation
Cấu trúc dữ liệu này mô tả một luồng nội dung nghe nhìn.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| contentId | string | Giá trị nhận dạng dành riêng cho dịch vụ của nội dung mà trình phát đa phương tiện hiện đang tải. Đây là một chuỗi biểu mẫu tuỳ ý và dành riêng cho ứng dụng. Trong hầu hết các trường hợp, đây sẽ là URL đến nội dung nghe nhìn nhưng người gửi có thể chọn truyền một chuỗi mà người nhận có thể hiểu đúng. Độ dài tối đa: 1k |
| streamType | enum (chuỗi) |
Mô tả loại cấu phần phần mềm nội dung nghe nhìn dưới dạng một trong các loại sau:
|
| contentType | string | Loại nội dung MIME của nội dung nghe nhìn đang phát |
| siêu dữ liệu | đối tượng | không bắt buộc Đối tượng siêu dữ liệu nội dung đa phương tiện, một trong các đối tượng sau: |
| thời lượng | gấp đôi | không bắt buộc Thời lượng của sự kiện phát trực tiếp hiện đang phát tính bằng giây |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng được xác định bởi ứng dụng của người gửi hoặc ứng dụng nhận |
GenericMediaMetadata
Mô tả cấu phần phần mềm nội dung đa phương tiện chung.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| metadataType | số nguyên | 0 (giá trị duy nhất) |
| tiêu đề | string | không bắt buộc Tiêu đề mô tả nội dung. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| phụ đề | string | không bắt buộc : Tiêu đề phụ mang tính mô tả của nội dung. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| hình ảnh | Hình ảnh[] | không bắt buộc : Mảng URL đến một hình ảnh liên kết với nội dung. Người gửi có thể cung cấp giá trị ban đầu của trường trong thông báo Tải. Phải cung cấp kích thước được đề xuất |
| releaseDate | chuỗi (ISO 8601) | không bắt buộc Ngày và giờ phát hành nội dung này theo ISO 8601. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
MovieMediaMetadata
Mô tả cấu phần phần mềm nội dung đa phương tiện của phim.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| metadataType | số nguyên | 1 (giá trị duy nhất) |
| tiêu đề | string | không bắt buộc Tiêu đề mô tả nội dung. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| phụ đề | string | không bắt buộc : Tiêu đề phụ mang tính mô tả của nội dung. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| studio | string | không bắt buộc là Studio phát hành nội dung. Trình phát có thể truy xuất studio một cách độc lập bằng content_id hoặc có thể do người gửi cung cấp trong thông báo Tải |
| hình ảnh | Hình ảnh[] | không bắt buộc : Mảng URL đến một hình ảnh liên kết với nội dung. Người gửi có thể cung cấp giá trị ban đầu của trường trong thông báo Tải. Phải cung cấp kích thước được đề xuất |
| releaseDate | chuỗi (ISO 8601) | không bắt buộc Ngày và giờ phát hành nội dung này theo ISO 8601. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
TvShowMediaMetadata
Mô tả cấu phần nội dung đa phương tiện của một tập chương trình truyền hình.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| metadataType | số nguyên | 2 (giá trị duy nhất) |
| seriesTitle | string | không bắt buộc Tiêu đề mô tả của loạt phim truyền hình. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| phụ đề | string | không bắt buộc Có phụ đề mô tả cho tập phim truyền hình. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| mùa | số nguyên | không bắt buộc Số phần của chương trình truyền hình |
| tập | số nguyên | không bắt buộc Số tập (trong phần) của chương trình truyền hình |
| hình ảnh | Hình ảnh[] | không bắt buộc : Mảng URL đến một hình ảnh liên kết với nội dung. Người gửi có thể cung cấp giá trị ban đầu của trường trong thông báo Tải. Phải cung cấp kích thước được đề xuất |
| originalAirDate | chuỗi (ISO 8601) | không bắt buộc Ngày giờ phát hành tập này theo ISO 8601. Trình phát có thể truy xuất nativeAirDate một cách độc lập bằng cách sử dụng content_id hoặc do người gửi cung cấp trong thông báo Tải |
MusicTrackMediaMetadata
Mô tả cấu phần nội dung nghe nhìn của bản nhạc.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| metadataType | số nguyên | 3 (giá trị duy nhất) |
| albumName | string | không bắt buộc Album hoặc bộ sưu tập mà bản nhạc này được lấy từ đó. Trình phát có thể truy xuất albumName một cách độc lập bằng cách sử dụng content_id hoặc do người gửi cung cấp trong thông báo Tải |
| tiêu đề | string | không bắt buộc Tên bản nhạc (ví dụ: tên bài hát). Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| albumArtist | string | không bắt buộc Tên của nghệ sĩ liên kết với đĩa nhạc có bản nhạc này. Trình phát có thể truy xuất albumArtist một cách độc lập bằng content_id hoặc do người gửi cung cấp trong thông báo Load |
| nghệ sĩ | string | không bắt buộc Tên của nghệ sĩ liên kết với bản nhạc đa phương tiện. Trình phát có thể truy xuất nghệ sĩ một cách độc lập bằng content_id hoặc có thể do người gửi cung cấp trong thông báo Tải |
| trình soạn | string | optional Tên của nhà soạn nhạc liên kết với bản nhạc đa phương tiện. Trình phát có thể truy xuất nhà soạn nhạc một cách độc lập bằng cách sử dụng content_id hoặc do người gửi cung cấp trong thông báo Tải |
| trackNumber | số nguyên | optional Số lượng bản nhạc trong album |
| discNumber | số nguyên | không bắt buộc Số lượng âm lượng (ví dụ: một đĩa) của album |
| hình ảnh | Hình ảnh[] | không bắt buộc : Mảng URL đến một hình ảnh liên kết với nội dung. Người gửi có thể cung cấp giá trị ban đầu của trường trong thông báo Tải. Phải cung cấp kích thước được đề xuất |
| releaseDate | chuỗi (ISO 8601) | không bắt buộc Ngày và giờ phát hành nội dung này theo ISO 8601. Trình phát có thể truy xuất releaseDate một cách độc lập bằng content_id hoặc có thể do người gửi cung cấp trong thông báo Load |
PhotoMediaMetadata
Mô tả cấu phần phần mềm đa phương tiện chụp ảnh.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| metadataType | số nguyên | 4 (giá trị duy nhất) |
| tiêu đề | string | không bắt buộc Tiêu đề của bức ảnh. Trình phát có thể truy xuất tiêu đề một cách độc lập bằng cách sử dụng content_id hoặc tiêu đề có thể do người gửi cung cấp trong thông báo Tải |
| nghệ sĩ | string | không bắt buộc Tên của nhiếp ảnh gia. Trình phát có thể truy xuất nghệ sĩ một cách độc lập bằng content_id hoặc có thể do người gửi cung cấp trong thông báo Tải |
| vị trí | string | không bắt buộc Vị trí bằng ngôn ngữ nơi chụp ảnh; ví dụ: "Madrid, Tây Ban Nha". Trình phát có thể truy xuất vị trí một cách độc lập bằng cách sử dụng content_id hoặc vị trí có thể do người gửi cung cấp trong thông báo Tải |
| latitude | gấp đôi | không bắt buộc : Giá trị vĩ độ địa lý cho vị trí chụp ảnh. Trình phát có thể truy xuất vĩ độ một cách độc lập bằng content_id hoặc do người gửi cung cấp trong thông báo Tải |
| longitude | gấp đôi | không bắt buộc : Giá trị kinh độ địa lý cho vị trí chụp ảnh. Trình phát có thể truy xuất kinh độ một cách độc lập bằng cách sử dụng content_id hoặc kinh độ có thể do người gửi cung cấp trong thông báo Tải |
| chiều_rộng | số nguyên | không bắt buộc Chiều rộng tính bằng pixel của ảnh. Trình phát có thể truy xuất chiều rộng một cách độc lập bằng cách sử dụng content_id hoặc chiều rộng có thể do người gửi cung cấp trong thông báo Tải |
| height (chiều cao) | số nguyên | không bắt buộc Chiều cao tính bằng pixel của ảnh. Trình phát có thể truy xuất chiều cao một cách độc lập bằng cách sử dụng content_id hoặc chiều cao có thể do người gửi cung cấp trong thông báo Tải |
| creationDateTime | chuỗi (ISO 8601) | không bắt buộc Ngày giờ chụp ảnh ISO 8601. Trình phát có thể tự truy xuất generateDateTime bằng cách sử dụng content_id hoặc có thể do người gửi cung cấp trong thông báo Load |
MediaStatus
Mô tả trạng thái hiện tại của cấu phần phần mềm nội dung đa phương tiện liên quan đến phiên.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | ID duy nhất để phát lại phiên cụ thể này. Mã nhận dạng này do trình thu đặt ở trạng thái TẢI và có thể được dùng để xác định một phiên bản cụ thể của lượt phát. Ví dụ: 2 lượt phát "Wish bạn was here" (Ước gì bạn ở đây) trong cùng một phiên sẽ có một mediaSessionId duy nhất. |
| media | MediaInformation | không bắt buộc (đối với thông báo trạng thái) Thông tin mô tả đầy đủ về nội dung đang được phát lại. Chỉ được trả về trong thông báo trạng thái nếu MediaInformation đã thay đổi. |
| playbackRate | float | Cho biết liệu thời gian phát nội dung nghe nhìn có đang diễn ra hay không và với tốc độ nào. Thời gian này không phụ thuộc vào trạng thái trình phát vì thời gian phát nội dung đa phương tiện có thể dừng ở bất kỳ trạng thái nào. 1.0 là thời gian thông thường, 0.5 là chuyển động chậm |
| playerState | enum (chuỗi) | Mô tả trạng thái của người chơi theo một trong những trạng thái sau:
|
| idleReason | enum (chuỗi) | không bắt buộc Nếu PlayerState là IDLE và lý do khiến nó trở thành IDLE, thuộc tính này được cung cấp. Nếu người chơi ở trạng thái IDLE vì mới bắt đầu, thuộc tính này sẽ không được cung cấp; nếu người chơi ở bất kỳ tiểu bang nào khác, không được cung cấp thuộc tính này. Các giá trị sau đây được áp dụng:
|
| currentTime | gấp đôi | Vị trí hiện tại của trình phát nội dung đa phương tiện kể từ đầu nội dung (tính bằng giây). Nếu đây là nội dung phát trực tiếp thì trường này biểu thị thời gian tính bằng giây kể từ khi bắt đầu sự kiện mà người chơi đã biết. |
| supportedMediaCommands | flags | Cờ mô tả những lệnh phát nội dung đa phương tiện mà trình phát nội dung đa phương tiện hỗ trợ:
Các tổ hợp được mô tả dưới dạng tổng; ví dụ: Tạm dừng+Tìm kiếm+StreamVolume+Mute == 15. |
| volume | Âm lượng | Âm lượng phát trực tiếp |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |
Lệnh từ người gửi đến người nhận
Những lệnh này sẽ điều khiển trình phát nội dung đa phương tiện. Tất cả đối tượng customData trong các thông báo dưới đây đều phải là không bắt buộc (nghĩa là trình thu sẽ xuống cấp đúng cách nếu dữ liệu không được truyền). Việc này sẽ cho phép các ứng dụng điều khiển từ xa thông thường hoạt động bình thường.
Tải
Tải nội dung mới vào trình phát nội dung đa phương tiện.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | TẢI (chỉ có giá trị) |
| media | MediaInformation | Siêu dữ liệu (bao gồm cả contentId) của nội dung nghe nhìn cần tải |
| tự động phát | boolean | không bắt buộc (mặc định là đúng) Nếu bạn chỉ định thông số tự động phát, thì trình phát nội dung đa phương tiện sẽ bắt đầu phát nội dung khi được tải. Ngay cả khi tính năng tự động phát không được chỉ định, việc triển khai trình phát nội dung đa phương tiện có thể chọn để bắt đầu phát ngay lập tức. Nếu bắt đầu phát, trạng thái trình phát trong phản hồi phải được đặt thành ĐANG HOẠT ĐỘNG, nếu không thì bạn phải đặt trạng thái này thành TẠM DỪNG |
| currentTime | gấp đôi | không bắt buộc Số giây kể từ khi bắt đầu nội dung. Nếu nội dung là nội dung phát trực tiếp và vị trí không được chỉ định, thì sự kiện phát trực tiếp sẽ bắt đầu tại vị trí phát trực tiếp |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái người chơi không hợp lệ Không tải được Đã huỷ tải |
Tạm dừng
Tạm dừng phát nội dung hiện tại. Kích hoạt thông báo sự kiện STATUS cho tất cả các ứng dụng của người gửi.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã của phiên phát nội dung đa phương tiện sẽ bị tạm dừng |
| requestId | số nguyên | Mã của yêu cầu, để dùng để liên kết yêu cầu/phản hồi |
| loại | string | PAUSE (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái trình phát không hợp lệ |
Tua
Đặt vị trí hiện tại trong luồng. Kích hoạt thông báo sự kiện STATUS cho tất cả các ứng dụng của người gửi. Nếu vị trí được cung cấp nằm ngoài phạm vi vị trí hợp lệ của nội dung hiện tại, thì người chơi nên chọn một vị trí hợp lệ càng gần vị trí được yêu cầu càng tốt.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã của phiên phát nội dung đa phương tiện có đặt vị trí của luồng nội dung |
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | SeeK (chỉ giá trị) |
| resumeState | enum (chuỗi) | optional Nếu bạn không đặt chế độ này, trạng thái phát sẽ không thay đổi; các giá trị sau được áp dụng:
|
| currentTime | gấp đôi | không bắt buộc Số giây kể từ khi bắt đầu nội dung. Nếu nội dung là nội dung phát trực tiếp và vị trí không được chỉ định, thì sự kiện phát trực tiếp sẽ bắt đầu tại vị trí phát trực tiếp |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái trình phát không hợp lệ |
Dừng
Dừng phát nội dung hiện tại. Kích hoạt thông báo sự kiện STATUS cho tất cả các ứng dụng của người gửi. Sau lệnh này, nội dung sẽ không còn được tải và mediaSessionId bị vô hiệu hoá.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã của phiên phát nội dung nghe nhìn sẽ dừng |
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | STOP (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái trình phát không hợp lệ |
Phát
Bắt đầu phát nội dung đã được tải bằng lệnh gọi tải, quá trình phát được tiếp tục từ vị trí thời gian hiện tại.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã của phiên phát nội dung đa phương tiện của nội dung sẽ phát |
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | PLAY (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái trình phát không hợp lệ |
Lấy thông tin trạng thái
Truy xuất trạng thái nội dung nghe nhìn.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | không bắt buộc Mã phiên phát nội dung đa phương tiện của nội dung nghe nhìn mà hệ thống sẽ trả về trạng thái nội dung đa phương tiện. Nếu không có trạng thái nào được cung cấp, thì trạng thái cho tất cả các mã phiên phát nội dung đa phương tiện sẽ được cung cấp. |
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | GET_STATUS (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Thông báo MediaStatus đến người gửi đã yêu cầu thông báo này | Không có | Không có | Không có |
SetVolume
Đặt âm lượng luồng đa phương tiện. Dùng cho các hiệu ứng mờ dần/hiệu ứng mờ dần trong luồng nội dung đa phương tiện. (Lưu ý: âm lượng của trình nhận được thay đổi bằng cách sử dụng setVolume của người gửi web.) Bạn không được dùng âm lượng của sự kiện phát trực tiếp cùng với thanh trượt âm lượng hoặc các nút âm lượng để điều chỉnh âm lượng của thiết bị. Việc thay đổi âm lượng luồng sẽ không kích hoạt bất kỳ giao diện người dùng nào trên bộ thu.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã phiên phát nội dung nghe nhìn của nội dung mà âm lượng luồng được thay đổi |
| requestId | số nguyên | Mã của yêu cầu, để liên kết yêu cầu và phản hồi |
| loại | string | VOLUME (chỉ giá trị) |
| volume | Âm lượng | Âm lượng phát trực tiếp |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng gửi xác định |
| Phản hồi | Điều kiện kích hoạt | Truyền phát | Lỗi |
|---|---|---|---|
| Không có | Thay đổi trạng thái bộ thu | Thông báo về việc thay đổi trạng thái nội dung nghe nhìn | Trạng thái trình phát không hợp lệ |
Tin nhắn từ người nhận đến người gửi
Người nhận gửi hai loại thông báo:
- Lỗi: Thông báo Unicast được gửi khi có phản hồi lỗi cho một yêu cầu của người gửi.
- Trạng thái: Thông báo phát đi.
- Hậu quả của hành động do người gửi khởi tạo. Sẽ chứa requestId của yêu cầu đã gây ra thay đổi.
- Tự phát: Ví dụ như do thay đổi được kích hoạt bởi ứng dụng nhận. RequestId sẽ là 0.
Lỗi: Trạng thái trình phát không hợp lệ
Được gửi khi không thể thực hiện yêu cầu của người gửi vì trình phát không ở trạng thái hợp lệ. Ví dụ: nếu ứng dụng chưa tạo thành phần nội dung đa phương tiện.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã của yêu cầu đã tạo ra lỗi này |
| loại | string | INVALID_PLAYER_STATE (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |
Lỗi: Không tải được
Gửi khi yêu cầu tải không thành công. Trạng thái trình phát sẽ là IDLE.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã của yêu cầu đã tạo ra lỗi này |
| loại | string | TẢI_FAILED (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |
Lỗi: Đã huỷ tải
Được gửi khi yêu cầu tải bị huỷ (yêu cầu tải thứ hai đã được nhận).
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã của yêu cầu đã tạo ra lỗi này |
| loại | string | TẢI_CANCELLED (chỉ giá trị) |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |
Lỗi: Yêu cầu không hợp lệ
Được gửi khi yêu cầu không hợp lệ (ví dụ: loại yêu cầu không xác định).
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã của yêu cầu đã tạo ra lỗi này |
| loại | string | INVALID_REQUEST (chỉ giá trị) |
| lý do | Enum (chuỗi) | Giá trị:
|
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |
Trạng thái của nội dung nghe nhìn
Được gửi sau khi trạng thái thay đổi hoặc sau khi yêu cầu trạng thái nội dung nghe nhìn. Chỉ các đối tượng MediaStatus đã thay đổi hoặc được yêu cầu mới được gửi.
| Tên | Loại | Nội dung mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng dùng để liên kết phản hồi trạng thái này với yêu cầu tạo ra nó hoặc 0 nếu thông báo trạng thái là tự phát (không được kích hoạt bởi yêu cầu của người gửi). Ứng dụng của người gửi sẽ tạo các mã yêu cầu duy nhất bằng cách chọn một số ngẫu nhiên và liên tục tăng số đó lên (chúng sẽ không sử dụng số 0). |
| loại | string | MEDIA_STATUS (chỉ giá trị) |
| trạng thái | MediaStatus[] | Loạt đối tượng Trạng thái phương tiện. LƯU Ý: thành phần đa phương tiện trong MediaStatus sẽ chỉ được trả về nếu đã thay đổi. |
| customData | đối tượng | không bắt buộc blob dữ liệu dành riêng cho ứng dụng do ứng dụng nhận xác định |