Clase GCKGameManagerChannel

Métodos de instancia | Propiedades

Referencia de la clase GCKGameManagerChannel

Descripción general

Una subclase 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 del método de instancia
(instancetype)	- initWithSessionID:
	Inicializador designado. Más...
(instancetype)	- init
	El inicializador predeterminado no está disponible. Más...
(NSInteger)	- sendPlayerAvailableRequest:
	Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateAvailable. Más...
(NSInteger)	- sendPlayerAvailableRequest:playerID:
	Envía una solicitud al receptor para colocar el reproductor en el estado GCKPlayerStateAvailable. Más...
(NSInteger)	- sendPlayerReadyRequest:
	Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateReady. Más...
(NSInteger)	- sendPlayerReadyRequest:playerID:
	Envía una solicitud al receptor para colocar el reproductor en el estado GCKPlayerStateReady. Más...
(NSInteger)	- sendPlayerPlayingRequest:
	Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStatePlaying. Más...
(NSInteger)	- sendPlayerPlayingRequest:playerID:
	Envía una solicitud al receptor para colocar el reproductor en el estado GCKPlayerStatePlaying. Más...
(NSInteger)	- sendPlayerIdleRequest:
	Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateIdle. Más...
(NSInteger)	- sendPlayerIdleRequest:playerID:
	Envía una solicitud al receptor para colocar el reproductor en el estado GCKPlayerStateIdle. Más...
(NSInteger)	- sendPlayerQuitRequest:
	Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateQuit. Más...
(NSInteger)	- sendPlayerQuitRequest:playerID:
	Envía una solicitud al receptor para colocar 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:
	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 a este canal. Más...
(BOOL)	- sendTextMessage:error:
	Envía un mensaje de texto a este canal. Más...
(NSInteger)	- generateRequestID
	Genera un ID de solicitud para un mensaje nuevo. Más...
(NSNumber *__nullable)	- generateRequestNumber
	Un método de conveniencia que une el resultado de generateRequestID en un NSNumber. Más...
(void)	- didConnect
	Se llama cuando este canal se conecta, lo que indica que los mensajes ahora se pueden intercambiar con el dispositivo de transmisión a través de este canal. Más...
(void)	- didDisconnect
	Se llama cuando este canal se desconecta, lo que indica que los mensajes ya no se pueden intercambiar con el dispositivo de transmisión a través de este canal. Más...

Resumen de la propiedad
id< GCKGameManagerChannelDelegate >	delegate
	El delegado para recibir notificaciones de GCKGameManagerChannel. Más...
GCKGameManagerState *	currentState
	El estado actual del administrador del juego. Más...
NSString *	lastUsedPlayerID
	Indica el último ID de jugador controlable que se usó en esta sesión. Más...
BOOL	isInitialConnectionEstablished
	Si este canal está conectado con el Administrador de juegos del destinatario y estamos listos para interactuar con él. Más...
NSString *	protocolNamespace
	El espacio de nombres del canal. Más...
BOOL	isConnected
	Marca que indica si el canal está conectado actualmente Más...
GCKDeviceManager *	deviceManager
	El administrador de dispositivos con el que se registró este canal, si corresponde. Más...

Detalle del método

- (instancetype) initWithSessionID:

(NSString *)

castSessionID

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 poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateAvailable.

Si esta no es una transición válida para ese reproductor, se activará un error en GCKGameManagerChannelDelegate. Si no hay un último reproductor utilizado, se registrará un reproductor nuevo y su ID de jugador se configurará como el último que se usó cuando el receptor responda a esta solicitud. Solo se debe llamar a este método después de que se haya enviado la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 colocar el reproductor en el estado GCKPlayerStateAvailable.

Si esta no es una transición válida para ese reproductor, se activará un error en GCKGameManagerChannelDelegate. Si el ID de jugador es nil, se registrará un jugador nuevo y se establecerá como el último ID de jugador que se usó cuando el receptor respondió a esta solicitud. Solo se debe llamar a este método después de que se haya enviado la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) sendPlayerReadyRequest:

(id __nullable)

extraData

Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateReady.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 colocar el reproductor en el estado GCKPlayerStateReady.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) sendPlayerPlayingRequest:

(id __nullable)

extraData

Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStatePlaying.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 colocar el reproductor en el estado GCKPlayerStatePlaying.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) sendPlayerIdleRequest:

(id __nullable)

extraData

Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateIdle.

Si esta no es una transición válida para el reproductor 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 recibido la devolución de llamada de delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: delegate callback si GCKGameManagerChannel aún no está conectado al Game Manager 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.

Resultado que se muestra

El ID de 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 colocar el reproductor en el estado GCKPlayerStateIdle.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) sendPlayerQuitRequest:

(id __nullable)

extraData

Envía una solicitud al receptor para poner el último reproductor utilizado en este remitente en el estado GCKPlayerStateQuit.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 colocar el reproductor en el estado GCKPlayerStateQuit.

Si esta no es una transición válida para el reproductor 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 totalmente de la aplicación. El mensaje se originará en 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía una devolución de llamada del delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel aún no está conectado al GameManager 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.

Resultado que se muestra

El ID de 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 totalmente de la aplicación. El mensaje se originará en 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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.

Resultado que se muestra

El ID de 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 totalmente de la aplicación. El mensaje se originará en lastUsedPlayerID. Este es un método de activación y descarte en el que no se garantiza que se haya enviado el mensaje y que el receptor no envíe una respuesta a este remitente. Solo se debe llamar a este método después de que se haya enviado la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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á a partir del ID de reproductor local especificado. Este es un método de activación y descarte 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 la devolución de llamada del delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Envía un mensaje a la devolución de llamada delegada de gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si el dispositivo 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

Inicializador designado.

Construye un GCKCastChannel nuevo con el espacio de nombres dado.

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 es no-op.

Parameters

message

The message.

- (BOOL) sendTextMessage:

(NSString *)

message

Envía un mensaje de texto a este canal.

Parameters

message

The message.

Resultado que se muestra

YES tiene éxito 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 los errores.

- (BOOL) sendTextMessage:		(NSString *)	message
error:		(GCKError *__nullable *__nullable)	error

Envía un mensaje de texto a este canal.

Parameters

message	The message.
error	A pointer at which to store the error result. May be nil.

Resultado que se muestra

YES en caso de éxito o NO si no se pudo enviar el mensaje.

- (NSInteger) generateRequestID

Genera un ID de solicitud para un mensaje nuevo.

Resultado que se muestra

El ID generado o kGCKInvalidRequestID si el canal no está conectado actualmente.

- (NSNumber * __nullable) generateRequestNumber

Un método de conveniencia que une el resultado de generateRequestID en un NSNumber.

Resultado que se muestra

El ID generado o nil si el canal no está conectado actualmente.

- (void) didConnect

Se llama cuando este canal se conecta, lo que indica que los mensajes ahora se pueden intercambiar con el dispositivo de transmisión a través de este canal.

La implementación predeterminada es no-op.

- (void) didDisconnect

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

La implementación predeterminada es no-op.

Detalles de la propiedad

- (id<GCKGameManagerChannelDelegate>) delegate

readwritenonatomicweak

El delegado para recibir notificaciones de GCKGameManagerChannel.

- (GCKGameManagerState*) currentState

readnonatomicstrong

El estado actual del administrador del juego.

- (NSString*) lastUsedPlayerID

readnonatomiccopy

Indica el último ID de jugador controlable que se usó en esta sesión.

Este valor puede ser nil si no hay un reproductor controlable configurado en el receptor.

Consulta también

- sendPlayerAvailableRequest:

- (BOOL) isInitialConnectionEstablished

readnonatomicassign

Si este canal está conectado con el Administrador de juegos del destinatario y estamos listos para interactuar con él.

Este método mostrará NO desde el punto de creación de este canal.

Resultado que se muestra

YES si este canal está conectado al Administrador de juegos del destinatario y está listo para interactuar; NO si no lo está.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

El espacio de nombres del canal.

- (BOOL) isConnected

readnonatomicassigninherited

Marca que indica si el canal está conectado actualmente

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

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

Deprecated:

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