Clase GCKSession

Referencia de la clase GCKSession

Descripción general

Es una clase base abstracta que representa una sesión con un dispositivo receptor.

Las subclases deben implementar los métodos start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) y resume (GCKSession(Protected)), y deben llamar a los métodos de notificación adecuados (por ejemplo, notifyDidStartWithSessionID: (GCKSession(Protected))) para indicar los cambios correspondientes en el estado de la sesión. Las subclases también pueden implementar setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) y remoteMediaClient si el dispositivo admite esas operaciones.

Se crea y controla una sesión con los métodos de sesión en GCKSessionManager, que usa el GCKDeviceProvider adecuado para crear la sesión y, luego, delega las solicitudes de sesión a ese objeto GCKSession.

Desde
3.0

Hereda de NSObject.

Lo hereda GCKCastSession.

Resumen de métodos de instancia

(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 indicado. Más…
 
(void) - resume
 Reanuda la sesión. Más…
 
(void) - notifyDidStartWithSessionID:
 Las subclases llaman a este método para notificar al framework que se inició la sesión. Más…
 
(void) - notifyDidFailToStartWithError:
 Las subclases llaman a este método para notificar al framework que no se pudo iniciar la sesión. Más…
 
(void) - notifyDidResume
 Las subclases llaman a este método para notificar al framework que se reanudó la sesión. Más…
 
(void) - notifyDidSuspendWithReason:
 Las subclases llaman a este método para notificar al framework que se suspendió la sesión. Más…
 
(void) - notifyDidEndWithError:
 Las subclases llaman a este método para notificar al framework que finalizó la sesión. Más…
 
(void) - notifyDidReceiveDeviceVolume:muted:
 Las subclases llaman a este método para notificar al framework que se recibió del dispositivo el volumen actualizado y el estado de silencio. Más…
 
(void) - notifyDidReceiveDeviceStatus:
 Las subclases llaman a este método para notificar al framework que se recibió el estado actualizado del dispositivo. Más…
 

Resumen de la propiedad

GCKDevicedevice
 Es el dispositivo con el que se asocia esta sesión. Más…
 
NSString * sessionID
 ID de la sesión actual, si hay alguno. Más…
 
GCKConnectionState connectionState
 Es el estado de conexión de la sesión actual. Más…
 
BOOL suspended
 Es 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
 Son los rasgos de la sesión. Más…
 
float currentDeviceVolume
 Es el volumen actual del dispositivo, en el rango [0.0, 1.0]. Más…
 
BOOL currentDeviceMuted
 Es el estado de silencio del dispositivo actual. 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
 Son los metadatos multimedia actuales, si los hay. Más…
 

Detalle del método

- (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 operación nula que hace que la solicitud falle con un error GCKErrorCodeUnsupportedFeature.

Parameters
volumeThe new volume.
Muestra
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
Desde
3.4; en versiones anteriores del framework, este método devolvía 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 operación nula que hace que la solicitud falle con un error GCKErrorCodeUnsupportedFeature.

Parameters
mutedThe new mute state.
Muestra
Un objeto GCKRequest para hacer un seguimiento de la solicitud.
Desde
3.4; en versiones anteriores del framework, este método devolvía void.
- (void) start

Inicia la sesión.

Esta es una operación asíncrona. Las subclases deben anular este método.

Proporcionado por la categoría GCKSession(Protected).

- (void) endAndStopCasting: (BOOL)  stopCasting

Finaliza la sesión.

Esta es una operación asíncrona. Las subclases deben anular este método.

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 indicado.

Esta es una operación asíncrona. Las subclases deben anular este método.

Proporcionado por la categoría GCKSession(Protected).

- (void) resume

Reanuda la sesión.

Esta es una operación asíncrona. Las subclases deben anular este método.

Proporcionado por la categoría GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

Las subclases llaman a este método 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 llaman a este método 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 llaman a este método para notificar al framework que se reanudó la sesión.

Proporcionado por la categoría GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

Las subclases llaman a este método 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 llaman a este método 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 llaman a este método para notificar al framework que se recibió del dispositivo el volumen actualizado y el estado de silencio.

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 llaman a este método 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

- (GCKDevice*) device
readnonatomicstrong

Es el dispositivo con el que se asocia esta sesión.

- (NSString*) sessionID
readnonatomiccopy

ID de la sesión actual, si hay alguno.

- (GCKConnectionState) connectionState
readnonatomicassign

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

- (BOOL) suspended
readnonatomicassign

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

- (NSString*) deviceStatusText
readnonatomiccopy

Es el texto del estado actual del dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopy

Son los rasgos de la sesión.

- (float) currentDeviceVolume
readnonatomicassign

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

- (BOOL) currentDeviceMuted
readnonatomicassign

Es el estado de silencio del dispositivo actual.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstrong

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 admite la API de GCKRemoteMediaClient. Las subclases que proporcionan una interfaz GCKRemoteMediaClient deben anular el método getter.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstrong

Son los metadatos multimedia actuales, si los hay.

Será nil si la sesión no admite el espacio de nombres de medios o si no se cargó ningún contenido multimedia en el receptor.