Sınıf: CastReceiverContext

cast.framework.CastReceiverContext

class   static

Temel kitaplıkların yüklenmesini yönetir ve temel Cast alıcı SDK'sını başlatır.

Verdiği hatalar

non-null Error MediaElement, doküman gövdesinde oluşturulmamışsa. Birden fazla medya öğesi oluşturulursa geliştirici, CAF alıcısının kullanacağı öğelerden birine "castMediaElement" sınıfını ayarlamalıdır.

Yöntemler

getInstance

static

getInstance() returns cast.framework.CastReceiverContext

CastReceiverContext tekil örneğini döndürür.

İadeler

non-null cast.framework.CastReceiverContext 

addCustomMessageListener

addCustomMessageListener(namespace, listener)

Özel bir mesaj kanalı için mesaj dinleyici ayarlar. Bir ad alanı için birden fazla dinleyiciye izin verilir.

Parametre

ad alanı

dize

Ad alanı. Geçerli bir ad alanının önüne "urn:x-cast:" dizesinin eklenmesi gerektiğini unutmayın.

işleyici

function(non-null cast.framework.system.Message)
Verdiği hatalar

Error Sistem hazır değilse veya ad alanı bu uygulama tarafından desteklenmiyorsa.

addEventListener

addEventListener(type, handler)

Yayın sistemi etkinliklerine işleyici ekleyin.

Parametre

tür

cast.framework.system.EventType

Değer boş olmamalıdır.

handler

function(non-null cast.framework.system.Event)

canDisplayType

canDisplayType(mimeType, codecs, width, height, framerate) boole değeri döndürür

Video veya ses akışlarının verilen medya parametrelerinin platform tarafından desteklenip desteklenmediğini kontrol eder.

Parametre

mimeType

dize

Medya MIME türü. Bir "/" ile ayrılmış bir tür ve alt türden oluşur. Video veya ses MIME türleri olabilir.

codec'ler

İsteğe bağlı

dize

Tırnak içine alınmış dize, virgülle ayrılmış biçim listesi içerir. Her biçim, akışta bulunan bir medya örneği türünü belirtir.

genişlik

İsteğe bağlı

sayı

Akışın piksel cinsinden yatay çözünürlüğünü açıklar.

yükseklik

İsteğe bağlı

sayı

Yayının piksel cinsinden dikey çözünürlüğünü açıklar.

framerate

İsteğe bağlı

sayı

Yayının kare hızını açıklar.
İadeler

boolean Yayın, Chromecast'te oynatılabiliyorsa.

getApplicationData

getApplicationData() cast.framework.system.ApplicationData döndürür.

Sistem hazır olduğunda uygulama bilgilerini sağlar, aksi takdirde boş olur.

İadeler

nullable cast.framework.system.ApplicationData Uygulama bilgileri veya sistem hazır değilse null.

getDeviceCapabilities

getDeviceCapabilities() returns cast.framework.system.DeviceCapabilitiesObj

Sistem hazır olduğunda cihaz özellikleri bilgilerini sağlar. Aksi takdirde boş olur. Boş bir nesne döndürülürse cihaz, özellik bilgisi göstermez.

İadeler

nullable cast.framework.system.DeviceCapabilitiesObj Cihaz özellikleri bilgileri (anahtar/değer çiftleri). Sistem henüz hazır değilse boş olur. Platform, cihaz özellikleri bilgilerini göstermiyorsa boş bir nesne olabilir.

getDeviceInformation

getDeviceInformation() returns cast.framework.system.DeviceInformationObj

Sistem hazır olduğunda cihazın özellikleriyle ilgili olmayan tanımlayıcı bilgileri sağlar. Aksi takdirde "null" değerini döndürür. Boş bir nesne döndürülürse cihaz bu tür bilgileri göstermez.

İadeler

nullable cast.framework.system.DeviceInformationObj Cihaz bilgileri (anahtar/değer çiftleri). Sistem henüz hazır değilse boş olur. Platform bu bilgileri göstermiyorsa boş bir nesne olabilir.

getPlayerManager

getPlayerManager() returns cast.framework.PlayerManager

Medya oynatmayı kontrol edip izleyebilen Player örneğini alın.

İadeler

non-null cast.framework.PlayerManager 

getSender

getSender(senderId) returns cast.framework.system.Sender

Gönderen kimliğine göre gönderen alma

Parametre

senderId

dize

Döndürülecek gönderenin kimliği.
İadeler

nullable cast.framework.system.Sender 

getSenders

getSenders() returns Array of non-null cast.framework.system.Sender

Şu anda bağlı olan gönderenlerin listesini alır.

İadeler

non-null Array of non-null cast.framework.system.Sender 

getStandbyState

getStandbyState() returns cast.framework.system.StandbyState

Yayın uygulamasının HDMI girişinin bekleme modunda olup olmadığını bildirir.

İadeler

non-null cast.framework.system.StandbyState Uygulamanın HDMI girişinin bekleme modunda olup olmadığı. TV, CEC komutlarını desteklemediği için belirlenemiyorsa döndürülen değer UNKNOWN olur.

getSystemState

getSystemState() returns cast.framework.system.SystemState

Sistem durumuyla ilgili uygulama bilgileri sağlar.

İadeler

non-null cast.framework.system.SystemState Sistem durumu.

getVisibilityState

getVisibilityState() returns cast.framework.system.VisibilityState

Yayın uygulamasının HDMI etkin girişi olup olmadığını bildirir.

İadeler

non-null cast.framework.system.VisibilityState Uygulamanın HDMI etkin girişi olup olmadığı. TV, CEC komutlarını desteklemediği için belirlenemiyorsa döndürülen değer UNKNOWN olur.

isSystemReady

isSystemReady() boole değeri döndürür

Uygulama çağrıları başladığında sistem, uygulama bilgilerinin hazır olduğunu ve uygulamanın bağlı bir gönderen olduğu anda mesaj gönderebileceğini belirtmek için hazır etkinliğini gönderir.

İadeler

boolean Sistemin mesajları işlemeye hazır olup olmadığı.

loadPlayerLibraries

loadPlayerLibraries(useLegacyDashSupport)

Oynatıcı js'sini yüklemeye başlayın. Bu, başlatma çağrısı yapılmadan önce alıcıyı başlatmanın erken aşamasında oynatıcıların js kodunu yüklemeye başlamak için kullanılabilir. Oynatıcılar zaten yüklüyse (başlatma çağrıldıysa) bu işlev işlem yapmaz.

Parametre

useLegacyDashSupport

İsteğe bağlı

boole

DASH içeriği için MPL'nin kullanılması gerektiğini belirtir.

removeCustomMessageListener

removeCustomMessageListener(namespace, listener)

Daha önce CastReceiverContext#addCustomMessageListener ile kaydedilmiş bir mesaj dinleyiciyi kaldırır.

Parametre

ad alanı

dize

Ad alanı. Geçerli bir ad alanının önüne "urn:x-cast:" dizesinin eklenmesi gerektiğini unutmayın.

işleyici

function(non-null cast.framework.system.Message)

Kaydı iptal edilecek mesaj işleyici işlevi.
Verdiği hatalar

Error Sistem hazır değilse veya ad alanı bu uygulama tarafından desteklenmiyorsa.

removeEventListener

removeEventListener(type, handler)

Yayın sistemi etkinliklerini dinleyen işleyiciyi kaldırır.

Parametre

tür

cast.framework.system.EventType

Değer boş olmamalıdır.

handler

function(non-null cast.framework.system.Event)

sendCustomMessage

sendCustomMessage(namespace, senderId, data)

Belirli bir gönderene mesaj gönderir.

Parametre

ad alanı

dize

Ad alanı. Geçerli bir ad alanının önüne "urn:x-cast:" dizesinin eklenmesi gerektiğini unutmayın.

senderId

(dize veya tanımsız)

senderId veya tüm gönderenlere yayın için tanımlanmamış.

veri

tüm türler

Mesaj yükü.

Değer boş olmamalıdır.
Verdiği hatalar

Error Mesaj hazırlanırken hata oluştuysa

sendFeedbackMessage

sendFeedbackMessage(feedbackMessage)

Uygulama, geri bildirim raporuna kaydedilecek hata ayıklama durumu bilgilerini eklerse bu işlev, feedbackstarted etkinliğine yanıt olarak çağrılmalıdır. Uygulamanın günlüğe kaydetmek istediği hata ayıklama bilgilerini temsil eden bir dize olan "message" parametresini alır.

Parametre

feedbackMessage

dize
Kullanımdan kaldırıldı
cast.framework.CastReceiverContext#setFeedbackHandler kullanın

setApplicationState

setApplicationState(statusText)

Uygulama durumunu ayarlar. Uygulama, durumu değiştiğinde bunu çağırmalıdır. Tanımlanmamışsa veya boş bir dizeye ayarlanmışsa uygulama durumu için varsayılan olarak uygulama kaydı sırasında belirlenen Uygulama Adı değeri kullanılır.

Parametre

statusText

dize

Durum metni.

setFeedbackHandler

setFeedbackHandler(feedbackHandler)

Geri bildirim raporuna ek veriler sağlamak için bir işleyici ayarlayın. İşleyici, bir geri bildirim raporu oluşturulduğunda çağrılır ve ek verileri dize veya dize vaadi olarak döndürmelidir. Döndürülen promise'in rapora dahil edilmesi için 5 saniye içinde çözümlenmesi gerekir.

Parametre

feedbackHandler

function()

Değer boş olabilir.

setInactivityTimeout

setInactivityTimeout(maxInactivity)

Alıcının işlem yapılmadığında zaman aşımına uğrama süresini ayarlar. Start çağrılırken maksimum etkinlik dışı kalma değerinin ayarlanması ve değiştirilmemesi önerilir. Bu API yalnızca geliştirme/hata ayıklama amacıyla sağlanır.

Parametre

maxInactivity

sayı

Yanıt vermeyen bir bağlantı kapatılmadan önce beklenecek süre (saniye cinsinden).

setLoggerLevel

setLoggerLevel(level)

Günlük ayrıntı düzeyini ayarlar.

Parametre

seviye

cast.framework.LoggerLevel

Günlük kaydı düzeyi.

Değer boş olmamalıdır.

start

start(options) returns cast.framework.CastReceiverContext

Alıcı uygulamanın gönderenlerden istek alabilmesi için sistem yöneticisini ve medya yöneticisini başlatır.

Parametre

seçenekler

(boş olmayan cast.framework.CastReceiverOptions veya isteğe bağlı boş olmayan nesne)
İadeler

non-null cast.framework.CastReceiverContext 

stop

stop(closeReason)

Alıcı uygulamasını kapatın.

Parametre

closeReason

İsteğe bağlı

cast.framework.common.CloseReason

Alıcı uygulamanın neden durdurulduğunu gösteren isteğe bağlı kapatma nedeni. Sağlanmazsa çerçeve, nedeni son medya oynatıcı etkinliklerine göre tahmin eder veya APP_REQUEST'e geri döner. Aşağıdaki sayısal değerlerden birini iletin:

  • 13 (APP_CUSTOM_STOP): Özel alıcı kullanıcı arayüzü/işletme işlemleri için (ör. kullanıcı uygulama içi "Çıkış" veya "Kapat" düğmesini tıklar, özel alıcı gezinme işlemi yayından uzaklaşır).
  • 15 (APP_ERROR): CAF'nin yerleşik oynatıcı hata etkinlikleri dışında gerçekleşen önemli uygulama düzeyindeki hatalar (ör. özel kimlik doğrulama hataları, DRM/lisans alma hataları, arka uç API kilitlenmeleri).
  • 14 (APP_PLAYBACK_FINISHED): Uygulama, oynatma listesini/sırasını tüketti veya bağımsız bir medya deneyimini tamamladı.
  • 6 (APP_REQUEST): Bir uygulama daha spesifik bir neden olmadan sonlandırma istediğinde genel/eski yedek.

Değer boş olmamalıdır.