Überblick
Ein virtueller Kommunikationskanal für den Austausch von Nachrichten zwischen einem Cast-Sender und einem Cast-Empfänger.
Jeder Kanal ist mit einem eindeutigen Namespace gekennzeichnet, sodass mehrere Kanäle über eine einzelne Netzwerkverbindung zwischen Sender und Empfänger Multiplexing durchgeführt werden können.
Ein Kanal muss mit einer GCKCastSession registriert werden, bevor er verwendet werden kann. Nach Einrichtung der zugeordneten Sitzung wird der Kanal automatisch verbunden und kann dann Nachrichten senden und empfangen.
Abgeleitete Klassen sollten die Methode didReceiveTextMessage: (GCKCastChannel) implementieren, um eingehende Nachrichten zu verarbeiten. In der Regel bieten sie zusätzliche Methoden zum Senden von Nachrichten, die für einen bestimmten Namespace spezifisch sind.
Übernimmt NSObject.
Übernommen von GCKGameManagerChannel, GCKGenericChannel und GCKMediaControlChannel.
Übersicht über Instanzmethoden | |
(instancetype) | - initWithNamespace: |
Definierter Initialisierer. Mehr... | |
(instancetype) | - init |
Standardinitialisierer ist nicht verfügbar. Mehr... | |
(void) | - didReceiveTextMessage: |
Wird aufgerufen, wenn eine SMS auf diesem Kanal eingeht. Mehr... | |
(BOOL) | - sendTextMessage: |
SMS an diesen Kanal senden Mehr... | |
(BOOL) | - sendTextMessage:error: |
SMS an diesen Kanal senden Mehr... | |
(NSInteger) | - generateRequestID |
Erzeugt eine Anfrage-ID für eine neue Nachricht. Mehr... | |
(NSNumber *__nullable) | - generateRequestNumber |
Eine praktische Methode, bei der das Ergebnis von generateRequestID in eine NSNumber zusammengefasst wird. Mehr... | |
(void) | - didConnect |
Wird aufgerufen, wenn dieser Kanal verbunden wurde. Dies weist darauf hin, dass Nachrichten jetzt über diesen Kanal mit dem Übertragungsgerät ausgetauscht werden können. Mehr... | |
(void) | - didDisconnect |
Wird aufgerufen, wenn die Verbindung zu diesem Kanal getrennt wurde. Dies bedeutet, dass über diesen Kanal keine Nachrichten mehr mit dem Übertragungsgerät ausgetauscht werden können. Mehr... | |
Property-Zusammenfassung | |
NSString * | protocolNamespace |
Der Namespace des Kanals. Mehr... | |
BOOL | isConnected |
Eine Markierung, die angibt, ob dieser Kanal derzeit verbunden ist. Mehr... | |
GCKDeviceManager * | deviceManager |
Der Gerätemanager, mit dem dieser Kanal registriert ist, falls vorhanden. Mehr... | |
Methodendetail
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
Definierter Initialisierer.
Erstellt ein neues GCKCastChannel mit dem angegebenen Namespace.
- Parameters
-
protocolNamespace The namespace.
In GCKGenericChannel implementiert.
- (instancetype) init |
Standardinitialisierer ist nicht verfügbar.
In GCKMediaControlChannel und GCKGameManagerChannel implementiert.
- (void) didReceiveTextMessage: | (NSString *) | message |
Wird aufgerufen, wenn eine SMS auf diesem Kanal eingeht.
Die Standardimplementierung ist ein Leerbefehl.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
SMS an diesen Kanal senden
- Parameters
-
message The message.
- Rückgaben
YES
bei Erfolg oderNO
, wenn die Nachricht nicht gesendet werden konnte (weil der Kanal nicht verbunden ist oder der Sendepuffer derzeit zu voll ist).
- Deprecated:
- Verwenden Sie sendTextMessage:error:, um detaillierte Fehlerinformationen bereitzustellen.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
SMS an diesen Kanal senden
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- Rückgaben
YES
bei Erfolg oderNO
, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) generateRequestID |
Erzeugt eine Anfrage-ID für eine neue Nachricht.
- Rückgaben
- Die generierte ID oder kGCKInvalidRequestID, wenn der Kanal derzeit nicht verbunden ist.
- (NSNumber * __nullable) generateRequestNumber |
Eine praktische Methode, bei der das Ergebnis von generateRequestID in eine NSNumber zusammengefasst wird.
- Rückgaben
- Die generierte ID oder
nil
, wenn der Kanal derzeit nicht verbunden ist.
- (void) didConnect |
Wird aufgerufen, wenn dieser Kanal verbunden wurde. Dies weist darauf hin, dass Nachrichten jetzt über diesen Kanal mit dem Übertragungsgerät ausgetauscht werden können.
Die Standardimplementierung ist ein Leerbefehl.
- (void) didDisconnect |
Wird aufgerufen, wenn die Verbindung zu diesem Kanal getrennt wurde. Dies bedeutet, dass über diesen Kanal keine Nachrichten mehr mit dem Übertragungsgerät ausgetauscht werden können.
Die Standardimplementierung ist ein Leerbefehl.
Objektdetails
|
readnonatomiccopy |
Der Namespace des Kanals.
|
readnonatomicassign |
Eine Markierung, die angibt, ob dieser Kanal derzeit verbunden ist.
|
readnonatomicweak |
Der Gerätemanager, mit dem dieser Kanal registriert ist, falls vorhanden.
- Deprecated:
- Wenn dieser Kanal nicht mit der eingestellten GCKDeviceManager-Klasse registriert wurde, ist das
nil
.