Clase GCKGameManagerChannel

Referencia de la clase GCKGameManagerChannel

Descripción general

Subclase de GCKCastChannel para operaciones de control de juegos.

Consulta GCKGameManagerChannelDelegate para ver el protocolo de delegado.

Deprecated:
La API de Game Manager ya no es compatible y se quitará en una versión futura.

Hereda GCKCastChannel.

Resumen de métodos de instancia

(instancetype) - initWithSessionID:
 Es el inicializador designado. Más…
 
(instancetype) - init
 El inicializador predeterminado no está disponible. Más…
 
(NSInteger) - sendPlayerAvailableRequest:
 Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateAvailable. Más…
 
(NSInteger) - sendPlayerAvailableRequest:playerID:
 Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateAvailable. Más…
 
(NSInteger) - sendPlayerReadyRequest:
 Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateReady. Más…
 
(NSInteger) - sendPlayerReadyRequest:playerID:
 Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateReady. Más…
 
(NSInteger) - sendPlayerPlayingRequest:
 Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStatePlaying. Más…
 
(NSInteger) - sendPlayerPlayingRequest:playerID:
 Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStatePlaying. Más…
 
(NSInteger) - sendPlayerIdleRequest:
 Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateIdle. Más…
 
(NSInteger) - sendPlayerIdleRequest:playerID:
 Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateIdle. Más…
 
(NSInteger) - sendPlayerQuitRequest:
 Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateQuit. Más…
 
(NSInteger) - sendPlayerQuitRequest:playerID:
 Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateQuit. Más…
 
(NSInteger) - sendGameRequest:
 Envía un mensaje específico del juego al receptor. Más…
 
(NSInteger) - sendGameRequest:playerID:
 Envía un mensaje específico del juego al receptor. Más…
 
(void) - sendGameMessage:
 Envía un mensaje específico del juego al receptor. Más…
 
(void) - sendGameMessage:playerID:
 Envía un mensaje específico del juego al receptor. Más…
 
(instancetype) - initWithNamespace:
 Es el inicializador designado. Más…
 
(void) - didReceiveTextMessage:
 Se llama cuando se recibe un mensaje de texto en este canal. Más…
 
(BOOL) - sendTextMessage:
 Envía un mensaje de texto en este canal. Más…
 
(BOOL) - sendTextMessage:error:
 Envía un mensaje de texto en este canal. Más…
 
(NSInteger) - generateRequestID
 Genera un ID de solicitud para un mensaje nuevo. Más…
 
(NSNumber *__nullable) - generateRequestNumber
 Es un método de conveniencia que encapsula el resultado de generateRequestID en un NSNumber. Más…
 
(void) - didConnect
 Se llama a este método cuando se conecta este canal, lo que indica que ahora se pueden intercambiar mensajes con el dispositivo Cast a través de este canal. Más…
 
(void) - didDisconnect
 Se llama cuando se desconecta este canal, lo que indica que ya no se pueden intercambiar mensajes con el dispositivo Cast a través de este canal. Más…
 

Resumen de la propiedad

id< GCKGameManagerChannelDelegatedelegate
 Es el delegado para recibir notificaciones de GCKGameManagerChannel. Más…
 
GCKGameManagerStatecurrentState
 Es el estado actual del administrador del juego. Más…
 
NSString * lastUsedPlayerID
 Es el ID del último jugador controlable que se usó en esta sesión. Más…
 
BOOL isInitialConnectionEstablished
 Indica si este canal está conectado con el Administrador de juegos del receptor y si estamos listos para interactuar con él. Más…
 
NSString * protocolNamespace
 Es el espacio de nombres del canal. Más…
 
BOOL isConnected
 Es una marca que indica si este canal está conectado actualmente. Más…
 
GCKDeviceManagerdeviceManager
 Es el administrador de dispositivos con el que se registró este canal, si corresponde. Más…
 

Detalle del método

- (instancetype) initWithSessionID: (NSString *)  castSessionID

Es el inicializador designado.

Se conecta automáticamente al Administrador de juegos del receptor.

Parameters
castSessionIDThe Session ID corresponding to the currently connected Game Manager.
- (instancetype) init

El inicializador predeterminado no está disponible.

Implementa GCKCastChannel.

- (NSInteger) sendPlayerAvailableRequest: (id __nullable)  extraData

Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateAvailable.

Si no es una transición válida para ese jugador, se activará un error en GCKGameManagerChannelDelegate. Si no hay un reproductor usado por última vez, se registrará un reproductor nuevo y su ID se establecerá como el ID del reproductor usado por última vez cuando el receptor responda a esta solicitud. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Consulta también
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerAvailableRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateAvailable.

Si no es una transición válida para ese jugador, se activará un error en GCKGameManagerChannelDelegate. Si el ID del jugador es nil, se registrará un jugador nuevo y su ID se establecerá como el último ID de jugador usado cuando el receptor responda a esta solicitud. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player whose state is to be changed.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerReadyRequest: (id __nullable)  extraData

Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateReady.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Consulta también
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerReadyRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateReady.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerPlayingRequest: (id __nullable)  extraData

Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStatePlaying.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Consulta también
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerPlayingRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStatePlaying.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerIdleRequest: (id __nullable)  extraData

Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateIdle.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado de gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback del delegado GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: si el objeto GCKGameManagerChannel aún no está conectado al administrador de juegos del receptor.

Consulta también
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerIdleRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateIdle.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerQuitRequest: (id __nullable)  extraData

Envía una solicitud al receptor para que ponga el reproductor que se usó por última vez en este emisor en el estado GCKPlayerStateQuit.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Consulta también
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendPlayerQuitRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía una solicitud al receptor para que coloque el reproductor en el estado GCKPlayerStateQuit.

Si no se trata de una transición válida para ese jugador o si no hay un ID de jugador usado por última vez, se activará un error en GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el objeto GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendGameRequest: (id __nullable)  extraData

Envía un mensaje específico del juego al receptor.

El contenido del mensaje depende completamente de la aplicación. El mensaje se originará desde lastUsedPlayerID. El receptor enviará una respuesta a este remitente a través de GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada del delegado de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al GameManager del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (NSInteger) sendGameRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía un mensaje específico del juego al receptor.

El contenido del mensaje depende completamente de la aplicación. El mensaje se originará desde playerID. Si playerID es nil, se usará lastUsedPlayerID. El receptor enviará una respuesta a este remitente a través de GCKGameManagerChannelDelegate. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe id of the controllable player sending this message.
Muestra
El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.
- (void) sendGameMessage: (id __nullable)  extraData

Envía un mensaje específico del juego al receptor.

El contenido del mensaje depende completamente de la aplicación. El mensaje se originará desde lastUsedPlayerID. Este es un método de "disparar y olvidar" en el que no hay garantía de que se haya enviado el mensaje y el receptor no enviará una respuesta a este remitente. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
- (void) sendGameMessage: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Envía un mensaje específico del juego al receptor.

El contenido de los mensajes depende completamente de la aplicación. El mensaje se originará desde el ID del jugador local especificado. Este es un método de "disparar y olvidar" en el que no se garantiza que se envíe el mensaje y el receptor no enviará una respuesta a este remitente. Solo se debe llamar a este método después de que se haya enviado un mensaje a la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje al callback de delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el GCKGameManagerChannel aún no está conectado al Administrador de juegos del receptor.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe ID of the controllable player sending this message.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

Es el inicializador designado.

Crea un nuevo GCKCastChannel con el espacio de nombres determinado.

Parameters
protocolNamespaceThe namespace.

Se implementó en GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *)  message

Se llama cuando se recibe un mensaje de texto en este canal.

La implementación predeterminada no es operativa.

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

Envía un mensaje de texto en este canal.

Parameters
messageThe message.
Muestra
YES si se realizó correctamente o NO si no se pudo enviar el mensaje (porque el canal no está conectado o porque el búfer de envío está demasiado lleno en este momento).
Deprecated:
Usa sendTextMessage:error:, que proporciona información detallada sobre el error.
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

Envía un mensaje de texto en este canal.

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
Muestra
YES si se envió correctamente o NO si no se pudo enviar el mensaje.
- (NSInteger) generateRequestID

Genera un ID de solicitud para un mensaje nuevo.

Muestra
Es el ID generado o kGCKInvalidRequestID si el canal no está conectado en este momento.
- (NSNumber * __nullable) generateRequestNumber

Es un método de conveniencia que encapsula el resultado de generateRequestID en un NSNumber.

Muestra
Es el ID generado o nil si el canal no está conectado en este momento.
- (void) didConnect

Se llama a este método cuando se conecta este canal, lo que indica que ahora se pueden intercambiar mensajes con el dispositivo Cast a través de este canal.

La implementación predeterminada no es operativa.

- (void) didDisconnect

Se llama cuando se desconecta este canal, lo que indica que ya no se pueden intercambiar mensajes con el dispositivo Cast a través de este canal.

La implementación predeterminada no es operativa.

Detalles de la propiedad

- (id<GCKGameManagerChannelDelegate>) delegate
readwritenonatomicweak

Es el delegado para recibir notificaciones de GCKGameManagerChannel.

- (GCKGameManagerState*) currentState
readnonatomicstrong

Es el estado actual del administrador del juego.

- (NSString*) lastUsedPlayerID
readnonatomiccopy

Es el ID del último jugador controlable que se usó en esta sesión.

Puede ser nil si no hay un reproductor controlable configurado con el receptor.

Consulta también
- sendPlayerAvailableRequest:
- (BOOL) isInitialConnectionEstablished
readnonatomicassign

Indica si este canal está conectado con el Administrador de juegos del receptor y si estamos listos para interactuar con él.

Este método devolverá NO desde el momento de la creación de este canal.

Muestra
YES si este canal está conectado al Administrador de juegos del receptor y está listo para interactuar con él; NO en caso contrario.
- (NSString*) protocolNamespace
readnonatomiccopyinherited

Es el espacio de nombres del canal.

- (BOOL) isConnected
readnonatomicassigninherited

Es una marca que indica si este canal está conectado actualmente.

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

Es el administrador de dispositivos con el que se registró este canal, si corresponde.

Deprecated:
Si este canal no se registró con la clase GCKDeviceManager obsoleta, será nil.