Medya Oynatma Mesajları

Google Cast gönderen uygulamaları, alıcı uygulamasına JSON biçiminde mesajlar göndererek alıcı cihazdaki oynatmayı kontrol eder. Aynı şekilde, alıcı da gönderene JSON biçiminde mesajlar gönderir. İletiler, gönderenden gelen ve oynatıcı durumunu değiştiren komutlar, alıcıdan gelen bu komutlara verilen yanıtlar veya alıcı uygulaması için medyayı açıklayan veri yapıları olabilir.

Google Cast SDK Ek Geliştirici Hizmet Şartları uyarınca, Cast medya uygulaması, alıcıda medya oynatmayı kontrol etmek için burada tanımlandığı şekilde bu mesajları kullanmalıdır. Bu sayede medya uygulaması, platformlar arasında tutarlı bir kullanıcı deneyimi sunar ve Cast uygulamasının yeni ve gelecekteki kullanım alanlarını desteklemesi sağlanır. Bu yapılar, uygun olduğu 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 iletiler ve yapılar, bir aktarım iletisinin maksimum boyutuyla belirlenen örtülü bir maksimum boyuta sahiptir. Bağımsız alanlar için bir sınır yoktur. Taşıma iletisinin maksimum boyutu şu anda 64 KB'tır.

Sık kullanılan ad alanı veri yapıları

Tüm medya ad alanı yapıtları tarafından kullanılan veri yapılarının üst kümesi, ortak bir ad alanında tanımlanır.

Resim

Bu, gönderen uygulamanın, görüntüleri nasıl oluşturacağına bağlı olarak resim seçmesine olanak tanıyan az miktarda meta veri içeren bir resmin açıklamasıdır.

Yükseklik ve genişlik, Resimler dizisindeki yalnızca bir öğede isteğe bağlıdır. Örneğin, tek bir öğe döndürülürse bunlar isteğe bağlıdır. İki öğe döndürülürse bir öğe yükseklik ve genişlik belirtmelidir ancak gönderen, belirli parametrelerle iletilen öğeyi beğenmezse "varsayılan" seçeneğini kullanmayı tercih edebilir.

Ad Tür Açıklama
url URI Resmin URI'si
height tam sayı isteğe bağlı Resmin yüksekliği
width tam sayı isteğe bağlı Resmin genişliği

Ses

Medya akışının ses düzeyi. Medya akışında fade-in/fade-out efektleri için kullanılır. (Not: Sistem ses düzeyi, gönderen API'leri kullanılarak değiştirilir.) Yayın ses seviyesi, cihazın ses seviyesini kontrol etmek için ses kaydırma çubuğu veya ses düğmeleriyle birlikte kullanılmamalıdır. Akış sesini değiştirmek için aşağıdaki parametrelerden en az biri iletilmelidir.

Ad Tür Açıklama
level çift isteğe bağlı Mevcut akış ses seviyesi, 1,0'ın maksimum ses olduğu 0,0 ile 1,0 arasındaki bir değer olarak.
muted boole isteğe bağlı Ses seviyesinden bağımsız olarak Cast 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'dır.

MediaInformation

Bu veri yapısı, bir medya akışını tanımlar.

Ad Tür Açıklama
contentId dize Medya oynatıcı tarafından şu anda yüklenen 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 iletmeyi seçebilir. Maks. uzunluk: 1.000
streamType enum
(dize)

Medya yapısının türünü aşağıdakilerden biri olarak açıklar:

  • YOK
  • BUFFERED
  • LIVE
contentType dize Oynatılan medyanın MIME içerik türü
meta veri nesne

isteğe bağlı Medya meta verileri nesnesi (aşağıdakilerden biri):

duration çift isteğe bağlı Şu anda oynatılan akışın saniye cinsinden süresi
customData nesne isteğe bağlı Gönderen uygulama veya alıcı uygulama tarafından tanımlanan, uygulamaya özgü veri blobu

GenericMediaMetadata

Genel bir medya yapıtını açıklar.

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 kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
subtitle dize isteğe bağlı İçeriğin açıklayıcı alt başlığı. Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
images Resim[] isteğe bağlı İçerikle ilişkili bir resmin URL'lerinin dizisi. Alan için başlangıç değeri, gönderen tarafından Yükle mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır.
releaseDate dize (ISO 8601) isteğe bağlı Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.

MovieMediaMetadata

Bir film medya yapısını tanımlar.

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 kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
subtitle dize isteğe bağlı İçeriğin açıklayıcı alt başlığı. Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
studio dize isteğe bağlı İçeriği yayınlayan stüdyo. Oynatıcı, content_id kullanarak stüdyoyu bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
images Resim[] isteğe bağlı İçerikle ilişkili bir resmin URL'lerinin dizisi. Alan için başlangıç değeri, gönderen tarafından Yükle mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır.
releaseDate dize (ISO 8601) isteğe bağlı Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.

TvShowMediaMetadata

Bir televizyon programı bölümü medya yapıtını 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 kullanarak başlığı bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
subtitle dize isteğe bağlı TV bölümünün açıklayıcı alt başlığı. Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya başlık, gönderen tarafından Load mesajında verilebilir.
season tam sayı isteğe bağlı TV programının sezon numarası
episode tam sayı isteğe bağlı TV programının bölüm numarası (sezon içindeki)
images Resim[] isteğe bağlı İçerikle ilişkili bir resmin URL'lerinin dizisi. Alanının ilk değeri, gönderen tarafından Yükle mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır.
originalAirDate dize (ISO 8601) isteğe bağlı Bu bölümün yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id kullanarak originalAirDate değerini bağımsız olarak alabilir veya bu değer, gönderen tarafından Load mesajında verilebilir.

MusicTrackMediaMetadata

Bir müzik parçası medya yapıtını açıklar.

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 kullanarak albumName değerini bağımsız olarak alabilir veya bu değer, gönderen tarafından Load mesajında verilebilir.
title dize isteğe bağlı Parçanın adı (örneğin, şarkı başlığı). Oynatıcı, content_id kullanarak başlığı bağımsız olarak alabilir veya başlık, gönderen tarafından Load mesajında verilebilir.
albumArtist dize isteğe bağlı Bu parçanın yer aldığı albümle ilişkili sanatçının adı. Oynatıcı, content_id kullanarak albumArtist değerini bağımsız olarak alabilir veya bu değer, gönderen tarafından Load mesajında verilebilir.
artist dize isteğe bağlı Medya parçasıyla ilişkili sanatçının adı. Oynatıcı, sanatçıyı content_id kullanarak bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
composer dize isteğe bağlı  Medya parçasıyla ilişkili bestecinin adı. Oyuncu, besteciyi content_id kullanarak bağımsız olarak alabilir veya gönderen, besteciyi Load (Yükle) mesajında verebilir.
trackNumber tam sayı isteğe bağlı Albümdeki parçanın numarası
discNumber tam sayı isteğe bağlı Albümün biriminin (örneğin, disk) numarası
images Resim[] isteğe bağlı İçerikle ilişkili bir resmin URL'lerinin dizisi. Alanının ilk değeri, gönderen tarafından Yükle mesajında sağlanabilir. Önerilen boyutlar sağlanmalıdır.
releaseDate dize (ISO 8601) isteğe bağlı Bu içeriğin yayınlandığı ISO 8601 tarih ve saati. Oynatıcı, content_id kullanarak releaseDate değerini bağımsız olarak alabilir veya bu değer, gönderen tarafından Load mesajında verilebilir.

PhotoMediaMetadata

Fotoğrafik medya yapaylığını tanımlar.

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 kullanarak başlığı bağımsız olarak alabilir veya başlık, gönderen tarafından Load mesajında verilebilir.
artist dize isteğe bağlı Fotoğrafçının adı. Oynatıcı, sanatçıyı content_id kullanarak bağımsız olarak alabilir veya gönderen tarafından Load mesajında verilebilir.
location dize isteğe bağlı Fotoğrafın çekildiği yerin sözlü açıklaması (ör. "Madrid, İspanya"). Oynatıcı, content_id kullanarak konumu bağımsız olarak alabilir veya konum, gönderen tarafından Load mesajında verilebilir.
latitude çift isteğe bağlı Fotoğrafın çekildiği konumun coğrafi enlem değeri. Oyuncu, enlemi content_id kullanarak bağımsız olarak alabilir veya gönderen, enlemi Load (Yükle) mesajında verebilir.
longitude çift isteğe bağlı Fotoğrafın çekildiği konumun coğrafi boylam değeri. Oyuncu, content_id kullanarak boylamı bağımsız olarak alabilir veya gönderen, Load mesajında boylamı verebilir.
width 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, Load mesajında genişliği verebilir.
height tam sayı isteğe bağlı Fotoğrafın piksel cinsinden yüksekliği. Oynatıcı, content_id kullanarak yüksekliği bağımsız olarak alabilir veya gönderen, Load mesajında yüksekliği verebilir.
creationDateTime dize (ISO 8601) isteğe bağlı Bu fotoğrafın çekildiği ISO 8601 tarih ve saati. Oynatıcı, content_id kullanarak creationDateTime değerini bağımsız olarak alabilir veya bu değer, gönderen tarafından Load mesajında verilebilir.

MediaStatus

Medya yapay nesnesinin oturumla ilgili mevcut durumunu açıklar.

Ad Tür Açıklama
mediaSessionId tam sayı Bu oturumun oynatılması için benzersiz kimlik. Bu kimlik, LOAD sırasında alıcı tarafından ayarlanır ve belirli bir oynatma örneğini tanımlamak için kullanılabilir. Örneğin, aynı oturumda "Wish you were here" şarkısının iki kez çalınması durumunda her çalma işleminin benzersiz bir mediaSessionId değeri olur.
media MediaInformation isteğe bağlı (durum mesajları için) Oynatılan içeriğin tam açıklaması. Yalnızca MediaInformation değiştiyse durum mesajında döndürülür.
playbackRate kayan noktalı Medya süresinin ilerleyip ilerlemediğini ve ilerliyorsa hangi hızda ilerlediğini gösterir. Medya süresi herhangi bir durumda durdurulabildiğinden bu, oynatıcı durumundan bağımsızdır. 1,0 normal zaman, 0,5 ise ağır çekimdir.
playerState enum (dize)

Oynatıcının durumunu aşağıdakilerden biri olarak açıklar:

  • IDLE  Oynatıcı henüz yüklenmedi
  • OYNATMA  Oynatıcı, içeriği aktif olarak oynatıyor
  • ARABELLEĞE ALMA  Oynatıcı, OYNATMA modunda ancak içerik etkin olarak oynatılmıyor (currentTime değişmiyor)
  • DURAKLATILDI  Oynatıcı duraklatıldı
idleReason enum (dize)

isteğe bağlı playerState IDLE ise ve IDLE olmasının nedeni biliniyorsa bu özellik sağlanır. Oynatıcı yeni başladığı için BOŞTA ise bu özellik sağlanmaz. Oynatıcı başka bir durumdaysa bu özellik sağlanmamalıdır. Aşağıdaki değerler geçerlidir:

  • İPTAL EDİLDİ  Bir gönderen, STOP komutunu kullanarak oynatmayı durdurma isteğinde bulundu
  • KESİNTİYE UĞRADI  Bir gönderen, LOAD komutunu kullanarak farklı bir medya oynatılmasını istedi.
  • BİTTİ  Medya oynatma tamamlandı
  • HATA  Medya, bir hata nedeniyle kesintiye uğradı. Örneğin, oynatıcı ağ sorunları nedeniyle medyayı indiremedi.
currentTime çift İçeriğin başlangıcından itibaren medya oynatıcının mevcut konumu (saniye cinsinden). Bu bir canlı yayın içeriğiyse bu alan, etkinliğin başlangıcından itibaren oyuncunun bilmesi gereken süreyi saniye cinsinden ifade eder.
supportedMediaCommands flags

Medya oynatıcının desteklediği medya komutlarını açıklayan işaretler:

  • 1 << 0  Duraklatma
  • 1 << 1  Ara
  • 1 << 2  Akış hacmi
  • 1 << 3  Akışta sesi kapatma
  • 1 << 4  İleri atla (desteği sonlandırıldı)
  • 1 << 5  Geri atla (desteği sonlandırıldı)
  • 1 << 6  Sıradakine geç
  • 1 << 7  Önceki öğeyi sıraya ekle
  • 1 << 8  Sırayı karışık çalma
  • 1 << 9  Reklamı atla
  • 1 << 10  Tümünü tekrarla
  • 1 << 11  Bir kez tekrarla
  • 1 << 12  Parçaları düzenleme
  • 1 << 13  Oynatma hızı
  • 1 << 14  Beğeni
  • 1 << 15  Beğenmeme
  • 1 << 16  Takip etme
  • 1 << 17  Takibi bırak

Kombinasyonlar toplama olarak tanımlanır. Örneğin, Pause+Seek+StreamVolume+Mute == 15.
volume Ses düzeyi Akış hacmi
customData nesne isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blobu

Gönderenden alıcıya gönderilen komutlar

Bu komutlar, medya oynatıcıyı kontrol eder. Aşağıdaki mesajlardaki tüm customData nesneleri isteğe bağlı olmalıdır (ör. alıcı, veri iletilmezse düzgün şekilde düşürmelidir). Bu sayede, genel uzaktan kumanda uygulamaları düzgün şekilde çalışabilir.

Yükleme

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 kullanılan istek kimliği
type dize LOAD (yalnızca değer)
media MediaInformation Yüklenecek medyanın meta verileri (contentId dahil)
autoplay boole

isteğe bağlı (varsayılan değer true'dur) Otomatik oynatma parametresi belirtilirse medya oynatıcı, içerik yüklendiğinde oynatmaya başlar. Otomatik oynatma belirtilmemiş olsa bile medya oynatıcı uygulaması, oynatmayı hemen başlatmayı seçebilir. Oynatma başlatılırsa yanıttaki oynatıcı durumu BUFFERING olarak ayarlanmalı, aksi takdirde PAUSED olarak ayarlanmalıdır.
currentTime çift optional İç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 blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya Durumu Değişikliği mesajı Invalid Player State
Load Failed
Load Cancelled

Duraklat

Geçerli içeriğin oynatılmasını duraklatır. Tüm gönderen uygulamalarına bir STATUS etkinlik bildirimi tetikler.

Ad Tür Açıklama
mediaSessionId tam sayı Duraklatılacak medya oturumunun kimliği
requestId tam sayı İstek/yanıtı ilişkilendirmek için kullanılacak istek kimliği
type dize PAUSE (yalnızca değer)
customData nesne isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya durumu değişikliği mesajı Geçersiz Oynatıcı Durumu

Ara

Akışta geçerli konumu ayarlar. Tüm gönderen uygulamalarına bir STATUS etkinlik bildirimi tetikler. Sağlanan pozisyon, mevcut içerik için geçerli pozisyon aralığının dışındaysa oynatıcı, istenen pozisyona mümkün olduğunca yakın geçerli bir pozisyon seçmelidir.

Ad Tür Açıklama
mediaSessionId tam sayı Akışın konumunun ayarlandığı medya oturumunun kimliği
requestId tam sayı İstek ve yanıtı ilişkilendirmek için kullanılan istek kimliği
type dize SEEK (yalnızca değer)
resumeState enum (dize)

isteğe bağlı Bu ayarlanmazsa oynatma durumu değişmez. Aşağıdaki değerler geçerlidir:

  • PLAYBACK_START  Medyanın başlatılmasını zorlar.
  • PLAYBACK_PAUSE  Medyanın duraklatılmasını zorunlu kılar.
currentTime çift optional İç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 blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya Durumu Değişikliği mesajı Geçersiz Oynatıcı Durumu

Durdur

Mevcut içeriğin oynatılmasını durdurur. Tüm gönderen uygulamalarına bir STATUS etkinlik bildirimi tetikler. Bu komuttan sonra içerik yüklenmez ve mediaSessionId geçersiz kılınır.

Ad Tür Açıklama
mediaSessionId tam sayı Durdurulacak içeriğin medya oturumunun kimliği
requestId tam sayı İstek ve yanıtı ilişkilendirmek için kullanılan istek kimliği
type dize STOP (yalnızca değer)
customData nesne isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya Durumu Değişikliği mesajı Geçersiz Oynatıcı Durumu

Oynat

Yükleme çağrısıyla yüklenen içeriğin oynatılmasına başlanı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 kullanılan istek kimliği
type dize PLAY (yalnızca değer)
customData nesne isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya Durumu Değişikliği mesajı Geçersiz Oynatıcı Durumu

Durumu Alma

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. Hiçbiri sağlanmazsa tüm medya oturumu kimliklerinin durumu sağlanır.
requestId tam sayı İstek ve yanıtı ilişkilendirmek için kullanılan istek kimliği
type dize GET_STATUS (tek değer)
customData nesne isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
İsteyen gönderene MediaStatus mesajı Yok Yok Yok

SetVolume

Medya akışının ses düzeyini ayarlar. Medya akışında yavaş yavaş açılma/kapanma efektleri için kullanılır. (Not: Alıcı ses düzeyi, Web gönderen setVolume kullanılarak değiştirilir.) Yayın ses seviyesi, cihazın ses seviyesini kontrol etmek için ses kaydırma çubuğu veya ses düğmeleriyle birlikte kullanılmamalıdır. Akış ses düzeyindeki bir değişiklik, alıcıda herhangi bir kullanıcı arayüzünü tetiklemez.

Ad Tür Açıklama
mediaSessionId tam sayı Akış sesinin değiştirildiği medyanın medya oturumu kimliği
requestId tam sayı İstek ve yanıtı ilişkilendirmek için kullanılan istek kimliği
type dize HACİM (yalnızca değer)
volume Ses düzeyi Akış hacmi
customData nesne isteğe bağlı Gönderen uygulama tarafından tanımlanan uygulamaya özel veri blobu
Yanıt Tetikleyiciler Yayınlar Hatalar
Yok Alıcı durum değişikliği Medya Durumunda Değişiklik mesajı Geçersiz Oynatıcı Durumu

Alıcıdan gönderene gönderilen iletiler

Alıcı iki tür mesaj gönderir:

  • Hatalar: Gönderen isteğine hata yanıtı verildiğinde tek noktaya yayın mesajları gönderilir.
  • Durum: Yayın mesajları.
    • Gönderen tarafından başlatılan bir işlemin sonucu. Değişikliğe neden olan isteğin requestId'sini içerir.
    • Kendiliğinden: Örneğin, alıcı uygulaması tarafından tetiklenen bir değişiklik nedeniyle. RequestId 0 olur.

Hata: Geçersiz oynatıcı durumu

Oynatıcı geçerli bir durumda olmadığından gönderenin 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
type dize INVALID_PLAYER_STATE (yalnızca değer)
customData nesne isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blobu

Hata: Yükleme başarısız oldu

Yükleme isteği başarısız olduğunda gönderilir. Oyuncu durumu IDLE olur.

Ad Tür Açıklama
requestId tam sayı Bu hatayı oluşturan isteğin kimliği
type dize LOAD_FAILED (yalnızca değer)
customData nesne isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blobu

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
type dize LOAD_CANCELLED (tek değer)
customData nesne isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blobu

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
type dize INVALID_REQUEST (yalnızca değer)
neden Enum (dize)

Değerler:

  • INVALID_COMMAND  Komut desteklenmiyor
  • DUPLICATE_REQUESTID  İstek kimliği benzersiz değil (alıcı, aynı kimliğe sahip bir isteği işliyor)
customData nesne isteğe bağlı Alıcı uygulama tarafından tanımlanan uygulamaya özel veri blobu

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
requestId tam sayı Bu durum yanıtını, onu başlatan istekle ilişkilendirmek için kullanılan kimlik veya durum mesajı kendiliğinden oluşuyorsa (bir gönderen isteği tarafından tetiklenmediyse) 0. Gönderen uygulamaları, rastgele bir sayı seçip sürekli olarak artırarak (0 kullanmazlar) benzersiz istek kimlikleri oluşturur.
type dize MEDIA_STATUS (yalnızca değer)
status MediaStatus[] Medya durumu nesneleri dizisi. NOT: MediaStatus'taki 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 blobu