Classe GCKGameManagerChannel

Métodos de instância | Propriedades

Referência da classe GCKGameManagerChannel

Visão geral

Uma subclasse GCKCastChannel para operações de controle de jogos.

Consulte GCKGameManagerChannelDelegate para conferir o protocolo de delegação.

Deprecated:

A API Game Manager não é mais compatível e será removida em uma versão futura.

Herda GCKCastChannel.

Resumo do método de instância
(instancetype)	- initWithSessionID:
	Inicializador designado. Mais...
(instancetype)	- init
	O inicializador padrão não está disponível. Mais...
(NSInteger)	- sendPlayerAvailableRequest:
	Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateAvailable. Mais...
(NSInteger)	- sendPlayerAvailableRequest:playerID:
	Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateAvailable. Mais...
(NSInteger)	- sendPlayerReadyRequest:
	Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateReady. Mais...
(NSInteger)	- sendPlayerReadyRequest:playerID:
	Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateReady. Mais...
(NSInteger)	- sendPlayerPlayingRequest:
	Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStatePlaying. Mais...
(NSInteger)	- sendPlayerPlayingRequest:playerID:
	Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStatePlaying. Mais...
(NSInteger)	- sendPlayerIdleRequest:
	Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateIdle. Mais...
(NSInteger)	- sendPlayerIdleRequest:playerID:
	Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateIdle. Mais...
(NSInteger)	- sendPlayerQuitRequest:
	Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateQuit. Mais...
(NSInteger)	- sendPlayerQuitRequest:playerID:
	Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateQuit. Mais...
(NSInteger)	- sendGameRequest:
	Envia uma mensagem específica do jogo para o destinatário. Mais...
(NSInteger)	- sendGameRequest:playerID:
	Envia uma mensagem específica do jogo para o destinatário. Mais...
(void)	- sendGameMessage:
	Envia uma mensagem específica do jogo para o destinatário. Mais...
(void)	- sendGameMessage:playerID:
	Envia uma mensagem específica do jogo para o destinatário. Mais...
(instancetype)	- initWithNamespace:
	Inicializador designado. Mais...
(void)	- didReceiveTextMessage:
	Chamado quando uma mensagem de texto é recebida neste canal. Mais...
(BOOL)	- sendTextMessage:
	Envia uma mensagem de texto neste canal. Mais...
(BOOL)	- sendTextMessage:error:
	Envia uma mensagem de texto neste canal. Mais...
(NSInteger)	- generateRequestID
	Gera um ID de solicitação para uma nova mensagem. Mais...
(NSNumber *__nullable)	- generateRequestNumber
	Um método prático que encapsula o resultado de generateRequestID em um NSNumber. Mais...
(void)	- didConnect
	Chamado quando o canal é conectado, indicando que as mensagens podem ser trocadas com o dispositivo Google Cast por ele. Mais...
(void)	- didDisconnect
	Chamado quando este canal é desconectado, indicando que as mensagens não podem mais ser trocadas com o dispositivo Cast por ele. Mais...

Resumo da propriedade
id< GCKGameManagerChannelDelegate >	delegate
	O delegado para receber notificações do GCKGameManagerChannel. Mais...
GCKGameManagerState *	currentState
	O estado atual do gerenciador de jogos. Mais...
NSString *	lastUsedPlayerID
	O último ID de jogador controlável usado nesta sessão. Mais...
BOOL	isInitialConnectionEstablished
	Se este canal está conectado ao Game Manager do receptor e se estamos prontos para interagir com ele. Mais...
NSString *	protocolNamespace
	O namespace do canal. Mais...
BOOL	isConnected
	Uma flag que indica se o canal está conectado no momento. Mais...
GCKDeviceManager *	deviceManager
	O gerenciador de dispositivos em que este canal está registrado, se houver. Mais...

Detalhes do método

- (instancetype) initWithSessionID:

(NSString *)

castSessionID

Inicializador designado.

Conecta-se automaticamente ao Gerenciador de jogos do destinatário.

Parameters

castSessionID

The Session ID corresponding to the currently connected Game Manager.

- (instancetype) init

O inicializador padrão não está disponível.

Implementa GCKCastChannel.

- (NSInteger) sendPlayerAvailableRequest:

(id __nullable)

extraData

Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateAvailable.

Se essa não for uma transição válida para o jogador, um erro será acionado no GCKGameManagerChannelDelegate. Se não houver um player usado por último, um novo player será registrado, e o ID dele será definido como o ID do player usado por último quando o receptor responder a essa solicitação. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do receptor.

Consulte também

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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerAvailableRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateAvailable.

Se essa não for uma transição válida para o jogador, um erro será acionado no GCKGameManagerChannelDelegate. Se o ID do jogador for nil, um novo jogador será registrado, e o ID dele será definido como o último ID usado quando o receptor responder a essa solicitação. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerReadyRequest:

(id __nullable)

extraData

Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateReady.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do receptor.

Consulte também

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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerReadyRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateReady.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerPlayingRequest:

(id __nullable)

extraData

Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStatePlaying.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do receptor.

Consulte também

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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerPlayingRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStatePlaying.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerIdleRequest:

(id __nullable)

extraData

Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateIdle.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia mensagens de retorno de chamada do delegado GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do receptor.

Consulte também

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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerIdleRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateIdle.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerQuitRequest:

(id __nullable)

extraData

Envia uma solicitação ao destinatário para colocar o player usado por último neste remetente no estado GCKPlayerStateQuit.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do receptor.

Consulte também

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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendPlayerQuitRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma solicitação ao receptor para colocar o player no estado GCKPlayerStateQuit.

Se essa não for uma transição válida para o jogador ou se não houver um ID de jogador usado por último, um erro será acionado no GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendGameRequest:

(id __nullable)

extraData

Envia uma mensagem específica do jogo para o destinatário.

O conteúdo da mensagem depende totalmente do aplicativo. A mensagem será enviada por lastUsedPlayerID. O destinatário vai enviar uma resposta de volta ao remetente usando o GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia mensagens para o callback do delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao GameManager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) sendGameRequest:		(id __nullable)	extraData
playerID:		(NSString *)	playerID

Envia uma mensagem específica do jogo para o destinatário.

O conteúdo da mensagem depende totalmente do aplicativo. A mensagem será enviada por playerID. Se playerID for nil, lastUsedPlayerID será usado. O destinatário vai enviar uma resposta de volta ao remetente usando o GCKGameManagerChannelDelegate. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (void) sendGameMessage:

(id __nullable)

extraData

Envia uma mensagem específica do jogo para o destinatário.

O conteúdo da mensagem depende totalmente do aplicativo. A mensagem será enviada por lastUsedPlayerID. Esse é um método de "disparar e esquecer", em que não há garantia de que a mensagem foi enviada, e o destinatário não enviará uma resposta ao remetente. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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

Envia uma mensagem específica do jogo para o destinatário.

O conteúdo da mensagem depende totalmente do aplicativo. A mensagem vai ser originada do ID do jogador local especificado. Esse é um método de "disparar e esquecer", em que não há garantia de que a mensagem será enviada, e o destinatário não enviará uma resposta ao remetente. Esse método só pode ser chamado depois que o callback delegado gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Envia uma mensagem de volta para o delegado gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Game Manager do 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.

Cria um novo GCKCastChannel com o namespace especificado.

Parameters

protocolNamespace

The namespace.

Implementado em GCKGenericChannel.

- (void) didReceiveTextMessage:

(NSString *)

message

Chamado quando uma mensagem de texto é recebida neste canal.

A implementação padrão é uma operação nula.

Parameters

message

The message.

- (BOOL) sendTextMessage:

(NSString *)

message

Envia uma mensagem de texto neste canal.

Parameters

message

The message.

Retorna

YES em caso de sucesso ou NO se a mensagem não puder ser enviada (porque o canal não está conectado ou porque o buffer de envio está muito cheio no momento).

Deprecated:

Use sendTextMessage:error:, que fornece informações detalhadas sobre o erro.

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

Envia uma mensagem de texto neste canal.

Parameters

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

Retorna

YES em caso de sucesso ou NO se a mensagem não puder ser enviada.

- (NSInteger) generateRequestID

Gera um ID de solicitação para uma nova mensagem.

Retorna

O ID gerado ou kGCKInvalidRequestID se o canal não estiver conectado no momento.

- (NSNumber * __nullable) generateRequestNumber

Um método prático que encapsula o resultado de generateRequestID em um NSNumber.

Retorna

O ID gerado ou nil se o canal não estiver conectado no momento.

- (void) didConnect

Chamado quando o canal é conectado, indicando que as mensagens podem ser trocadas com o dispositivo Google Cast por ele.

A implementação padrão é uma operação nula.

- (void) didDisconnect

Chamado quando este canal é desconectado, indicando que as mensagens não podem mais ser trocadas com o dispositivo Cast por ele.

A implementação padrão é uma operação nula.

Detalhes da propriedade

- (id<GCKGameManagerChannelDelegate>) delegate

readwritenonatomicweak

O delegado para receber notificações do GCKGameManagerChannel.

- (GCKGameManagerState*) currentState

readnonatomicstrong

O estado atual do gerenciador de jogos.

- (NSString*) lastUsedPlayerID

readnonatomiccopy

O último ID de jogador controlável usado nesta sessão.

Pode ser nil se não houver um player controlável configurado com o receptor.

Consulte também

- sendPlayerAvailableRequest:

- (BOOL) isInitialConnectionEstablished

readnonatomicassign

Se este canal está conectado ao Game Manager do receptor e se estamos prontos para interagir com ele.

Esse método vai retornar NO desde a criação do canal.

Retorna

YES se o canal estiver conectado ao Gerenciador de jogos do receptor e pronto para interagir com ele; NO caso contrário.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

O namespace do canal.

- (BOOL) isConnected

readnonatomicassigninherited

Uma flag que indica se o canal está conectado no momento.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

O gerenciador de dispositivos em que este canal está registrado, se houver.

Deprecated:

Se o canal não tiver sido registrado com a classe GCKDeviceManager descontinuada, o valor será nil.