Google Cast gönderen uygulamaları, alıcı uygulamaya JSON biçiminde mesaj göndererek alıcı cihazdaki çalma işlemlerini kontrol eder. Benzer şekilde, alıcı da iletileri gönderene JSON biçiminde geri gönderir. Mesajlar, gönderenin oynatıcı durumunu değiştiren komutları, alıcıdan bu komutlara verdiği yanıtlar veya alıcı uygulamanın medyasını açıklayan veri yapıları olabilir.
Google Cast SDK'sı Ek Geliştirici Hizmet Şartları'na uygun olarak, bir Cast medya uygulaması, alıcıda medya oynatmayı kontrol etmek için bu mesajları burada tanımlandığı şekilde kullanmalıdır. Bu sayede medya uygulamasına platformlar genelinde tutarlı bir kullanıcı deneyimi sağlanır ve Cast uygulamasının yeni ve gelecekteki kullanım alanlarını desteklemesi sağlanır. Bu yapılar uygun durumlarda özel verileri de destekler ve uygulama, SDK'nın desteklemediği komutlar için kendi mesajlarını tanımlayabilir.
Medya oynatma mesajlarının ad alanı urn:x-cast:com.google.cast.media olarak tanımlanır.
Not: Bu spesifikasyondaki iletiler ve yapıların, aktarım iletisinin maksimum boyutu tarafından belirlenen örtülü bir maksimum boyutu vardır. Tek tek alanlar için herhangi bir sınır yoktur. Aktarım iletisinin maksimum boyutu şu anda 64 KBayt'tır.
Yaygın ad alanı veri yapıları
Tüm medya ad alanı yapıları tarafından kullanılan veri yapılarının üst kümesi, ortak bir ad alanında tanımlanır.
Resim
Bu, bir resmin açıklamasıdır. Gönderen uygulamaya, resimleri nasıl oluşturacağına bağlı olarak resim seçebilmesi için az miktarda meta veri de bu kapsamdadır.
Yükseklik ve genişlik, bir Resim dizisindeki yalnızca bir öğe için isteğe bağlıdır. Örneğin, tek bir öğe döndürüldüğünde bunlar isteğe bağlıdır. İki öğe döndürülürse bir öğenin yüksekliği ve genişliği belirtilmelidir. Ancak gönderen, belirli parametrelerle iletilen öğeyi beğenmediği takdirde "varsayılan" seçeneğini tercih edebilir.
| Ad | Tür | Açıklama |
|---|---|---|
| url | URI | Resmin URI'si |
| yükseklik | tam sayı | isteğe bağlı Resmin yüksekliği |
| genişlik | tam sayı | isteğe bağlı Resmin genişliği |
Ses
Medya akışı ses düzeyi. Medya akışındaki belirme/artma efektleri için kullanılır. (Not: Sistem hacmi, gönderen API'leri kullanılarak değiştirilir.) Yayın ses düzeyi, cihazın ses düzeyini kontrol etmek için ses kaydırma çubuğuyla veya ses düğmeleriyle birlikte kullanılmamalıdır. Akış hacmini değiştirmek için aşağıdaki parametrelerden en az birinin iletilmesi gerekir.
| Ad | Tür | Açıklama |
|---|---|---|
| seviye | double | isteğe bağlı 0,0 ile 1,0 arasında bir değer olarak mevcut akış ses düzeyi. Burada maksimum ses seviyesi 1,0'dır. |
| sessiz | boolean | isteğe bağlı Ses düzeyinden bağımsız olarak yayın cihazının sesinin kapatılıp kapatılmadığı |
Medya ad alanı veri yapıları
Bu mesajlar, medya oynatıcının durumunu açıklar. Ad alanı urn:x-cast:com.google.cast.media şeklindedir.
MediaInformation
Bu veri yapısı bir medya akışını tanımlar.
| Ad | Tür | Açıklama |
|---|---|---|
| contentId | dize | Medya oynatıcı tarafından yüklenmekte olan içeriğin hizmete özgü tanımlayıcısı. Bu, serbest biçimli bir dizedir ve uygulamaya özeldir. Çoğu durumda bu medyanın URL'si olur ancak gönderen, alıcının doğru şekilde yorumlayabileceği bir dizeyi iletmeyi seçebilir. Maks. uzunluk: 1k |
| streamType | enum (dize) |
Medya yapısı türünü aşağıdakilerden biri olarak açıklar:
|
| contentType | dize | Oynatılan medyanın MIME içerik türü |
| meta veri | nesne | isteğe bağlı Medya meta veri nesnesi, aşağıdakilerden biri: |
| duration | double | isteğe bağlı O anda oynatılan yayının saniye cinsinden süresi |
| customData | nesne | isteğe bağlı Gönderen uygulama veya alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
GenericMediaMetadata
Genel bir medya yapısını tanımlar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 0 (tek değer) |
| title | dize | isteğe bağlı İçeriğin açıklayıcı başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| alt başlık | dize | isteğe bağlı İçeriğin açıklayıcı alt başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| resimler | Resim[] | isteğe bağlı İçerikle ilişkili bir resmin URL dizisi. Alanın başlangıç değeri, gönderen tarafından Load (Yükle) mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır |
| releaseDate | dize (ISO 8601) | isteğe bağlı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
MovieMediaMetadata
Bir film medya eserini açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 1 (tek değer) |
| title | dize | isteğe bağlı İçeriğin açıklayıcı başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| alt başlık | dize | isteğe bağlı İçeriğin açıklayıcı alt başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| stüdyo | dize | İçeriği yayınlayan isteğe bağlı Studio. Oynatıcı, content_id kullanılarak Studio'yu bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| resimler | Resim[] | isteğe bağlı İçerikle ilişkili bir resmin URL dizisi. Alanın başlangıç değeri, gönderen tarafından Load (Yükle) mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır |
| releaseDate | dize (ISO 8601) | isteğe bağlı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
TvShowMediaMetadata
Bir televizyon programı bölümü medya eserini açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 2 (tek değer) |
| seriesTitle | dize | isteğe bağlı TV dizisinin açıklayıcı başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| alt başlık | dize | isteğe bağlı TV bölümünün açıklayıcı alt başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| sezon | tam sayı | isteğe bağlı TV programının sezon numarası |
| bölüm | tam sayı | isteğe bağlı TV programının bölüm numarası (sezondaki) |
| resimler | Resim[] | isteğe bağlı İçerikle ilişkili bir resmin URL dizisi. Alanın başlangıç değeri, gönderen tarafından Load (Yükle) mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır |
| originalAirDate | dize (ISO 8601) | isteğe bağlı ISO 8601 tarih ve saat, bu bölümün yayınlandığı tarih ve saattir. Oynatıcı, content_id parametresini kullanarak orijinalAirDate öğesini bağımsız olarak alabilir veya Load (Yükle) mesajında gönderen tarafından verilebilir. |
MusicTrackMediaMetadata
Müzik parçası medya yapısını tanımlar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 3 (tek değer) |
| albumName | dize | isteğe bağlı Bu parçanın alındığı albüm veya koleksiyon. Oynatıcı, content_id aracılığıyla albümAdını bağımsız olarak alabilir veya Load (Yükleme) mesajında gönderen tarafından verilebilir. |
| title | dize | isteğe bağlı Parçanın adı (örneğin, şarkı adı). Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| albumArtist | dize | isteğe bağlı Bu parçayı içeren albümle ilişkili sanatçının adı. Oynatıcı, content_id parametresini kullanarak albüm sanatçısını bağımsız olarak alabilir veya Load (Yükle) mesajında gönderen tarafından sağlanabilir. |
| sanatçı | dize | isteğe bağlı Medya parçasıyla ilişkili sanatçının adı. Oynatıcı content_id aracılığıyla sanatçıyı bağımsız olarak alabilir veya Load (Yükleme) mesajında gönderen tarafından verilebilir. |
| oluşturucu | dize | isteğe bağlı Medya parçasıyla ilişkili bestecinin adı. Oynatıcı, content_id parametresini kullanarak besteciyi bağımsız olarak alabilir veya Load (Yükleme) mesajında gönderen tarafından verilebilir. |
| trackNumber | tam sayı | isteğe bağlı Albümdeki parçanın numarası |
| discNumber | tam sayı | isteğe bağlı Albümün ses düzeyi (örneğin, disk) sayısı |
| resimler | Resim[] | isteğe bağlı İçerikle ilişkili bir resmin URL dizisi. Alanın başlangıç değeri, gönderen tarafından Load (Yükle) mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır |
| releaseDate | dize (ISO 8601) | isteğe bağlı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak publishDate'i bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
PhotoMediaMetadata
Bir fotoğrafik medya eserini açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 4 (tek değer) |
| title | dize | isteğe bağlı Fotoğrafın başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| sanatçı | dize | isteğe bağlı Fotoğrafçının adı. Oynatıcı content_id aracılığıyla sanatçıyı bağımsız olarak alabilir veya Load (Yükleme) mesajında gönderen tarafından verilebilir. |
| konum | dize | isteğe bağlı Fotoğrafın çekildiği sözlü konum; örneğin, "Madrid, İspanya". Oynatıcı, content_id parametresini kullanarak konumu bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| latitude | double | isteğe bağlı Fotoğrafın çekildiği konumun coğrafi enlem değeri. Oynatıcı, content_id kullanarak enlemi bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| longitude | double | isteğe bağlı Fotoğrafın çekildiği konumun coğrafi boylam değeri. Oynatıcı, content_id parametresini kullanarak boylamı bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| genişlik | tam sayı | isteğe bağlı Fotoğrafın piksel cinsinden genişliği. Oynatıcı, content_id aracılığıyla bağımsız olarak genişliği alabilir veya Load mesajında gönderen tarafından verilebilir. |
| yükseklik | tam sayı | isteğe bağlı Fotoğrafın piksel cinsinden yüksekliği. Oynatıcı, content_id parametresini kullanarak yüksekliği bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
| creationDateTime | dize (ISO 8601) | isteğe bağlı Bu fotoğrafın çekildiği yerin ISO 8601 tarih ve saati. Oynatıcı, content_id öğesini kullanarak generateDateTime öğesini bağımsız olarak alabilir veya Load mesajında gönderen tarafından verilebilir. |
MediaStatus
Medya içeriğinin oturumla ilgili mevcut durumunu açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Bu oturumun oynatılmasının benzersiz kimliği. Bu kimlik, alıcı tarafından YÜKLEME aşamasında ayarlanır ve bir oynatmanın belirli bir örneğini tanımlamak için kullanılabilir. Örneğin, aynı oturumda gerçekleşen iki "Wish you are here" (Keşke burada olsaydınız) oynatmanın her biri benzersiz bir mediaSessionId'ye sahip olur. |
| medya | MediaInformation | isteğe bağlı (durum mesajları için) Oynatılan içeriğin tam açıklaması. Yalnızca Mediainformation değiştiyse durum mesajlarında döndürülür. |
| playbackRate | float | Medya süresinin ilerleyip ilerlemediğini ve ilerleme hızını gösterir. Medya süresi herhangi bir durumda durabileceği için bu, oynatıcı durumundan bağımsızdır. 1,0 normal süreyi, 0,5 ise ağır çekimi ifade eder |
| playerState | enum (dize) | Oynatıcının durumunu aşağıdakilerden biri olarak açıklar:
|
| idleReason | enum (dize) | isteğe bağlı Player State IDLE ise IDLE ise ve IDLE haline gelme nedeni biliniyorsa bu özellik sağlanır. Oynatıcı yeni başladığı için IDLE durumundaysa bu özellik sağlanmaz. Oynatıcı başka bir durumdaysa bu özellik sağlanmamalıdır. Aşağıdaki değerler geçerlidir:
|
| currentTime | double | Medya oynatıcının içeriğin başlangıcından itibaren saniye cinsinden geçerli konumu. Bu bir canlı yayın içeriğiyse bu alan, etkinliğin başlangıcından itibaren oyuncu tarafından bilinmesi gereken süreyi saniye cinsinden temsil eder. |
| supportedMediaCommands | flags | Medya oynatıcının desteklediği medya komutlarını açıklayan işaretler:
Kombinasyonlar toplama olarak açıklanır; örneğin, Pause+Seek+StreamVolume+Sessiz == 15. |
| ses | Ses | Akış ses düzeyi |
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
Gönderenden alıcıya giden komutlar
Bu komutlar medya oynatıcıyı kontrol eder. Aşağıdaki mesajlardaki tüm customData nesneleri isteğe bağlı olmalıdır (yani veriler iletilmezse alıcının performansında düşüş olması gerekir). Bu ayar, genel uzaktan kumanda uygulamalarının düzgün çalışmasını sağlar.
Yük
Medya oynatıcıya yeni içerik yükler.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | LOAD (yalnızca değer) |
| medya | MediaInformation | Yüklenecek medyanın meta verileri (contentId dahil) |
| otomatik oynatma | boolean | isteğe bağlı (varsayılan değer: true) Otomatik oynatma parametresi belirtilmişse medya oynatıcı, yüklenen içeriği oynatmaya başlar. Otomatik oynatma belirtilmemiş olsa bile medya oynatıcı uygulaması, oynatmaya hemen başlamayı seçebilir. Oynatma başlatıldıysa yanıttaki oynatıcı durumu BUFFERING olarak ayarlanmalıdır. Aksi takdirde, DURAKLATILDI olarak ayarlanmalıdır. |
| currentTime | double | isteğe bağlı İçeriğin başlangıcından bu yana geçen saniye sayısı. İçerik canlı içerikse ve konum belirtilmemişse akış canlı konumda başlar. |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz Oynatıcı Durumu Yükleme Başarısız Oldu Yükleme İptal Edildi |
Duraklat
Mevcut içeriğin oynatılmasını duraklatır. Tüm gönderen uygulamaları için bir STATUS etkinlik bildirimi tetikler.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Duraklatılacak medya oturumunun kimliği |
| requestId | tam sayı | İsteği/yanıtı ilişkilendirmek için kullanılacak isteğin kimliği |
| tür | dize | DURAKLATIN (yalnızca değer) |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz oyuncu durumu |
Git
Akıştaki geçerli konumu ayarlar. Tüm gönderen uygulamaları için bir STATUS etkinlik bildirimi tetikler. Sağlanan konum, geçerli içerik için geçerli konum aralığının dışındaysa oynatıcı istenen konuma mümkün olduğunca yakın geçerli bir konum seçmelidir.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Akış konumunun ayarlandığı medya oturumunun kimliği |
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | ARA (yalnızca değer) |
| resumeState | enum (dize) | isteğe bağlı Bu ayar ayarlanmazsa oynatma durumu değişmez; aşağıdaki değerler geçerli olur:
|
| currentTime | double | isteğe bağlı İçeriğin başlangıcından bu yana geçen saniye sayısı. İçerik canlı içerikse ve konum belirtilmemişse akış canlı konumda başlar. |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz oyuncu durumu |
Durdur
Mevcut içeriğin oynatılmasını durdurur. Tüm gönderen uygulamaları için bir STATUS etkinlik bildirimi tetikler. Bu komutun ardından içerik yüklenmez ve mediaSessionId geçersiz kılınır.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Durdurulacak içerik için medya oturumunun kimliği |
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | STOP (yalnızca değer) |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz oyuncu durumu |
Oynat
Yükleme çağrısıyla yüklenen içeriğin oynatılmasını başlatır, oynatma mevcut zaman konumundan devam eder.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Oynatılacak içerik için medya oturumunun kimliği |
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | PLAY (yalnızca değer) |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz oyuncu durumu |
Durum Al
Medya durumunu alır.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | isteğe bağlı Medya durumunun döndürülmesi gereken medyanın medya oturumu kimliği. Herhangi bir medya oturumu kimliği sağlanmazsa tüm medya oturum kimliklerinin durumu sağlanır. |
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | GET_STATUS (yalnızca değer) |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| İstekte bulunan gönderene gönderilen MediaStatus mesajı | Yok | Yok | Yok |
SetVolume
Medya akışı ses düzeyini ayarlar. Medya akışındaki belirme/artma efektleri için kullanılır. (Not: Alıcının ses düzeyi, Web göndereni setVolume kullanılarak değiştirilir.) Yayının ses düzeyi, cihazın ses düzeyini kontrol etmek için ses kaydırma çubuğuyla veya ses düğmeleriyle birlikte kullanılmamalıdır. Akış hacmindeki bir değişiklik, alıcıda herhangi bir kullanıcı arayüzünü tetiklemez.
| Ad | Tür | Açıklama |
|---|---|---|
| mediaSessionId | tam sayı | Akış ses düzeyinin değiştirildiği medyanın Medya Oturumu Kimliği |
| requestId | tam sayı | İstek ve yanıtı ilişkilendirmek için isteğin kimliği |
| tür | dize | VOLUME (yalnızca değer) |
| ses | Ses | Akış ses düzeyi |
| customData | nesne | isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| Yok | Alıcı durumu değişikliği | Medya Durumu Değişikliği mesajı | Geçersiz oyuncu durumu |
Alıcıdan gönderene giden mesajlar
Alıcı iki tür mesaj gönderir:
- Hatalar: Gönderen isteğine yönelik hata yanıtı olduğunda gönderilen Unicast mesajları.
- Durum: Anons mesajları.
- Gönderen tarafından başlatılan bir işlemin sonucu. Değişikliğe neden olan isteğin requestId değerini içerir.
- Spontane: Örneğin, alıcı uygulama tarafından tetiklenen bir değişiklik nedeniyle. İstek kimliği 0 olacaktır.
Hata: Geçersiz Oynatıcı Durumu
Oynatıcı geçerli bir durumda olmadığı için gönderen isteği yerine getirilemediğinde gönderilir. Örneğin, uygulama henüz bir medya öğesi oluşturmadıysa.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | dize | INVALID_PLAYER_STATE (yalnızca değer) |
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
Hata: Yükleme Başarısız Oldu
Yükleme isteği başarısız olduğunda gönderilir. Oynatıcı durumu "IDLE" olacaktır.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | dize | LOAD_FAILED (yalnızca değer) |
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
Hata: Yükleme İptal Edildi
Yükleme isteği iptal edildiğinde (ikinci bir yükleme isteği alındığında) gönderilir.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | dize | LOAD_CANCELLED (yalnızca değer) |
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
Hata: Geçersiz İstek
İstek geçersiz olduğunda (ör. bilinmeyen bir istek türü) gönderilir.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | dize | INVALID_REQUEST (yalnızca değer) |
| sebep | Sıralama (dize) | Değerler:
|
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |
Medya durumu
Durum değişikliğinden veya medya durumu isteğinden sonra gönderilir. Yalnızca değiştirilen veya istenen MediaStatus nesneleri gönderilir.
| Ad | Tür | Açıklama |
|---|---|---|
| requestId | tam sayı | Bu durum yanıtını, gönderen istekle ilişkilendirmek için kullanılan kimlik veya durum iletisinin spontane olması (bir gönderen isteği tarafından tetiklenmezse) 0. Gönderen uygulamaları, rastgele bir sayı seçip sürekli artırarak (0 kullanmaz) benzersiz istek kimlikleri oluşturur. |
| tür | dize | MEDIA_STATUS (yalnızca değer) |
| durum | MediaStatus[] | Medya Durumu nesneleri dizisi. NOT: MediaStatus'daki medya öğesi yalnızca değiştiyse döndürülür. |
| customData | nesne | isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blob'u |