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 | |
GCKDevice * | device |
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… | |
GCKSessionTraits * | traits |
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… | |
GCKRemoteMediaClient * | remoteMediaClient |
Es el objeto GCKRemoteMediaClient que se puede usar para controlar la reproducción de contenido multimedia en esta sesión. Más… | |
GCKMediaMetadata * | mediaMetadata |
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
-
device The device. traits The session traits. sessionID The 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
-
volume The 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
-
muted The 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
-
stopCasting Whether 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
-
sessionID The 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
-
error The 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
-
reason The 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
-
error The 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
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The 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
-
statusText The new status.
Proporcionado por la categoría GCKSession(Protected).
Detalles de la propiedad
|
readnonatomicstrong |
Es el dispositivo con el que se asocia esta sesión.
|
readnonatomiccopy |
ID de la sesión actual, si hay alguno.
|
readnonatomicassign |
Es el estado de conexión de la sesión actual.
|
readnonatomicassign |
Es una marca que indica si la sesión está suspendida actualmente.
|
readnonatomiccopy |
Es el texto del estado actual del dispositivo.
|
readnonatomiccopy |
Son los rasgos de la sesión.
|
readnonatomicassign |
Es el volumen actual del dispositivo, en el rango [0.0, 1.0].
|
readnonatomicassign |
Es el estado de silencio del dispositivo actual.
|
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.
|
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.