Classe GCKCastChannel

Referência da classe GCKCastChannel

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...
 
GCKDeviceManagerdeviceManager
 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
protocolNamespaceThe 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
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

Envia uma mensagem de texto neste canal.

Parameters
messageThe message.
Retorna
YES se a mensagem for bem-sucedida ou NO se 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
messageThe message.
errorA pointer at which to store the error result. May be nil.
Retorna
YES se for bem-sucedido ou NO se 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 nil se 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

- (NSString*) protocolNamespace
readnonatomiccopy

O namespace do canal.

- (BOOL) isConnected
readnonatomicassign

Uma sinalização que indica se o canal está conectado no momento.

- (GCKDeviceManager*) deviceManager
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.