Présentation
Canal de communication virtuel entre un émetteur Cast et un récepteur Cast.
Chaque canal est associé à un espace de noms unique. Ainsi, plusieurs canaux peuvent être multiplexés via une seule connexion réseau entre un expéditeur et un destinataire.
Une chaîne doit être enregistrée auprès d'un GCKCastSession avant de pouvoir être utilisée. Lorsque la session associée est établie, le canal est automatiquement connecté et peut ensuite envoyer et recevoir des messages.
Les sous-classes doivent implémenter la méthode didReceiveTextMessage: (GCKCastChannel) pour traiter les messages entrants et fournir généralement des méthodes supplémentaires pour envoyer des messages spécifiques à un espace de noms donné.
Hérite du NSObject.
Hérité par GCKGameManagerChannel, GCKGenericChannel et GCKMediaControlChannel.
Résumé des méthodes d'instance | |
(instancetype) | - initWithNamespace: |
initialiseur désigné. Plus... | |
(instancetype) | - init |
L'initialiseur par défaut n'est pas disponible. Plus... | |
(void) | - didReceiveTextMessage: |
Appelée lorsqu'un SMS a été reçu sur cette chaîne. Plus... | |
(BOOL) | - sendTextMessage: |
Envoie un message sur cette chaîne. Plus... | |
(BOOL) | - sendTextMessage:error: |
Envoie un message sur cette chaîne. Plus... | |
(NSInteger) | - generateRequestID |
Génère un ID de requête pour un nouveau message. Plus... | |
(NSNumber *__nullable) | - generateRequestNumber |
Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber. Plus... | |
(void) | - didConnect |
Appelée lorsque ce canal a été connecté, indiquant que les messages peuvent désormais être échangés avec l'appareil Cast via ce canal. Plus... | |
(void) | - didDisconnect |
Appelée lorsque ce canal a été déconnecté, ce qui indique que les messages ne peuvent plus être échangés avec l'appareil Cast via ce canal. Plus... | |
Résumé de la propriété | |
NSString * | protocolNamespace |
Espace de noms du canal. Plus... | |
BOOL | isConnected |
Indicateur indiquant si ce canal est actuellement connecté. Plus... | |
GCKDeviceManager * | deviceManager |
Gestionnaire d'appareils auprès duquel cette version est enregistrée, le cas échéant. Plus... | |
Détails sur la méthode
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
initialiseur désigné.
Construit un objet GCKCastChannel avec l'espace de noms donné.
- Parameters
-
protocolNamespace The namespace.
Implémentée dans GCKGenericChannel.
- (instancetype) init |
L'initialiseur par défaut n'est pas disponible.
Implémentée dans GCKMediaControlChannel et GCKGameManagerChannel.
- (void) didReceiveTextMessage: | (NSString *) | message |
Appelée lorsqu'un SMS a été reçu sur cette chaîne.
L'implémentation par défaut est "no-op".
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Envoie un message sur cette chaîne.
- Parameters
-
message The message.
- Renvoie
YES
en cas de réussite ouNO
si le message n'a pas pu être envoyé (parce que le canal n'est pas connecté ou que le tampon d'envoi est trop plein pour le moment).
- Deprecated:
- Utilisez sendTextMessage:error:, qui fournit des informations détaillées sur l'erreur.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
Envoie un message sur cette chaîne.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- Renvoie
YES
en cas de réussite ouNO
si le message n'a pas pu être envoyé.
- (NSInteger) generateRequestID |
Génère un ID de requête pour un nouveau message.
- Renvoie
- ID généré ou kGCKInvalidRequestID si la chaîne n'est pas actuellement associée.
- (NSNumber * __nullable) generateRequestNumber |
Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber.
- Renvoie
- ID généré ou
nil
si la chaîne n'est pas actuellement associée.
- (void) didConnect |
Appelée lorsque ce canal a été connecté, indiquant que les messages peuvent désormais être échangés avec l'appareil Cast via ce canal.
L'implémentation par défaut est "no-op".
- (void) didDisconnect |
Appelée lorsque ce canal a été déconnecté, ce qui indique que les messages ne peuvent plus être échangés avec l'appareil Cast via ce canal.
L'implémentation par défaut est "no-op".
Détails de la propriété
|
readnonatomiccopy |
Espace de noms du canal.
|
readnonatomicassign |
Indicateur indiquant si ce canal est actuellement connecté.
|
readnonatomicweak |
Gestionnaire d'appareils auprès duquel cette version est enregistrée, le cas échéant.
- Deprecated:
- Si cette chaîne n'était pas enregistrée avec la classe GCKDeviceManager obsolète, il s'agira de
nil
.