Panoramica
Un canale di comunicazione virtuale per lo scambio di messaggi tra un mittente e un ricevitore di trasmissione.
Ogni canale è contrassegnato con uno spazio dei nomi univoco, quindi più canali possono essere multiplexati su una singola connessione di rete tra un mittente e un destinatario.
Un canale deve essere registrato con un GCKCastSession prima di poter essere utilizzato. Una volta stabilita la sessione associata, il canale si connetterà automaticamente e potrà inviare e ricevere messaggi.
Le sottoclassi devono implementare il metodo didReceiveTextMessage: (GCKCastChannel) per elaborare i messaggi in arrivo e in genere forniscono metodi aggiuntivi per l'invio di messaggi specifici per un determinato spazio dei nomi.
Eredita NSObject.
Ereditato da GCKGameManagerChannel, GCKGenericChannel e GCKMediaControlChannel.
Riepilogo del metodo di istanza | |
(instancetype) | - initWithNamespace: |
Inizializzatore designato. Altro... | |
(instancetype) | - init |
Inizializzatore predefinito non disponibile. Altro... | |
(void) | - didReceiveTextMessage: |
Chiamato quando è stato ricevuto un SMS su questo canale. Altro... | |
(BOOL) | - sendTextMessage: |
Invia un SMS su questo canale. Altro... | |
(BOOL) | - sendTextMessage:error: |
Invia un SMS su questo canale. Altro... | |
(NSInteger) | - generateRequestID |
Genera un ID richiesta per un nuovo messaggio. Altro... | |
(NSNumber *__nullable) | - generateRequestNumber |
Un metodo di convenienza che aggrega il risultato di generateRequestID in un NSNumber. Altro... | |
(void) | - didConnect |
Richiamato quando il canale è connesso, a indicare che ora è possibile scambiare messaggi con il dispositivo di trasmissione su questo canale. Altro... | |
(void) | - didDisconnect |
Richiamato quando il canale è stato disconnesso, per indicare che non è più possibile scambiare messaggi con il dispositivo di trasmissione su questo canale. Altro... | |
Riepilogo proprietà | |
NSString * | protocolNamespace |
Lo spazio dei nomi del canale. Altro... | |
BOOL | isConnected |
Un flag che indica se il canale è attualmente connesso. Altro... | |
GCKDeviceManager * | deviceManager |
L'eventuale gestore dispositivi con cui il canale è registrato. Altro... | |
Dettaglio metodo
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
Inizializzatore designato.
Crea un nuovo GCKCastChannel con lo spazio dei nomi specificato.
- Parameters
-
protocolNamespace The namespace.
Implementata in GCKGenericChannel.
- (instancetype) init |
Inizializzatore predefinito non disponibile.
Implementata in GCKMediaControlChannel e GCKGameManagerChannel.
- (void) didReceiveTextMessage: | (NSString *) | message |
Chiamato quando è stato ricevuto un SMS su questo canale.
L'implementazione predefinita è autonoma.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Invia un SMS su questo canale.
- Parameters
-
message The message.
- Ritorni
YES
in caso di esito positivo oNO
se non è stato possibile inviare il messaggio (perché il canale non è connesso o perché il buffer di invio è troppo pieno al momento).
- Deprecated:
- Utilizza sendTextMessage:error:, che fornisce informazioni dettagliate sull'errore.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
Invia un SMS su questo canale.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- Ritorni
YES
in caso di esito positivo oNO
se non è stato possibile inviare il messaggio.
- (NSInteger) generateRequestID |
Genera un ID richiesta per un nuovo messaggio.
- Ritorni
- L'ID generato oppure kGCKInvalidRequestID se il canale non è attualmente collegato.
- (NSNumber * __nullable) generateRequestNumber |
Un metodo di convenienza che aggrega il risultato di generateRequestID in un NSNumber.
- Ritorni
- L'ID generato oppure
nil
se il canale non è attualmente collegato.
- (void) didConnect |
Richiamato quando il canale è connesso, a indicare che ora è possibile scambiare messaggi con il dispositivo di trasmissione su questo canale.
L'implementazione predefinita è autonoma.
- (void) didDisconnect |
Richiamato quando il canale è stato disconnesso, per indicare che non è più possibile scambiare messaggi con il dispositivo di trasmissione su questo canale.
L'implementazione predefinita è autonoma.
Dettagli della proprietà
|
readnonatomiccopy |
Lo spazio dei nomi del canale.
|
readnonatomicassign |
Un flag che indica se il canale è attualmente connesso.
|
readnonatomicweak |
L'eventuale gestore dispositivi con cui il canale è registrato.
- Deprecated:
- Se questo canale non è stato registrato con la classe GCKDeviceManager ritirata, questo sarà
nil
.