Google Cast gönderen uygulamaları, alıcı uygulamaya JSON biçiminde mesaj göndererek alıcı cihazındaki oynatmayı kontrol eder. Benzer şekilde, alıcı da iletiyi JSON'da, gönderene geri gönderir. İletiler, gönderenden oynatıcı durumunu değiştiren komutlar, alıcıdan bu komutlara verilen 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 burada tanımlanan mesajları kullanmalıdır. Bu, medya uygulamasına platformlar arasında tutarlı bir kullanıcı deneyimi sağlar ve bir Yayın uygulamasının yeni ve gelecekteki kullanım alanlarını desteklemesini sağlar. Bu yapılar uygun durumlarda özel verileri de destekler ve bir uygulama, SDK tarafından desteklenmeyen 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 mesajların ve yapıların, aktarım mesajının maksimum boyutuyla belirlenen örtülü maksimum boyutu vardır. Belirli alanlar için herhangi bir sınır yoktur. Aktarım mesajı maksimum boyutu şu anda 64 KByt'tir.
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, resmin nasıl oluşturulacağına bağlı olarak gönderen uygulamasına bir resim seçeneği sunmak için az miktarda meta veri de dahil olmak üzere bir resmin açıklamasıdır.
Resim dizisindeki yalnızca bir öğenin yüksekliği ve genişliği isteğe bağlıdır. Örneğin, döndürülen tek bir öğe varsa bunlar isteğe bağlıdır. İki öğe döndürüldüyse bir öğenin yüksekliği ve genişliği belirtilmelidir ancak belirli parametrelerle iletilen öğe hoşunuza gitmediyse gönderen "varsayılan" seçeneğini belirleyebilir.
| 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 Düzeyi
Medya akışı ses düzeyi. Medya akışın şeffaf ya da tamamen belirmesi için kullanılır. (Not: Sistem hacmi, gönderen API'leri kullanılarak değiştirilir.) Cihazın sesini kontrol etmek için ses seviyesi kaydırma çubuğu veya ses düğmeleriyle birlikte akış ses düzeyinin 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ış hacmi düzeyi. 1,0 maksimum hacimdir. |
| yoksayıldı | boolean | isteğe bağlı Ses seviyesi ses düzeyinden bağımsız olarak Yayın cihazının sesinin kapalı olup olmadığı |
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.
Medya Bilgileri
Bu veri yapısı, bir medya akışını tanımlar.
| Ad | Tür | Açıklama |
|---|---|---|
| içerikkimliği | string | Medya oynatıcı tarafından şu anda yüklü 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 dize aktarmayı tercih edebilir. Maks. süre: 1k |
| yayın türü | enum (dize) |
Medya yapısının türünü aşağıdakilerden biri olarak açıklar:
|
| içerikTürü | string | Oynatılan medyanın MIME içerik türü |
| meta veri | nesne | optional Medya meta veri nesnesi. Aşağıdakilerden biri: |
| süre | double | isteğe bağlı Şu anda oynatılan yayının saniye cinsinden süresi |
| özelveri | nesne | isteğe bağlı Gönderen uygulama veya alıcı uygulama tarafından tanımlanan, uygulamaya özel veri blob'u |
GenelGenel Meta Veri
Genel medya yapısını açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 0 (tek değer) |
| title | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| altyazı | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| resimler | Resim[] | isteğe bağlı: İçerikle ilişkili resme ait URL dizisi. Alanın ilk değeri, gönderen tarafından Load (Yükle) iletisinde belirtilebilir. Önerilen boyutların sağlanması gerekir |
| yayın tarihi | dizesi (ISO 8601) | isteğe bağlı: Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından verilebilir |
FilmMedyaMeta Verileri
Bir film medya yapısını açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 1 (tek değer) |
| title | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| altyazı | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| studio | string | İsteğe bağlı İçeriği yayınlayan stüdyo. Oynatıcı, stüdyoyu content_id kullanarak bağımsız olarak alabilir veya gönderen tarafından Load (Yükleme) mesajında verilebilir |
| resimler | Resim[] | isteğe bağlı: İçerikle ilişkili resme ait URL dizisi. Alanın ilk değeri, gönderen tarafından Load (Yükle) iletisinde belirtilebilir. Önerilen boyutların sağlanması gerekir |
| yayın tarihi | dizesi (ISO 8601) | isteğe bağlı: Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından verilebilir |
TvShowMediaMeta Verileri
Bir televizyon programı bölüm medya yapısını açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 2 (tek değer) |
| series başlığı | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| altyazı | string | isteğe bağlı TV bölümünün açıklayıcı altyazısı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından verilebilir |
| sezon | tam sayı | isteğe bağlı TV dizisinin sezon numarası |
| bölüm | tam sayı | isteğe bağlı TV dizisinin bölüm numarası (sezonda) |
| resimler | Resim[] | isteğe bağlı: İçerikle ilişkili resme ait URL dizisi. Alanın ilk değeri, gönderen tarafından Load (Yükle) iletisinde belirtilebilir. Önerilen boyutların sağlanması gerekir |
| orijinalAirDate | dizesi (ISO 8601) | isteğe bağlı: Bu bölümün yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id parametresini kullanarak orijinalAirDate'i bağımsız olarak alabilir veya gönderen tarafından Load (Yükle) mesajında belirtilebilir |
MüzikTakipMedyaMeta Verileri
Müzik parçası medya yapısını açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 3 (tek değer) |
| albümadı | string | isteğe bağlı Bu parçanın çizildiği albüm veya koleksiyon. Oynatıcı, content_id öğesini kullanarak bağımsız olarak albüm adını alabilir veya gönderen tarafından Load mesajıyla verilebilir |
| title | string | 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 Yükle mesajında gönderen tarafından verilebilir |
| albümsanadı | string | 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 kapağını bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından sağlanabilir |
| sanatçı | string | isteğe bağlı Medya parçasıyla ilişkili sanatçının adı. Oynatıcı, content_id parametresini kullanarak sanatçıyı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından sağlanabilir |
| birleştirici | string | isteğe bağlı Medya parçasıyla ilişkili bestecinin adı. Oynatıcı, content_id kullanarak bağımsız olarak oluşturucuyu alabilir veya Load mesajında gönderen tarafından verilebilir |
| parça numarası | tam sayı | isteğe bağlı Albümdeki parça sayısı |
| discNumber | tam sayı | isteğe bağlı: Albümün ses seviyesi (örneğin, disk) |
| resimler | Resim[] | isteğe bağlı: İçerikle ilişkili resme ait URL dizisi. Alanın ilk değeri, gönderen tarafından Load (Yükle) iletisinde belirtilebilir. Önerilen boyutların sağlanması gerekir |
| yayın tarihi | dizesi (ISO 8601) | isteğe bağlı: Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, contentDate kimliğini kullanarak publishDate'i bağımsız olarak alabilir veya gönderen tarafından Load (Yükle) iletisinde belirtilebilir |
Fotoğraf ve Meta Veri
Bir fotoğraf medya yapısını tarif eder.
| Ad | Tür | Açıklama |
|---|---|---|
| metadataType | tam sayı | 4 (tek değer) |
| title | string | isteğe bağlı: Fotoğrafın başlığı. Oynatıcı, content_id parametresini kullanarak başlığı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından verilebilir |
| sanatçı | string | isteğe bağlı: Fotoğrafçının adı. Oynatıcı, content_id parametresini kullanarak sanatçıyı bağımsız olarak alabilir veya Yükle mesajında gönderen tarafından sağlanabilir |
| konum | string | isteğe bağlı: Fotoğrafın çekildiği yer (örneğin, "Madrid, İspanya"). Oynatıcı, content_id parametresini kullanarak konumu bağımsız olarak alabilir veya gönderen tarafından Load mesajında belirtilebilir |
| latitude | double | isteğe bağlı: Fotoğrafın çekildiği konumun coğrafi enlem değeri. Oynatıcı, Content_id parametresini kullanarak enlemi bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir |
| longitude | double | isteğe bağlı: Fotoğrafın çekildiği konumun coğrafi boylam değeri. Oynatıcı, boylamı content_id kullanarak bağımsız olarak alabilir veya gönderen tarafından Load (Yükle) iletisinde sağlanabilir. |
| genişlik | tam sayı | isteğe bağlı: Fotoğrafın piksel cinsinden genişliği. Oynatıcı genişliği content_id kullanarak bağımsız olarak alabilir veya gönderen tarafından Yükle mesajında 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 gönderen tarafından Load mesajında belirtilebilir |
| creationDateTime | dizesi (ISO 8601) | isteğe bağlı: Bu fotoğrafın çekildiği ISO 8601 tarih ve saati. Oynatıcı, contentDateid'i kullanarak createDateTime'ı bağımsız olarak alabilir veya gönderen tarafından Load iletisinde sağlanabilir. |
MedyaDurumu
Medya yapısının oturumla ilişkili mevcut durumunu açıklar.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | Bu oturumun oynatılmasına ilişkin benzersiz kimlik. Bu kimlik LOAD'daki alıcı tarafından ayarlanır ve bir oynatmanın belirli bir örneğini tanımlamak için kullanılabilir. Örneğin, aynı oturumda yer alan "Keşke burada olsaydınız" şeklinde iki oynatmanın her birinde benzersiz mediaSessionId olur. |
| medya | Medya bilgileri | isteğe bağlı (durum mesajları için) Oynatılan içeriğin tam açıklaması. Yalnızca MediaInformation değiştiyse bir durum mesajında döndürülür. |
| oynatma oranı | kayan noktalı | Medya süresinin ne kadar ilerlediğini ve hangi hızda ilerlediğini gösterir. Medya zamanı herhangi bir durumda durabileceğinden bu işlem, oynatıcı durumundan bağımsızdır. 1,0 normal zaman, 0,5 ağır çekimdir |
| oyuncu durumu | enum (dize) | Oynatıcının durumunu aşağıdakilerden biri olarak açıklar:
|
| nodu | enum (dize) | isteğe bağlı: Oyuncu durumu IDLE ise ve IDLE bilinme nedeni biliniyorsa bu özellik sağlanır. Oyuncunun henüz başlatılmış olması boştaysa bu özellik sağlanmaz. Oynatıcı başka bir durumdaysa bu özellik sağlanmamalıdır. Aşağıdaki değerler geçerlidir:
|
| mevcutSaat | double | Medya oynatıcının içeriğin başından itibaren mevcut konumu (saniye cinsinden). Bu bir canlı yayın içeriğiyse bu alan, oyuncunun etkinliğinden haberdar olması gereken, etkinliğin başlangıcından itibaren saniye cinsinden süreyi temsil eder. |
| desteklenenMediaCommands | flags | Medya oynatıcının desteklediği medya komutlarını açıklayan işaretler:
Kombinasyonlar özet olarak tanımlanır. Örneğin, Duraklat+Ara+AkışSes+Sesi Kapat == 15. |
| hacim | Hacim | Canlı yayın hacmi |
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı 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 veri iletilmezse alıcı uygun şekilde bozulmalıdır). Bu, genel uzaktan kumanda uygulamalarının düzgün çalışmasını sağlar.
Yük
Yeni içeriği medya oynatıcıya yükler.
| Ad | Tür | Açıklama |
|---|---|---|
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | YÜKLE (yalnızca değer) |
| medya | Medya bilgileri | Yüklenecek medyanın meta verisi (contentId dahil) |
| otomatik oynat | boolean | optional(varsayılan değer doğru) - Otomatik oynatma parametresi belirtilirse medya oynatıcı, içeriği yüklendikten sonra içeriği oynatmaya başlar. Otomatik oynatma belirtilmemiş olsa bile medya oynatıcı uygulaması oynatmayı hemen başlatmayı seçebilir. Oynatma başlatıldığında yanıttaki oynatıcı durumu BUARERING olarak ayarlanmalıdır, aksi takdirde DURAKLATILMIŞ olarak ayarlanmalıdır |
| mevcutSaat | double | isteğe bağlı: İçeriğin başlangıcından itibaren geçen saniye sayısı. İçerik canlı içerikse ve konum belirtilmezse akış canlı konumda başlar |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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 Yükleme Başarısız Oldu Yükleme İptal Edildi |
Duraklat
Geçerli içeriğin oynatılmasını duraklatır. Tüm gönderen uygulamaları için STATUS etkinlik bildirimini tetikler.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | Duraklatılacak medya oturumunun kimliği |
| istek kimliği | tam sayı | İsteğin kimliği ile isteği/yanıtı ilişkilendirmek için kullanılır |
| tür | string | DURAKLAT (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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ı | Oyuncu Durumu Geçersiz |
Git
Akıştaki mevcut konumu ayarlar. Tüm gönderen uygulamaları için STATUS etkinlik bildirimini tetikler. Belirtilen konum mevcut içerik için geçerli konum aralığının dışındaysa oyuncu istenen konuma mümkün olduğunca yakın bir geçerli konum seçmelidir.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | Akış konumunun ayarlandığı medya oturumunun kimliği |
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | SEEK (yalnızca değer) |
| resumeState | enum (dize) | isteğe bağlı: Bu politika ayarlanmazsa oynatma durumu değişmez; aşağıdaki değerler geçerli olur:
|
| mevcutSaat | double | isteğe bağlı: İçeriğin başlangıcından itibaren geçen saniye sayısı. İçerik canlı içerikse ve konum belirtilmezse akış canlı konumda başlar |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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ı | Oyuncu Durumu Geçersiz |
Durdur
Mevcut içeriğin oynatılmasını durdurur. Tüm gönderen uygulamaları için STATUS etkinlik bildirimini tetikler. Bu komuttan sonra içerik yüklenmez ve mediaSessionId geçersiz kılınır.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | İçeriğin durdurulacağı medya oturumunun kimliği |
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | STOP (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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ı | Oyuncu Durumu Geçersiz |
Oynat
Yükleme çağrısıyla yüklenen içeriğin oynatılmasını başlatır ve oynatmaya geçerli zaman konumundan devam edilir.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | Oynatılacak içeriğin oturum oturumu |
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | PLAY (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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ı | Oyuncu Durumu Geçersiz |
Durum Bilgisi Alın
Medya durumunu alır.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | isteğe bağlı Medya durumunun döndürülmesi gereken medyanın medya oturumu kimliği. Herhangi bir medya kimliği sağlanmamışsa tüm medya oturumu kimliklerinin durumu gösterilir. |
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | GET_STATUS(yalnızca değer) |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı uygulamaya özel veri blob'u |
| Yanıt | Tetikleyiciler | Yayınlar | Hatalar |
|---|---|---|---|
| İstekte bulunan gönderene MediaStatus mesajı | Yok | Yok | Yok |
Ses Düzeyini Ayarla
Medya akışı ses düzeyini ayarlar. Medya akışın şeffaf ya da tamamen belirmesi için kullanılır. (Not: Alıcı hacmi, web göndericisi setVolume kullanılarak değiştirilir.) Cihazın sesini kontrol etmek için ses düzeyi kaydırma çubuğu veya ses düğmeleriyle birlikte akış ses düzeyinin kullanılmamalıdır. Akış hacmindeki bir değişiklik, alıcıdaki herhangi bir kullanıcı arayüzünü tetiklemez.
| Ad | Tür | Açıklama |
|---|---|---|
| medyaOturumKimliği | tam sayı | Akış ses düzeyinin değiştirildiği medyanın Medya Oturum Kimliği |
| istek kimliği | tam sayı | İsteğin ve yanıtın ilişkilendirilmesi için isteğin kimliği |
| tür | string | VOLUME (yalnızca değer) |
| hacim | Hacim | Canlı yayın hacmi |
| özelveri | nesne | isteğe bağlı Gönderen uygulamanın tanımladığı 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ı | Oyuncu Durumu Geçersiz |
Alıcıdan gönderene gönderilen iletiler
Alıcı iki tür mesaj gönderir:
- Hatalar: Gönderen isteğine yanıt verildiğinde hata mesajı gönderilir.
- Durum: Mesajları yayınlama.
- Gönderen tarafından başlatılan bir işlemin sonucu. Değişime neden olan isteğin requestId değerini içerir.
- Spontane: Örneğin, alıcı uygulama tarafından tetiklenen bir değişiklik nedeniyle. RequestId 0 olacak.
Hata: Geçersiz Oyuncu Durumu
Oynatıcı geçerli bir durumda olmadığı için gönderen tarafından istek yerine getirilemediğinde gönderilir. Örneğin, uygulama henüz bir medya öğesi oluşturmadıysa.
| Ad | Tür | Açıklama |
|---|---|---|
| istek kimliği | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | string | INVALID_PLAYER_STATE (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı 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. Oyuncu durumu IDLE olacaktır.
| Ad | Tür | Açıklama |
|---|---|---|
| istek kimliği | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | string | LOAD_FAILED (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı 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 |
|---|---|---|
| istek kimliği | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | string | LOAD_CANCELLED (yalnızca değer) |
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı uygulamaya özel veri blob'u |
Hata: Geçersiz İstek
İstek geçersiz olduğunda gönderilir (örneğin, bilinmeyen bir istek türü).
| Ad | Tür | Açıklama |
|---|---|---|
| istek kimliği | tam sayı | Bu hatayı oluşturan isteğin kimliği |
| tür | string | INVALID_REQUEST (yalnızca değer) |
| nedeni | Sıralama (dize) | Değerler:
|
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı uygulamaya özel veri blob'u |
Medya durumu
Durum değişikliğinden veya medya durumu isteğinden sonra gönderilir. Yalnızca değişen veya istenen MediaStatus nesneleri gönderilir.
| Ad | Tür | Açıklama |
|---|---|---|
| istek kimliği | tam sayı | Bu durum yanıtını, oluşturan istekle ilişkilendirmek için kullanılan kimlik veya durum mesajının spontane olması durumunda 0 (bir gönderen isteği tarafından tetiklenmez). Gönderen uygulamalar, rastgele bir sayı seçip bu sayıyı sürekli artırarak benzersiz istek kimlikleri oluşturur (0 kullanmazlar). |
| tür | string | MEDIA_STATUS (yalnızca değer) |
| durum | MedyaDurumu[] | Medya Durumu nesne dizisi. NOT: MediaStatus medya öğesi yalnızca değiştiyse döndürülür. |
| özelveri | nesne | isteğe bağlı Alıcı uygulamanın tanımladığı uygulamaya özel veri blob'u |