Các ứng dụng gửi của Google Cast điều khiển hoạt động 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ự, bên nhận cũng gửi lại thông báo cho bên gửi, cũng ở định dạng JSON. Các thông báo có thể là lệnh của người gửi để thay đổi trạng thái của trình phát, phản hồi của người nhận đối với các lệnh đó hoặc cấu trúc dữ liệu mô tả nội dung nghe nhìn cho ứng dụng nhận.
Theo Điều khoản dịch vụ bổ sung dành cho nhà phát triển của Google Cast SDK, ứng dụng nội dung nghe nhìn Cast phải sử dụng những thông báo này như được xác định ở đây để kiểm soát việc phát nội dung nghe nhìn trên thiết bị nhận. Khi làm như vậy, ứng dụng đa phương tiện sẽ mang đến trải nghiệm nhất quán cho người dùng trên nhiều nền tảng và đả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 (nếu thích hợp) và ứng dụng có thể xác định thông báo riêng cho các lệnh mà SDK không hỗ trợ.
Không gian tên cho các 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 ý: Các thông báo và cấu trúc trong quy cách này có kích thước tối đa ngầm định do kích thước tối đa của thông báo truyền tải xác định, không có giới hạn cho từng trường. Kích thước tối đa của thư truyền tải hiện là 64 KB.
Cấu trúc dữ liệu không gian tên phổ biến
Một siêu tập hợp các cấu trúc dữ liệu được dùng bởi tất cả các cấu phần phần mềm không gian tên đa phương tiện được xác định trong một không gian tên chung.
Hình ảnh
Đây là nội dung mô tả về một hình ảnh, bao gồm một lượng nhỏ siêu dữ liệu để cho phép ứng dụng người gửi chọn hình ảnh, tuỳ thuộc vào cách ứng dụng đó sẽ hiển thị hình ảnh.
Chiều cao và chiều rộng là không bắt buộc chỉ đối với một mục trong mảng Hình ảnh. Ví dụ: nếu chỉ có một mục được trả về, thì các mục đó là không bắt buộc; nếu có hai mục được trả về, thì 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 lựa chọn "mặc định" nếu không thích mục được truyền bằng các thông số cụ thể.
| Tên | Loại | Mô tả |
|---|---|---|
| url | URI | URI cho hình ảnh |
| height | số nguyên | không bắt buộc Chiều cao của hình ảnh |
| width | số nguyên | không bắt buộc 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 hiệu ứng mờ dần/hiện dần trên luồng nội dung nghe nhìn. (Lưu ý: âm lượng hệ thống được thay đổi bằng API người gửi.) Bạn không được dùng âm lượng luồng kết hợp với thanh trượt âm lượng hoặc các nút âm lượng để điều khiển âm lượng của thiết bị. Bạn phải truyền ít nhất một trong các tham số sau để thay đổi âm lượng của luồng phát.
| Tên | Loại | Mô tả |
|---|---|---|
| level | gấp đôi | không bắt buộc Mức âm lượng hiện tại của luồng dưới dạng một giá trị từ 0,0 đến 1,0, trong đó 1,0 là âm lượng tối đa. |
| tắt tiếng | boolean | không bắt buộc Thiết bị truyền có bị 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 của 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 nghe nhì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 | Mô tả |
|---|---|---|
| contentId | chuỗi | Giá trị nhận dạng dành riêng cho dịch vụ của nội dung mà trình phát nội dung đa phương tiện hiện đang tải. Đây là một chuỗi biểu mẫu miễn phí và dành riêng cho ứng dụng. Trong hầu hết các trường hợp, đây sẽ là URL của 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ể diễn giải đúng cách. Độ dài tối đa: 1.000 ký tự |
| streamType | enum (string) |
Mô tả loại hiện vật đa phương tiện là một trong những loại sau:
|
| contentType | chuỗi | 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 của nội dung nghe nhìn, một trong những đối tượng sau: |
| duration | gấp đôi | không bắt buộc Thời lượng của luồng đ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 do ứng dụng gửi hoặc ứng dụng nhận xác định |
GenericMediaMetadata
Mô tả một cấu phần phần mềm đa phương tiện chung.
| Tên | Loại | Mô tả |
|---|---|---|
| metadataType | số nguyên | 0 (giá trị duy nhất) |
| title | chuỗi | không bắt buộc Tiêu đề mô tả nội dung. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| subtitle | chuỗi | không bắt buộc Phụ đề mô tả nội dung. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| hình ảnh | Hình ảnh[] | không bắt buộc Mảng URL của(các) hình ảnh được 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 Load. Bạn nên 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ờ theo chuẩn ISO 8601 mà nội dung này được phát hành. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
MovieMediaMetadata
Mô tả một thành phần nội dung nghe nhìn của phim.
| Tên | Loại | Mô tả |
|---|---|---|
| metadataType | số nguyên | 1 (giá trị duy nhất) |
| title | chuỗi | không bắt buộc Tiêu đề mô tả nội dung. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| subtitle | chuỗi | không bắt buộc Phụ đề mô tả nội dung. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| studio | chuỗi | không bắt buộc Studio phát hành nội dung. Trình phát có thể độc lập truy xuất hãng phim bằng content_id hoặc được người gửi cung cấp trong thông báo Load |
| hình ảnh | Hình ảnh[] | không bắt buộc Mảng URL của(các) hình ảnh được 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 Load. Bạn nên 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ờ theo chuẩn ISO 8601 mà nội dung này được phát hành. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
TvShowMediaMetadata
Mô tả một cấu phần phần mềm đa phương tiện của tập chương trình truyền hình.
| Tên | Loại | Mô tả |
|---|---|---|
| metadataType | số nguyên | 2 (giá trị duy nhất) |
| seriesTitle | chuỗi | không bắt buộc Tiêu đề mô tả của chương trình truyền hình. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| subtitle | chuỗi | không bắt buộc Phụ đề mô tả của tập phim truyền hình. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| season | 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 của(các) hình ảnh được 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 Load. Bạn nên cung cấp kích thước được đề xuất |
| originalAirDate | chuỗi (ISO 8601) | không bắt buộc Ngày và giờ phát hành tập này theo chuẩn ISO 8601. Trình phát có thể độc lập truy xuất originalAirDate bằng content_id hoặc được người gửi cung cấp trong thông báo Load |
MusicTrackMediaMetadata
Mô tả một cấu phần phần mềm nội dung nghe nhìn của bản nhạc.
| Tên | Loại | Mô tả |
|---|---|---|
| metadataType | số nguyên | 3 (giá trị duy nhất) |
| albumName | chuỗi | không bắt buộc Đĩa nhạc hoặc bộ sưu tập chứa bản nhạc này. Trình phát có thể độc lập truy xuất albumName bằng content_id hoặc người gửi có thể cung cấp albumName trong thông báo Load |
| title | chuỗi | không bắt buộc Tên của bản nhạc (ví dụ: tên bài hát). Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| albumArtist | chuỗi | không bắt buộc Tên của nghệ sĩ liên kết với đĩa nhạc có bài hát này. Trình phát có thể độc lập truy xuất albumArtist bằng content_id hoặc người gửi có thể cung cấp albumArtist trong thông báo Load |
| artist | chuỗi | không bắt buộc Tên của nghệ sĩ liên kết với bản nhạc. Trình phát có thể độc lập truy xuất nghệ sĩ bằng content_id hoặc người gửi có thể cung cấp nghệ sĩ trong thông báo Load |
| composer | chuỗi | không bắt buộc Tên của nhà soạn nhạc liên kết với bản nhạc đa phương tiện. Người chơi có thể độc lập truy xuất thành phần bằng content_id hoặc người gửi có thể cung cấp thành phần này trong thông báo Load |
| trackNumber | số nguyên | không bắt buộc Số thứ tự của bài hát trong đĩa nhạc |
| discNumber | số nguyên | không bắt buộc Số thứ tự của đĩa (ví dụ: đĩa) trong album |
| hình ảnh | Hình ảnh[] | không bắt buộc Mảng URL của(các) hình ảnh được 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 Load. Bạn nên 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ờ theo chuẩn ISO 8601 mà nội dung này được phát hành. Trình phát có thể độc lập truy xuất releaseDate bằng content_id hoặc người gửi có thể cung cấp releaseDate trong thông báo Load |
PhotoMediaMetadata
Mô tả một hiện vật đa phương tiện dạng ảnh.
| Tên | Loại | Mô tả |
|---|---|---|
| metadataType | số nguyên | 4 (giá trị duy nhất) |
| title | chuỗi | không bắt buộc Tiêu đề của bức ảnh. Trình phát có thể độc lập truy xuất tiêu đề bằng content_id hoặc tiêu đề đó có thể do người gửi cung cấp trong thông báo Load |
| artist | chuỗi | không bắt buộc Tên của nhiếp ảnh gia. Trình phát có thể độc lập truy xuất nghệ sĩ bằng content_id hoặc người gửi có thể cung cấp nghệ sĩ trong thông báo Load |
| location | chuỗi | không bắt buộc Vị trí bằng lời nói nơi chụp ảnh; ví dụ: "Madrid, Tây Ban Nha". Người chơi có thể độc lập truy xuất vị trí bằng content_id hoặc vị trí đó có thể do người gửi cung cấp trong thông báo Load |
| latitude | gấp đôi | không bắt buộc Giá trị vĩ độ địa lý của vị trí chụp ảnh. Người chơi có thể độc lập truy xuất vĩ độ bằng cách sử dụng content_id hoặc vĩ độ có thể do người gửi cung cấp trong thông báo Load |
| longitude | gấp đôi | không bắt buộc Giá trị kinh độ địa lý của vị trí chụp ảnh. Người chơi có thể độc lập truy xuất kinh độ bằng cách sử dụng content_id hoặc người gửi có thể cung cấp kinh độ trong thông báo Load |
| width | số nguyên | không bắt buộc Chiều rộng của bức ảnh, tính bằng pixel. Người chơi có thể độc lập truy xuất chiều rộng bằng content_id hoặc chiều rộng có thể do người gửi cung cấp trong thông báo Load |
| height | số nguyên | không bắt buộc Chiều cao của bức ảnh, tính bằng pixel. Người chơi có thể độc lập truy xuất chiều cao bằng content_id hoặc người gửi có thể cung cấp chiều cao trong thông báo Load |
| creationDateTime | chuỗi (ISO 8601) | không bắt buộc Ngày và giờ theo chuẩn ISO 8601 mà bức ảnh này được chụp. Trình phát có thể độc lập truy xuất creationDateTime bằng content_id hoặc được 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 đa phương tiện liên quan đến phiên.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng duy nhất cho hoạt động phát của phiên cụ thể này. Mã nhận dạng này do bên nhận đặt tại LOAD và có thể dùng để xác định một phiên phát cụ thể. Ví dụ: hai lượt phát "Wish you were here" trong cùng một phiên sẽ có một mediaSessionId riêng biệt. |
| media | MediaInformation | không bắt buộc (đối với thông báo trạng thái) Nội dung mô tả đầy đủ về nội dung đang phát. Chỉ được trả về trong thông báo trạng thái nếu MediaInformation đã thay đổi. |
| playbackRate | số thực dấu phẩy động | Cho biết liệu thời gian phát nội dung nghe nhìn có đang tăng lên hay không và tốc độ tăng là bao nhiêu. Điều này không phụ thuộc vào trạng thái của trình phát vì thời gian của nội dung nghe nhìn có thể dừng ở bất kỳ trạng thái nào. 1.0 là tốc độ bình thường, 0.5 là tốc độ chuyển động chậm |
| playerState | enum (chuỗi) | Mô tả trạng thái của trình phát bằng một trong các trạng thái sau:
|
| idleReason | enum (chuỗi) | không bắt buộc Nếu playerState là IDLE và bạn biết lý do khiến trạng thái này chuyển thành IDLE, thì thuộc tính này sẽ được cung cấp. Nếu trình phát đang ở trạng thái KHÔNG HOẠT ĐỘNG vì vừa khởi động, thì thuộc tính này sẽ không được cung cấp; nếu trình phát đang ở bất kỳ trạng thái nào khác, thì bạn không nên cung cấp thuộc tính này. Các giá trị sau đây sẽ á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ừ khi bắ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 sẽ biểu thị thời gian (tính bằng giây) kể từ khi bắt đầu sự kiện mà trình phát cần biết. |
| supportedMediaCommands | flags | Các cờ mô tả những lệnh về nội dung nghe nhìn mà trình phát nội dung nghe nhìn hỗ trợ:
Các tổ hợp được mô tả dưới dạng tổng số; ví dụ: Pause+Seek+StreamVolume+Mute == 15. |
| volume | Thể tích | Số lượt phát trực tuyến |
| 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
Các lệnh này điều khiển trình phát nội dung nghe nhìn. Tất cả các đối tượng customData trong các thông báo bên dưới đều phải là đối tượng không bắt buộc (tức là receiver phải giảm cấp đúng cách nếu không truyền dữ liệu). Điều này sẽ giúp các ứng dụng điều khiển từ xa chung hoạt động đúng cách.
Hoạt độ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 | Mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | LOAD (chỉ 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 |
| autoplay | boolean | không bắt buộc (mặc định là true) Nếu bạn chỉ định tham số tự động phát, trình phát nội dung đa phương tiện sẽ bắt đầu phát nội dung khi nội dung đó được tải. Ngay cả khi bạn không chỉ định chế độ tự động phát, việc triển khai trình phát nội dung nghe nhìn vẫn có thể chọn bắt đầu phát ngay lập tức. Nếu quá trình phát bắt đầu, trạng thái trình phát trong phản hồi phải được đặt thành BUFFERING, nếu không, trạng thái này phải được đặt thành PAUSED |
| 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à bạn không chỉ định vị trí, thì luồng phát sẽ bắt đầu tại vị trí phát trực tiếp |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự thay đổi trạng thái nội dung nghe nhìn | Invalid Player State Load Failed Load Cancelled |
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 gửi.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng của phiên phát nội dung nghe nhìn cần tạm dừng |
| requestId | số nguyên | Mã yêu cầu, dùng để liên kết yêu cầu/phản hồi |
| type | chuỗi | PAUSE (chỉ có giá trị) |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự 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ệ |
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 gửi. Nếu vị trí được cung cấp nằm ngoài phạm vi vị trí hợp lệ cho nội dung hiện tại, thì trình phát sẽ chọn một vị trí hợp lệ gần với vị trí được yêu cầu nhất có thể.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng của phiên nội dung nghe nhìn nơi vị trí của luồng được đặt |
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | SEEK (chỉ giá trị) |
| resumeState | enum (chuỗi) | không bắt buộc Nếu bạn không đặt giá trị này, trạng thái phát sẽ không thay đổi; các giá trị sau đây sẽ đượ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à bạn không chỉ định vị trí, thì luồng phát sẽ bắt đầu tại vị trí phát trực tiếp |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự 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ệ |
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 gửi. Sau lệnh này, nội dung sẽ không được tải nữa và mediaSessionId sẽ không hợp lệ.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng của phiên nội dung nghe nhìn cho nội dung cần dừng |
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | STOP (chỉ giá trị) |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự 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ệ |
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 sẽ tiếp tục từ vị trí thời gian hiện tại.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng của phiên nội dung nghe nhìn cho nội dung sẽ được phát |
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | PLAY (chỉ có giá trị) |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự 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ệ |
Lấy trạng thái
Truy xuất trạng thái của nội dung nghe nhìn.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | không bắt buộc Mã nhận dạng phiên nội dung nghe nhìn của nội dung nghe nhìn mà bạn muốn trả về trạng thái. Nếu bạn không cung cấp mã nào, thì trạng thái của tất cả mã nhận dạng phiên nội dung nghe nhìn sẽ được cung cấp. |
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | GET_STATUS (chỉ giá trị) |
| customData | đối tượng | không bắt buộc Khối 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 cho 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 nội dung nghe nhìn. Dùng cho hiệu ứng mờ dần/hiện dần trên luồng nội dung nghe nhìn. (Lưu ý: âm lượng của bộ nhận được thay đổi bằng cách sử dụng setVolume của bộ gửi Web.) Bạn không được dùng âm lượng luồng kết hợp với thanh trượt âm lượng hoặc các nút âm lượng để điều khiển âm lượng của thiết bị. Việc thay đổi âm lượng luồng phát sẽ không kích hoạt bất kỳ giao diện người dùng nào trên thiết bị nhận.
| Tên | Loại | Mô tả |
|---|---|---|
| mediaSessionId | số nguyên | Mã nhận dạng phiên nội dung nghe nhìn của nội dung nghe nhìn mà âm lượng phát trực tuyến đã thay đổi |
| requestId | số nguyên | Mã nhận dạng của yêu cầu, để tương quan yêu cầu và phản hồi |
| type | chuỗi | VOLUME (chỉ giá trị) |
| volume | Thể tích | Số lượt phát trực tuyến |
| customData | đối tượng | không bắt buộc Khối 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 của bộ nhận | Thông báo về Sự 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ệ |
Thư từ người nhận đến người gửi
Máy nhận gửi hai loại thông báo:
- Lỗi: Thông báo đơn phương được gửi khi có phản hồi lỗi đối với yêu cầu của người gửi.
- Trạng thái: Truyền tin nhắn.
- Hậu quả của hành động do người gửi bắt đầu. Sẽ chứa requestId của yêu cầu gây ra thay đổi.
- Tự phát: Ví dụ: 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 người gửi không thể thực hiện yêu cầu 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 phần tử đa phương tiện.
| Tên | Loại | Mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng của yêu cầu đã tạo ra lỗi này |
| type | chuỗi | INVALID_PLAYER_STATE (chỉ có 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
Được gửi khi yêu cầu tải không thành công. Trạng thái của trình phát sẽ là IDLE.
| Tên | Loại | Mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng của yêu cầu đã tạo ra lỗi này |
| type | chuỗi | LOAD_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ỷ (nhận được yêu cầu tải thứ hai).
| Tên | Loại | Mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng của yêu cầu đã tạo ra lỗi này |
| type | chuỗi | LOAD_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ụ: một loại yêu cầu không xác định).
| Tên | Loại | Mô tả |
|---|---|---|
| requestId | số nguyên | Mã nhận dạng của yêu cầu đã tạo ra lỗi này |
| type | chuỗi | 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 nội dung nghe nhìn
Được gửi sau khi trạng thái thay đổi hoặc sau khi có yêu cầu về trạng thái của nội dung nghe nhìn. Chỉ những đối tượng MediaStatus đã thay đổi hoặc được yêu cầu mới được gửi.
| Tên | Loại | 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 phản hồi đó hoặc 0 nếu thông báo trạng thái là tự phát (không do yêu cầu của người gửi kích hoạt). Các ứng dụng gửi sẽ tạo mã nhận dạng yêu cầu riêng biệt bằng cách chọn một số ngẫu nhiên và liên tục tăng số đó (các ứng dụng này sẽ không dùng 0). |
| type | chuỗi | MEDIA_STATUS (chỉ giá trị) |
| status | MediaStatus[] | Mảng gồm các đối tượng Trạng thái nội dung nghe nhìn. LƯU Ý: phần tử nội dung nghe nhìn trong MediaStatus sẽ chỉ được trả về nếu phần tử đó đã 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 |