Visão geral
Uma subclasse GCKCastChannel para operações de controle de jogos.
Consulte GCKGameManagerChannelDelegate para ver 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 último jogador usado 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 último jogador usado 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 último jogador usado 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 último jogador usado 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 último jogador usado 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 ao receptor. Mais... | |
| (NSInteger) | - sendGameRequest:playerID: |
| Envia uma mensagem específica do jogo ao receptor. Mais... | |
| (void) | - sendGameMessage: |
| Envia uma mensagem específica do jogo ao receptor. Mais... | |
| (void) | - sendGameMessage:playerID: |
| Envia uma mensagem específica do jogo ao receptor. 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 de conveniência que encapsula o resultado de generateRequestID em um NSNumber. Mais... | |
| (void) | - didConnect |
| Chamado quando o canal está conectado, indicando que agora é possível trocar mensagens com o dispositivo de transmissão por esse canal. Mais... | |
| (void) | - didDisconnect |
| Chamado quando este canal foi desconectado, indicando que não é mais possível trocar mensagens com o dispositivo de transmissão por esse canal. Mais... | |
Resumo da propriedade | |
| id< GCKGameManagerChannelDelegate > | delegate |
| O delegado para receber notificações de GCKGameManagerChannel. Mais... | |
| GCKGameManagerState * | currentState |
| O estado atual do gerenciador de jogos. Mais... | |
| NSString * | lastUsedPlayerID |
| O último ID de player controlável usado nessa sessão. Mais... | |
| BOOL | isInitialConnectionEstablished |
| Se o canal está conectado ao Gerenciador de jogos do destinatário e estamos prontos para interagir com ele. Mais... | |
| NSString * | protocolNamespace |
| O namespace do canal. Mais... | |
| BOOL | isConnected |
| Uma sinalização que indica se o canal está conectado. Mais... | |
| GCKDeviceManager * | deviceManager |
| O administrador do dispositivo usado para registrar o canal. Mais... | |
Detalhes dos métodos
| - (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 último jogador usado neste remetente no estado GCKPlayerStateAvailable.
Se essa não for uma transição válida para esse player, um erro será acionado na GCKGameManagerChannelDelegate. Se não houver um último jogador usado, um novo player será registrado e o ID do jogador dele será definido como o último ID usado quando o destinatário responder a essa solicitação. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- Veja 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, caso a solicitação não possa ser enviada.
| - (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 esse player, um erro será acionado na GCKGameManagerChannelDelegate. Se o ID do jogador for nil, um novo player vai ser registrado, e o ID vai ser definido como o último usado quando o destinatário responder a essa solicitação. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendPlayerReadyRequest: | (id __nullable) | extraData |
Envia uma solicitação ao destinatário para colocar o último jogador usado neste remetente no estado GCKPlayerStateReady.
Se essa não for uma transição válida para esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- Veja 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, caso a solicitação não possa ser enviada.
| - (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 esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendPlayerPlayingRequest: | (id __nullable) | extraData |
Envia uma solicitação ao destinatário para colocar o último jogador usado neste remetente no estado GCKPlayerStatePlaying.
Se essa não for uma transição válida para esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- Veja 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, caso a solicitação não possa ser enviada.
| - (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 esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendPlayerIdleRequest: | (id __nullable) | extraData |
Envia uma solicitação ao destinatário para colocar o último jogador usado neste remetente no estado GCKPlayerStateIdle.
Se essa não for uma transição válida para esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback GCKGameManagerChannel::gameManagerChannel:request DidFailWithID:error: delegado se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do receptor.
- Veja 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, caso a solicitação não possa ser enviada.
| - (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 esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendPlayerQuitRequest: | (id __nullable) | extraData |
Envia uma solicitação ao destinatário para colocar o último jogador usado neste remetente no estado GCKPlayerStateQuit.
Se essa não for uma transição válida para esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- Veja 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, caso a solicitação não possa ser enviada.
| - (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 esse jogador ou se não houver um ID de jogador usado pela última vez, um erro vai ser acionado na GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendGameRequest: | (id __nullable) | extraData |
Envia uma mensagem específica do jogo ao receptor.
O conteúdo da mensagem depende inteiramente do aplicativo. A mensagem será originada de lastUsedPlayerID. O destinatário enviará uma resposta para este remetente usando o GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Transmite o callback de 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, caso a solicitação não possa ser enviada.
| - (NSInteger) sendGameRequest: | (id __nullable) | extraData | |
| playerID: | (NSString *) | playerID | |
Envia uma mensagem específica do jogo ao receptor.
O conteúdo da mensagem depende inteiramente do aplicativo. A mensagem será originada de playerID. Se playerID for nil, lastUsedPlayerID será usado. O destinatário enviará uma resposta para este remetente usando o GCKGameManagerChannelDelegate. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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, caso a solicitação não possa ser enviada.
| - (void) sendGameMessage: | (id __nullable) | extraData |
Envia uma mensagem específica do jogo ao receptor.
O conteúdo da mensagem depende inteiramente do aplicativo. A mensagem será originada de lastUsedPlayerID. Esse é um método "disparar e esquecer" em que não há garantia de que a mensagem foi enviada e o destinatário não vai enviar uma resposta para esse remetente. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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 ao receptor.
O conteúdo da mensagem depende inteiramente do aplicativo. A mensagem será originada do ID de jogador local especificado. Esse é um método "disparar" e "esquecer" em que não há garantia de que a mensagem será enviada e o destinatário não vai enviar uma resposta para esse remetente. Esse método só deve ser chamado depois que o callback delegado do gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) for enviado. Mensagens do callback de delegação gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se o GCKGameManagerChannel ainda não estiver conectado ao Gerenciador de jogos do destinatário.
- 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 fornecido.
- 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 é um ambiente autônomo.
- Parameters
-
message The message.
| - (BOOL) sendTextMessage: | (NSString *) | message |
Envia uma mensagem de texto neste canal.
- Parameters
-
message The message.
- Retorna
YESem caso de sucesso ouNOse a mensagem não puder ser enviada porque o canal não está conectado ou porque o buffer de envio está cheio demais 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
YESse a mensagem não for enviada ouNO.
| - (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 de conveniência que encapsula o resultado de generateRequestID em um NSNumber.
- Retorna
- O ID gerado, ou
nilse o canal não estiver conectado no momento.
| - (void) didConnect |
Chamado quando o canal está conectado, indicando que agora é possível trocar mensagens com o dispositivo de transmissão por esse canal.
A implementação padrão é um ambiente autônomo.
| - (void) didDisconnect |
Chamado quando este canal foi desconectado, indicando que não é mais possível trocar mensagens com o dispositivo de transmissão por esse canal.
A implementação padrão é um ambiente autônomo.
Detalhes da propriedade
|
readwritenonatomicweak |
O delegado para receber notificações de GCKGameManagerChannel.
|
readnonatomicstrong |
O estado atual do gerenciador de jogos.
|
readnonatomiccopy |
O último ID de player controlável usado nessa sessão.
Isso pode ser nil se não houver um player controlável configurado com o receptor.
- Veja também
- - sendPlayerAvailableRequest:
|
readnonatomicassign |
Se o canal está conectado ao Gerenciador de jogos do destinatário e estamos prontos para interagir com ele.
Esse método retornará NO do ponto de criação deste canal.
- Retorna
YESse o canal estiver conectado ao Game Manager do destinatário e pronto para interagir com ele. Caso contrário,NO.
|
readnonatomiccopyinherited |
O namespace do canal.
|
readnonatomicassigninherited |
Uma sinalização que indica se o canal está conectado.
|
readnonatomicweakinherited |
O administrador do dispositivo usado para registrar o canal.
- Deprecated:
- Se esse canal não foi registrado com a classe descontinuada GCKDeviceManager, ele será
nil.