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.