Clase: Sesión

chrome.cast.Sesión

class static

Describe el estado de una aplicación de transmisión en ejecución. Normalmente, el cliente no debe crear estos objetos.

Constructor

Sesión

nueva Session(sessionId, appId, displayName, appImages, receptor)

Parámetro
sessionId	string El identificador de la sesión.
appId	string El identificador de la aplicación receptora.
displayName	string El nombre visible de la aplicación.
imágenesdeaplicación	Arreglo de chrome.cast.Image no nulo Imágenes asociadas con la app. El valor no debe ser nulo.
receptor	chrome.cast.Receiver El receptor que ejecuta la app. El valor no debe ser nulo.

Propiedades

appId

string

El identificador de la aplicación de Cast. No se pueden mostrar.

imágenesdeaplicación

Arreglo no nulo de chrome.cast.Image no nulo

Arreglo de imágenes disponibles que describen la aplicación.

displayName

string

El nombre legible de la aplicación de Cast, por ejemplo, "YouTube".

sociales

Arreglo no nulo de chrome.cast.media.Media no nulo

El contenido multimedia que pertenece a esta sesión de transmisión, incluidos los que cargan otros remitentes.

namespaces

arreglo no nulo de {name: string}

Una lista de los espacios de nombres que admite la aplicación receptora.

receptor

no nulo chrome.cast.Receiver

El receptor que ejecuta la aplicación.

apps emisoras

Matriz no nula de chrome.cast.SenderApplication no nula

Las aplicaciones emisoras compatibles con la aplicación receptora. Esto se puede usar para solicitarle al usuario que instale o visite la aplicación emisora.

sessionId

string

Identifica de forma única esta instancia de la aplicación receptora.

estado

no nulo chrome.cast.SessionStatus

Estado de esta sesión de transmisión a la aplicación receptora.

TextoDeEstado

string anulable

Texto descriptivo para el contenido actual de la aplicación, por ejemplo, "Mi presentación de diapositivas de bodas"

ID de transporte

string

Identificador que describe esta sesión de forma exclusiva para fines de transporte. Esto es parte interna del canal de comunicación.

Métodos

addMediaListener.

addMediaListener(oyente)

Agrega un objeto de escucha que se invoca cuando otro remitente crea una sesión multimedia.

Parámetro
objeto de escucha	function(no nulo chrome.cast.media.Media) Objeto de escucha que se agregará.

addMessageListener.

addMessageListener(espacio de nombres, objeto de escucha)

Agrega un objeto de escucha que se invoca cuando se recibe un mensaje de la aplicación receptora. El objeto de escucha se invoca con el espacio de nombres como el primer argumento y el mensaje como el segundo argumento.

Parámetro
espacio de nombres	string El espacio de nombres para escuchar, p.ej., "urn:x-cast:com.example.namespace".
objeto de escucha	función(string, string) Objeto de escucha que se agregará.

addUpdateListener.

addUpdateListener(oyente)

Agrega un objeto de escucha que se invoca cuando cambia la sesión. Los cambios en las siguientes propiedades activarán el objeto de escucha: statusText, espacios de nombres, estado y el volumen del receptor.

Los objetos de escucha deben verificar la propiedad status de la sesión para determinar su estado de conexión. El parámetro booleano isAlive dejó de estar disponible y se lo reemplazó por la propiedad de sesión status. El parámetro isAlive aún se pasa para brindar retrocompatibilidad, y es verdadero, a menos que status = chrome.cast.SessionStatus.STOPPED.

Parámetro
objeto de escucha	función(booleano) Objeto de escucha que se agregará.

getDialAppInfo

getDialAppInfo(successCallback, errorCallback)

Obtiene la información de la app de MARCAR.

Parámetro
devolución de llamada exitosa	function(no nulo chrome.cast.DialLaunchData)
error_callback	function(no nulo chrome.cast.Error)

sales

salir(successCallback, errorCallback)

Sale (se desconecta) de la aplicación receptora en ejecución asociada con la sesión.

Se desconectarán los clientes existentes dentro del alcance definido por la política AutoJoin de este cliente. Los clientes futuros no se unirán de forma automática a la sesión que quedó.

Todos los clientes desconectados tendrán sus objetos de escucha de actualización de sesión llamados con isAlive = true. Los objetos de escucha deben verificar la propiedad status de la sesión para determinar su estado de conexión, ya que isAlive dejó de estar disponible. En este caso, es status = chrome.cast.SessionStatus.DISCONNECTED.

Parámetro
devolución de llamada exitosa	función()
error_callback	function(no nulo chrome.cast.Error) Los posibles errores son TIMEOUT, API_NOT_INITIALIZED, CHANNEL_ERROR, SESSION_ERROR y EXTENSION_MISSING.

loadMedia

loadMedia(loadRequest, successCallback, errorCallback)

Carga medios en una aplicación receptora en ejecución.

Parámetro
loadRequest	chrome.cast.media.LoadRequest Solicitud para cargar medios. El valor no debe ser nulo.
devolución de llamada exitosa	function(no nulo chrome.cast.media.Media) Se invoca con el contenido multimedia cargado una vez finalizado el proceso.
error_callback	function(no nulo chrome.cast.Error) Se invoca en caso de error. Los errores posibles son TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, y EXTENSION_MISSING.

coladecarga

queueLoad(queueLoadRequest, SuccessCallback, errorCallback).

Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia en una aplicación receptora en ejecución.

Parámetro
queueLoadRequest	chrome.cast.media.QueueLoadRequest. Solicita cargar una cola nueva de elementos multimedia. El valor no debe ser nulo.
devolución de llamada exitosa	function(no nulo chrome.cast.media.Media) Se invoca con el contenido multimedia cargado una vez finalizado el proceso.
error_callback	function(no nulo chrome.cast.Error) Se invoca en caso de error. Los errores posibles son TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, y EXTENSION_MISSING.

Funciones obsoletas

Usa cast.framework.CastSession#loadMedia y proporciona los recursos chrome.cast.media.LoadRequest#queueData relevantes.

removeMediaListener

removeMediaListener(listener)

Quita un objeto de escucha que se agregó anteriormente con addMediaListener.

Parámetro
objeto de escucha	function(no nulo chrome.cast.media.Media) Objeto de escucha que se quitará.

removeMessageListener

removeMessageListener(espacio de nombres, objeto de escucha)

Quita un objeto de escucha agregado anteriormente para los mensajes.

Parámetro
espacio de nombres	string El espacio de nombres que se escucha, p.ej., “urn:x-cast:com.example.namespace”.
objeto de escucha	función(string, string) Objeto de escucha que se quitará.

removeUpdateListener

removeUpdateListener(listener)

Quita un objeto de escucha agregado anteriormente para esta sesión.

Parámetro
objeto de escucha	función(booleano) Objeto de escucha que se quitará.

sendMessage

sendMessage(espacio de nombres, mensaje, callbackCallback, errorCallback)

Envía un mensaje a la aplicación receptora en el espacio de nombres dado. Se invoca correctamente cuando se haya enviado el mensaje al canal de mensajería. La entrega a la aplicación receptora representa el mejor esfuerzo y no está garantizada.

Parámetro
espacio de nombres	string El espacio de nombres para enviar el mensaje, p.ej., “urn:x-cast:com.example.namespace”.
mensaje	(Objeto o string no nulo)
devolución de llamada exitosa	función() Se invoca cuando se envía el mensaje.
error_callback	function(no nulo chrome.cast.Error) Se invoca en caso de error. Los errores posibles son TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, y EXTENSION_MISSING.

setReceiverMuted

setReceiverMuted(silenciado, SuccessCallback, errorCallback)

Establece el volumen del receptor.

Parámetro
silenciado	boolean El nuevo estado silenciado.
devolución de llamada exitosa	función()
error_callback	function(no nulo chrome.cast.Error) Los posibles errores son TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR y EXTENSION_MISSING.

setReceiverVolumeLevel

setReceiverVolumeLevel(newLevel, SuccessCallback, errorCallback)

Establece el volumen del receptor.

Parámetro
nuevoNivel	número El nuevo nivel de volumen entre 0.0 y 1.0.
devolución de llamada exitosa	función()
error_callback	function(no nulo chrome.cast.Error) Los posibles errores son TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR y EXTENSION_MISSING.

stop

stop(correctCallback, errorCallback)

Detiene la aplicación receptora en ejecución asociada con la sesión.

Parámetro
devolución de llamada exitosa	función()
error_callback	function(no nulo chrome.cast.Error) Los posibles errores son TIMEOUT, API_NOT_INITIALIZED, CHANNEL_ERROR, SESSION_ERROR y EXTENSION_MISSING.