Clase GCKSessionManager

Referencia de la clase GCKSessionManager

Descripción general

Una clase que administra sesiones.

El método startSessionWithDevice: (GCKSessionManager) se usa para crear una sesión nueva con una GCKDevice determinada. El administrador de sesiones usa el GCKDeviceProvider para ese tipo de dispositivo a fin de construir un nuevo objeto GCKSession, al que luego delega todas las solicitudes de sesión.

GCKSessionManager controla la reanudación automática de sesiones suspendidas (es decir, reanudar sesiones que finalizaron cuando la aplicación pasó a segundo plano o en caso de que la aplicación fallara o el usuario la forzara). Cuando se reanude o reinicie la aplicación, el administrador de sesión esperará un momento a que el proveedor del dispositivo de la sesión suspendida vuelva a descubrir el dispositivo. En ese caso, intentará volver a conectarse a ese dispositivo y restablecer la sesión automáticamente.

Si la aplicación creó un GCKUICastButton sin proporcionar un objetivo ni un selector, cuando un usuario presione el botón se mostrará el diálogo de transmisión predeterminado, y las sesiones se iniciarán y detendrán automáticamente en función de la selección del usuario o la desconexión de un dispositivo. Sin embargo, si la aplicación proporciona su propia IU de diálogo de selección/control de dispositivos, debe usar GCKSessionManager de forma directa para crear y controlar sesiones.

Si la aplicación usa GCKSessionManager para controlar las sesiones, puede adjuntar un GCKSessionManagerListener a fin de recibir notificaciones sobre los eventos de la sesión. También puede usar KVO para supervisar la propiedad connectionState a fin de hacer un seguimiento del estado actual del ciclo de vida de la sesión.

Since
3.0

Hereda NSObject.

Resumen del método de instancia

(instancetype) - init
 El inicializador predeterminado no está disponible. Más...
 
(BOOL) - startSessionWithDevice:
 Inicia una nueva sesión con el dispositivo especificado. Más...
 
(BOOL) - suspendSessionWithReason:
 Suspende la sesión actual. Más...
 
(BOOL) - endSession
 Finaliza la sesión actual. Más...
 
(BOOL) - endSessionAndStopCasting:
 Finaliza la sesión actual y, opcionalmente, detiene la transmisión. Más...
 
(BOOL) - hasConnectedSession
 Comprueba si una sesión está actualmente administrada por este administrador de sesiones y si está conectada actualmente. Más...
 
(BOOL) - hasConnectedCastSession
 Comprueba si una sesión de Cast está administrada por este administrador de sesiones y si está conectada actualmente. Más...
 
(void) - addListener:
 Agrega un objeto de escucha para recibir notificaciones. Más...
 
(void) - removeListener:
 Quita un objeto de escucha que se agregó anteriormente con addListener:. Más...
 

Resumen de la propiedad

GCKSessioncurrentSession
 La sesión actual, si la hubiera. Más...
 
GCKCastSessioncurrentCastSession
 La sesión de transmisión actual, si existe. Más...
 
GCKConnectionState connectionState
 Es el estado actual de la conexión de la sesión. Más...
 

Detalle del método

- (instancetype) init

El inicializador predeterminado no está disponible.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

Inicia una nueva sesión con el dispositivo especificado.

Esta es una operación asíncrona.

Parameters
deviceThe device to use for this session.
Resultado que se muestra
YES si la operación se inició correctamente, NO si hay una sesión establecida actualmente o si no se pudo iniciar.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

Suspende la sesión actual.

Esta es una operación asíncrona.

Parameters
reasonThe reason for the suspension.
Resultado que se muestra
YES si la operación se inició correctamente, NO si no hay una sesión establecida actualmente o si no se pudo iniciar.
- (BOOL) endSession

Finaliza la sesión actual.

Esta es una operación asíncrona.

Resultado que se muestra
YES si la operación se inició correctamente, NO si no hay una sesión establecida actualmente o si no se pudo iniciar.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Finaliza la sesión actual y, opcionalmente, detiene la transmisión.

Esta es una operación asíncrona.

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
Resultado que se muestra
YES si la operación se inició correctamente, NO si no hay una sesión establecida actualmente o si no se pudo iniciar.
- (BOOL) hasConnectedSession

Comprueba si una sesión está actualmente administrada por este administrador de sesiones y si está conectada actualmente.

Este será YES si el estado de la sesión es GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

Comprueba si una sesión de Cast está administrada por este administrador de sesiones y si está conectada actualmente.

Este será YES si el estado de la sesión es GCKConnectionStateConnected y la sesión es de Cast.

- (void) addListener: (id< GCKSessionManagerListener >)  listener

Agrega un objeto de escucha para recibir notificaciones.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

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

Parameters
listenerThe listener to remove.

Detalles de la propiedad

- (GCKSession*) currentSession
readnonatomicstrong

La sesión actual, si la hubiera.

- (GCKCastSession*) currentCastSession
readnonatomicstrong

La sesión de transmisión actual, si existe.

- (GCKConnectionState) connectionState
readnonatomicassign

Es el estado actual de la conexión de la sesión.