Zajęcia: sesja

chrome.przesyłanie.Sesja

class   static

Opisuje stan uruchomionej aktualnie aplikacji Cast. Normalnie te obiekty nie powinny być tworzone przez klienta.

Zespół

Sesja

new Session(sessionId, appId, displayName, appImages, odbiorca)

Parametr
sessionId	ciąg znaków Identyfikator sesji.
appId	ciąg znaków Identyfikator aplikacji odbiorcy.
displayName	ciąg znaków Wyświetlana nazwa aplikacji.
appImages	Tablica nienull chrome.cast.Image Obrazy powiązane z aplikacją. Wartość nie może być wartością null.
odbiornik	chrome.cast.Receiver Odbiornik, na którym aplikacja jest uruchomiona. Wartość nie może być wartością null.

Właściwości

appId

ciąg znaków

Identyfikator aplikacji Cast. Nie do wyświetlania.

appImages

niepusta tablica chrome.cast.Image

Tablica dostępnych obrazów opisujących aplikację.

displayName

ciąg znaków

Czytelna dla człowieka nazwa aplikacji Cast, np. „YouTube”.

media

niepusta tablica chrome.cast.media.Media o wartości nienull

Multimedia należące do tej sesji przesyłania, w tym te wczytane przez innych nadawców.

przestrzenie nazw

tablica niepusto logiczna {name: string}

Lista przestrzeni nazw obsługiwanych przez aplikację odbiorcy.

odbiornik

nie null chrome.cast.Receiver

Odbiornik, który uruchamia aplikację.

senderApps

niepusta tablica chrome.cast.SenderApplication

Aplikacje nadawcy obsługiwane przez aplikację odbiorcy. Można go wykorzystać, aby zachęcić użytkownika do zainstalowania lub otwarcia aplikacji nadawcy.

sessionId

ciąg znaków

Jednoznacznie identyfikuje tę instancję aplikacji odbierającej.

status

nie null chrome.cast.SessionStatus

Stan tej sesji przesyłania do aplikacji odbierającej.

statusText

ciąg znaków z wartością null

Tekst opisujący aktualną zawartość zgłoszenia, na przykład „Mój pokaz ślubny”.

transportId

ciąg znaków

Identyfikator jednoznacznie opisujący tę sesję na potrzeby transportu. To jest wewnętrzny kanał komunikacji.

Metody

addMediaListener

addMediaListener(listener)

Dodaje odbiornik, który jest wywoływany, gdy inny nadawca utworzy sesję multimediów.

Parametr
detektor	function(non-null chrome.cast.media.Media) Detektor do dodania.

addMessageListener

addMessageListener(namespace, listener)

Dodaje odbiornik, który jest wywoływany po odebraniu wiadomości z aplikacji odbierającej. Detektor jest wywoływany z przestrzenią nazw jako pierwszym argumentem, a komunikat jako drugim argumentem.

Parametr
przestrzeń nazw	ciąg znaków Przestrzeń nazw nasłuchiwania, np. „urn:x-cast:com.example.namespace”.
detektor	funkcja(ciąg; ciąg) Detektor do dodania.

addUpdateListener

addUpdateListener(listener)

Dodaje odbiornik, który jest wywoływany po zmianie sesji. Zmiany tych właściwości aktywują odbiornik: statusText, przestrzenie nazw, stan i głośność odbiornika.

Detektory powinny sprawdzić właściwość status sesji, aby określić stan jej połączenia. Parametr logiczny isAlive został wycofany i zastąpiony właściwością status Sesja. Parametr isAlive jest nadal przekazywany na potrzeby zgodności wstecznej i ma wartość prawda, chyba że status = chrome.cast.SessionStatus.STOPPED.

Parametr
detektor	function(boolean) Detektor do dodania.

getDialAppInfo

getDialAppInfo(successCallback, errorCallback)

Pobiera informacje o aplikacji DIAL.

Parametr
successCallback	function(non-null chrome.cast.DialLaunchData)
errorCallback	function(non-null chrome.cast.Error)

wyruszyć

opuścić(sukcesy

Opuszcza (rozłącza) się z uruchomioną aplikacją odbierającą powiązaną z sesją.

Istniejące klienty w zakresie określonym przez zasadę AutoJoinPolicy tego klienta zostaną odłączone. Przyszli klienci nie dołączą automatycznie do opuszczonej sesji.

W przypadku wszystkich odłączonych klientów detektory aktualizacji sesji będą wywoływane przy użyciu polecenia isAlive = true. Detektory powinny sprawdzić właściwość status sesji, aby określić stan jej połączenia, ponieważ interfejs isAlive został wycofany. W tym przypadku jest to status = chrome.cast.SessionStatus.DISCONNECTED.

Parametr
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) Możliwe błędy to TIMEOUT, API_NOT_INITIALIZED, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

loadMedia

loadMedia(loadRequest, successCallback, errorCallback)

Wczytuje multimedia do działającej aplikacji odbiorcy.

Parametr
loadRequest	chrome.cast.media.LoadRequest Żądanie wczytania multimediów. Wartość nie może być wartością null.
successCallback	function(non-null chrome.cast.media.Media) Wywoływany z wczytanymi multimediami w przypadku powodzenia.
errorCallback	function(non-null chrome.cast.Error) Wywołano w przypadku błędu. Możliwe błędy: TIMEOUT, API_NOT_INITIALIZED, blogspot_PARAMETER, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

queueLoad

queueLoad(queueLoadRequest, successCallback, errorCallback)

Wczytuje i opcjonalnie rozpoczyna odtwarzanie nowej kolejki elementów multimedialnych do działającej aplikacji odbierającej.

Parametr
queueLoadRequest	chrome.cast.media.QueueLoadRequest Żądanie wczytania nowej kolejki elementów multimedialnych. Wartość nie może być wartością null.
successCallback	function(non-null chrome.cast.media.Media) Wywoływany z wczytanymi multimediami w przypadku powodzenia.
errorCallback	function(non-null chrome.cast.Error) Wywołano w przypadku błędu. Możliwe błędy: TIMEOUT, API_NOT_INITIALIZED, blogspot_PARAMETER, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

Wycofano

Użyj metody cast.framework.CastSession#loadMedia i podaj odpowiednie właściwości chrome.cast.media.LoadRequest#queueData.

removeMediaListener

removeMediaListener(listener)

Usuwa odbiornik, który został wcześniej dodany za pomocą parametru addMediaListener.

Parametr
detektor	function(non-null chrome.cast.media.Media) Detektor do usunięcia.

removeMessageListener

removeMessageListener(namespace, listener)

Usuwa dodany wcześniej detektor wiadomości.

Parametr
przestrzeń nazw	ciąg znaków Słuchana przestrzeń nazw, np. „urn:x-cast:com.example.przestrzeń_nazw”.
detektor	funkcja(ciąg; ciąg) Detektor do usunięcia.

removeUpdateListener

removeUpdateListener(listener)

Usuwa dodany wcześniej detektor na potrzeby tej sesji.

Parametr
detektor	function(boolean) Detektor do usunięcia.

sendMessage

sendMessage(namespace, message, successCallback, errorCallback)

Wysyła wiadomość do aplikacji odbierającej w danej przestrzeni nazw. Sukces od początku jest wywoływany po przesłaniu wiadomości do kanału komunikacji. Dotarcie do aplikacji odbierającej jest podejmowane z większych starań i nie jest gwarantowane.

Parametr
przestrzeń nazw	ciąg znaków Przestrzeń nazw, do której ma zostać wysłana wiadomość, np. „urn:x-cast:com.example.namespace”.
wiadomość	(non-null Object or string)
successCallback	function() Wywoływana po wysłaniu wiadomości.
errorCallback	function(non-null chrome.cast.Error) Wywołano w przypadku błędu. Możliwe błędy: TIMEOUT, API_NOT_INITIALIZED, blogspot_PARAMETER, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

setReceiverMuted

setReceiverMuted(muted, successCallback, errorCallback)

Ustawia głośność odbiornika.

Parametr
Wyciszono	boolean Nowy stan wyciszenia.
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) Możliwe błędy: TIMEOUT, API_NOT_INITIALIZED, blogspot_PARAMETER, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

setReceiverVolumeLevel

setReceiverVolumeLevel(newLevel, successCallback, errorCallback)

Ustawia głośność odbiornika.

Parametr
newLevel	Liczba Nowy poziom głośności od 0,0 do 1,0.
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) Możliwe błędy: TIMEOUT, API_NOT_INITIALIZED, blogspot_PARAMETER, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.

przesiadka

stop(successCallback, errorCallback)

Zatrzymuje uruchomioną aplikację odbierającą powiązaną z sesją.

Parametr
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) Możliwe błędy to TIMEOUT, API_NOT_INITIALIZED, CHANNEL_ERROR, SESSION_ERROR i EXTENSION_MISSING.