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< GCKGameManagerChannelDelegate > | delegate |
Es el delegado para recibir notificaciones de GCKGameManagerChannel. Más… | |
GCKGameManagerState * | currentState |
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… | |
GCKDeviceManager * | deviceManager |
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
-
castSessionID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
extraData Custom 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
-
extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.playerID The 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
-
protocolNamespace The 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
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Envía un mensaje de texto en este canal.
- Parameters
-
message The message.
- Muestra
YES
si se realizó correctamente oNO
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
-
message The message. error A pointer at which to store the error result. May be nil
.
- Muestra
YES
si se envió correctamente oNO
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
|
readwritenonatomicweak |
Es el delegado para recibir notificaciones de GCKGameManagerChannel.
|
readnonatomicstrong |
Es el estado actual del administrador del juego.
|
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:
|
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.
|
readnonatomiccopyinherited |
Es el espacio de nombres del canal.
|
readnonatomicassigninherited |
Es una marca que indica si este canal está conectado actualmente.
|
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
.