Informações gerais
Um canal de comunicação virtual para trocar mensagens entre um remetente e um receptor da transmissão.
Cada canal é marcado com um namespace exclusivo. Por isso, vários canais podem ser multiplexados em uma única conexão de rede entre um remetente e um receptor.
Antes de usar um canal, ele precisa estar registrado com um GCKCastSession. Quando a sessão associada for estabelecida, o canal será conectado automaticamente e poderá enviar e receber mensagens.
As subclasses precisam implementar o método didReceiveTextMessage: (GCKCastChannel) para processar mensagens recebidas e normalmente fornecem métodos adicionais para enviar mensagens específicas de um determinado namespace.
Herda o NSObject.
Herdado por GCKGameManagerChannel, GCKGenericChannel e GCKMediaControlChannel.
Resumo do método de instância | |
| (instancetype) | - initWithNamespace: |
| Iniciador designado. Mais... | |
| (instancetype) | - init |
| O inicializador padrão não está disponível. Mais... | |
| (void) | - didReceiveTextMessage: |
| Chamado quando uma mensagem de texto é recebida no 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 envolve o resultado de generateRequestID em um NSNumber. Mais... | |
| (void) | - didConnect |
| Chamado quando este canal está conectado, indicando que agora é possível trocar mensagens com o dispositivo de transmissão por este canal. Mais... | |
| (void) | - didDisconnect |
| Chamado quando este canal é desconectado, indicando que as mensagens não podem mais ser trocadas com o dispositivo de transmissão por este canal. Mais... | |
Resumo da propriedade | |
| NSString * | protocolNamespace |
| O namespace do canal. Mais... | |
| BOOL | isConnected |
| Uma sinalização que indica se o canal está conectado no momento. Mais... | |
| GCKDeviceManager * | deviceManager |
| O gerenciador de dispositivos com o qual o canal está registrado, se houver. Mais... | |
Detalhes dos métodos
| - (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
Iniciador designado.
Constrói um novo GCKCastChannel com o namespace especificado.
- Parameters
-
protocolNamespace The namespace.
Implementado em GCKGenericChannel.
| - (instancetype) init |
O inicializador padrão não está disponível.
Implementado em GCKMediaControlChannel e GCKGameManagerChannel.
| - (void) didReceiveTextMessage: | (NSString *) | message |
Chamado quando uma mensagem de texto é recebida no 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
YESse a mensagem for bem-sucedida ouNOse não for possível enviar a mensagem (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
YESse for bem-sucedido ouNOse não for possível enviar a mensagem.
| - (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 envolve 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 este canal está conectado, indicando que agora é possível trocar mensagens com o dispositivo de transmissão por este canal.
A implementação padrão é um ambiente autônomo.
| - (void) didDisconnect |
Chamado quando este canal é desconectado, indicando que as mensagens não podem mais ser trocadas com o dispositivo de transmissão por este canal.
A implementação padrão é um ambiente autônomo.
Detalhe da propriedade
|
readnonatomiccopy |
O namespace do canal.
|
readnonatomicassign |
Uma sinalização que indica se o canal está conectado no momento.
|
readnonatomicweak |
O gerenciador de dispositivos com o qual o canal está registrado, se houver.
- Deprecated:
- Se o canal não estiver registrado com a classe descontinuada GCKDeviceManager, ele será
nil.