Clase GCKCastSession

Referencia de la clase GCKCastSession

Descripción general

Es una clase que administra una sesión de transmisión con un dispositivo receptor.

GCKSessionManager crea y administra automáticamente las sesiones. La aplicación no debe llamar directamente a los métodos del ciclo de vida de la sesión, como start (GCKSession(Protected)) o endAndStopCasting: (GCKSession(Protected)).

Desde
3.0

Hereda GCKSession.

Resumen del método de instancia

(instancetype) - initWithDevice:sessionID:castOptions:
 Inicializador designado Más...
 
(BOOL) - addChannel:
 Registra un canal con la sesión. Más...
 
(BOOL) - removeChannel:
 Quita de la sesión un canal que se haya registrado anteriormente. Más...
 
(void) - addDeviceStatusListener:
 Agrega un GCKCastDeviceStatusListener a la lista de objetos de escucha de este objeto. Más...
 
(void) - removeDeviceStatusListener:
 Quita un GCKCastDeviceStatusListener de la lista de objetos de escucha de este objeto. Más...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 Establece el volumen de un dispositivo individual en un grupo multizona. Más...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 Establece el estado silenciado del dispositivo individual en un grupo multizona. Más...
 
(GCKRequest *) - requestMultizoneStatus
 Solicita el estado multizona de un grupo multizona. Más...
 
(instancetype) - initWithDevice:traits:sessionID:
 Inicializa un nuevo objeto de sesión para el dispositivo determinado. Más...
 
(GCKRequest *) - setDeviceVolume:
 Establece el volumen del dispositivo. Más...
 
(GCKRequest *) - setDeviceMuted:
 Establece el estado de silencio del dispositivo. Más...
 
(void) - start
 Inicia la sesión. Más...
 
(void) - endAndStopCasting:
 Finaliza la sesión. Más...
 
(void) - suspendWithReason:
 Suspende la sesión por el motivo especificado. Más...
 
(void) - resume
 Reanuda la sesión. Más...
 
(void) - notifyDidStartWithSessionID:
 Las subclases los llaman para notificar al framework que se inició la sesión. Más...
 
(void) - notifyDidFailToStartWithError:
 Las subclases los llaman para notificar al framework que no se pudo iniciar la sesión. Más...
 
(void) - notifyDidResume
 Las subclases los llaman para notificar al framework que se reanudó la sesión. Más...
 
(void) - notifyDidSuspendWithReason:
 Las subclases los llaman para notificar al framework que se suspendió la sesión. Más...
 
(void) - notifyDidEndWithError:
 Las subclases los llaman para notificar al framework que finalizó la sesión. Más...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 Las subclases los llaman para notificar al framework que se recibió el volumen actualizado y el estado de silencio del dispositivo. Más...
 
(void) - notifyDidReceiveDeviceStatus:
 Las subclases los llaman para notificar al framework que se recibió el estado actualizado del dispositivo. Más...
 

Resumen de la propiedad

GCKActiveInputStatus activeInputStatus
 El estado actual de la "entrada activa" del dispositivo Más...
 
GCKStandbyStatus standbyStatus
 El estado actual "en espera" del dispositivo Más...
 
GCKApplicationMetadataapplicationMetadata
 Los metadatos para la aplicación receptora que se está ejecutando actualmente en el dispositivo receptor, si corresponde; de lo contrario, es nil. Más...
 
GCKDevicedevice
 El dispositivo con el que está asociada esta sesión. Más...
 
NSString * sessionID
 El ID de sesión actual, si corresponde. Más...
 
GCKConnectionState connectionState
 El estado de conexión de la sesión actual. Más...
 
BOOL suspended
 Una marca que indica si la sesión está suspendida actualmente. Más...
 
NSString * deviceStatusText
 Es el texto del estado actual del dispositivo. Más...
 
GCKSessionTraitstraits
 Las características de la sesión Más...
 
float currentDeviceVolume
 El volumen actual del dispositivo, en el rango [0.0, 1.0]. Más...
 
BOOL currentDeviceMuted
 Es el estado actual de silencio del dispositivo. Más...
 
GCKRemoteMediaClientremoteMediaClient
 Es el objeto GCKRemoteMediaClient que se puede usar para controlar la reproducción de contenido multimedia en esta sesión. Más...
 
GCKMediaMetadatamediaMetadata
 Los metadatos del contenido multimedia actuales, si corresponde Más...
 

Detalle del método

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID
castOptions: (GCKCastOptions *)  castOptions 

Inicializador designado

Crea una nueva sesión de transmisión con las opciones de transmisión determinadas.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
castOptionsThe Cast options.
- (BOOL) addChannel: (GCKCastChannel *)  channel

Registra un canal con la sesión.

Si la sesión está conectada y la aplicación receptora admite el espacio de nombres del canal, el canal se conectará automáticamente. Si la sesión no está conectada, el canal permanecerá en estado desconectado hasta que se inicie la sesión.

Parameters
channelThe channel to register.
Devuelve
YES si el canal se registró correctamente, de lo contrario, NO.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Quita de la sesión un canal que se haya registrado anteriormente.

Parameters
channelThe channel to unregister.
Devuelve
YES si se anuló el registro del canal correctamente, de lo contrario, NO.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Agrega un GCKCastDeviceStatusListener a la lista de objetos de escucha de este objeto.

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Quita un GCKCastDeviceStatusListener de la lista de objetos de escucha de este objeto.

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Establece el volumen de un dispositivo individual en un grupo multizona.

Esta es una operación asíncrona.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
Devuelve
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Establece el estado silenciado del dispositivo individual en un grupo multizona.

Esta es una operación asíncrona.

Parameters
mutedThe new muted state.
deviceThe multizone device.
Devuelve
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
- (GCKRequest *) requestMultizoneStatus

Solicita el estado multizona de un grupo multizona.

Esta es una operación asíncrona. Cuando se reciba el estado de varias zonas, se enviará un mensaje al método delegado castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p).

Devuelve
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  sessionID 

Inicializa un nuevo objeto de sesión para el dispositivo determinado.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
- (GCKRequest *) setDeviceVolume: (float)  volume

Establece el volumen del dispositivo.

Esta es una operación asíncrona. La implementación predeterminada es una no-op que falla en la solicitud con un error GCKErrorCodeUnsupportedFeature.

Parameters
volumeThe new volume.
Devuelve
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
Desde
3.4. En versiones anteriores del framework, este método mostraba void.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

Establece el estado de silencio del dispositivo.

Esta es una operación asíncrona. La implementación predeterminada es una no-op que falla en la solicitud con un error GCKErrorCodeUnsupportedFeature.

Parameters
mutedThe new mute state.
Devuelve
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
Desde
3.4. En versiones anteriores del framework, este método mostraba void.
- (void) start

Inicia la sesión.

Esta es una operación asíncrona. Debe ser anulada por subclases.

Proporcionado por la categoría GCKSession(Protected)

- (void) endAndStopCasting: (BOOL)  stopCasting

Finaliza la sesión.

Esta es una operación asíncrona. Debe ser anulada por subclases.

Parameters
stopCastingWhether to stop casting content to the receiver.

Proporcionado por la categoría GCKSession(Protected)

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

Suspende la sesión por el motivo especificado.

Esta es una operación asíncrona. Debe ser anulada por subclases.

Proporcionado por la categoría GCKSession(Protected)

- (void) resume

Reanuda la sesión.

Esta es una operación asíncrona. Debe ser anulada por subclases.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

Las subclases los llaman para notificar al framework que se inició la sesión.

Parameters
sessionIDThe session's unique ID.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidFailToStartWithError: (NSError *)  error

Las subclases los llaman para notificar al framework que no se pudo iniciar la sesión.

Parameters
errorThe error that occurred.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidResume

Las subclases los llaman para notificar al framework que se reanudó la sesión.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

Las subclases los llaman para notificar al framework que se suspendió la sesión.

Parameters
reasonThe reason for the suspension.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidEndWithError: (NSError *__nullable)  error

Las subclases los llaman para notificar al framework que finalizó la sesión.

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidReceiveDeviceVolume: (float)  volume
muted: (BOOL)  muted 

Las subclases los llaman para notificar al framework que se recibió el volumen actualizado y el estado de silencio del dispositivo.

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

Proporcionado por la categoría GCKSession(Protected)

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable)  statusText

Las subclases los llaman para notificar al framework que se recibió el estado actualizado del dispositivo.

Parameters
statusTextThe new status.

Proporcionado por la categoría GCKSession(Protected)

Detalles de la propiedad

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

El estado actual de la "entrada activa" del dispositivo

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

El estado actual "en espera" del dispositivo

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

Los metadatos para la aplicación receptora que se está ejecutando actualmente en el dispositivo receptor, si corresponde; de lo contrario, es nil.

- (GCKDevice*) device
readnonatomicstronginherited

El dispositivo con el que está asociada esta sesión.

- (NSString*) sessionID
readnonatomiccopyinherited

El ID de sesión actual, si corresponde.

- (GCKConnectionState) connectionState
readnonatomicassigninherited

El estado de conexión de la sesión actual.

- (BOOL) suspended
readnonatomicassigninherited

Una marca que indica si la sesión está suspendida actualmente.

- (NSString*) deviceStatusText
readnonatomiccopyinherited

Es el texto del estado actual del dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

Las características de la sesión

- (float) currentDeviceVolume
readnonatomicassigninherited

El volumen actual del dispositivo, en el rango [0.0, 1.0].

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

Es el estado actual de silencio del dispositivo.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

Es el objeto GCKRemoteMediaClient que se puede usar para controlar la reproducción de contenido multimedia en esta sesión.

Es nil antes de que comience la sesión o si la sesión no es compatible con la API de GCKRemoteMediaClient. Las subclases que proporcionan una interfaz GCKRemoteMediaClient deben anular el método get.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstronginherited

Los metadatos del contenido multimedia actuales, si corresponde

Será nil si la sesión no admite el espacio de nombres multimedia o si no hay contenido multimedia cargado en la app receptora.