| Entspricht | NSObject |
| Deklariert in | OTSession.h |
Übersicht
Wird zum Senden von Nachrichten für eine OTSession-Instanz verwendet. Die OTSession-Klasse
enthält eine
delegate Eigenschaft. Wenn Sie die
[OTSession initWithApiKey:sessionId:delegate:] Nachricht,
Sie geben ein OTSessionDelegate-Objekt an.
Verbinden mit einer Sitzung
– sessionDidConnect: erforderliche Methode
Wird gesendet, wenn der Client eine Verbindung zur Sitzung herstellt.
- (void)sessionDidConnect:(nonnull OTSession *)session
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
Angemeldet in
OTSession.h
– sessionDidDisconnect: erforderliche Methode
Wird gesendet, wenn der Client die Verbindung zur Sitzung trennt.
- (void)sessionDidDisconnect:(nonnull OTSession *)session
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
Angemeldet in
OTSession.h
– session:didFailWithError: erforderliche Methode
Wird gesendet, wenn der Versuch, eine Verbindung zur Sitzung herzustellen, fehlschlägt oder wenn die Verbindung zur Sitzung nach einer erfolgreichen Verbindung aufgrund eines Fehlers unterbrochen wird.
- (void)session:(nonnull OTSession *)session didFailWithError:(nonnull OTError *)error
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
error |
Eine OTError Objekt, das das Problem beschreibt. Das OTSessionFehlercode „enum“ definiert Werte für die code Eigenschaft dieses Objekts. |
Diskussion
Diese Meldung wird gesendet, nachdem Ihre Anwendung den Aufruf [OTSession connectWithToken:error:].
Wird diese Meldung gesendet, weil die Verbindung zur Sitzung nach einer erfolgreichen Verbindungsherstellung unterbrochen wird, erfolgt der Versand der Meldung unmittelbar vor dem [OTSessionDelegate sessionDidDisconnect:] Nachricht gesendet wird.
Angemeldet in
OTSession.h
Überwachung von Streams in einer Sitzung
– session:streamCreated: erforderliche Methode
Wird gesendet, wenn in dieser Sitzung ein neuer Stream erstellt wird.
- (void)session:(nonnull OTSession *)session streamCreated:(nonnull OTStream *)stream
Parameter
session |
Die OTSession-Instanz, die diese Nachricht gesendet hat. |
stream |
Der mit diesem Ereignis verbundene Stream. |
Diskussion
Beachten Sie, dass, wenn Ihre Anwendung in dieser Sitzung veröffentlicht, Ihr eigener Sitzungsdelegat die Nachricht [OTSessionDelegate session:streamCreated:] für den von ihm selbst veröffentlichten Stream nicht erhält. Für dieses Ereignis siehe den Delegat- Callback [OTPublisherKitDelegate publisher:streamCreated:].
Angemeldet in
OTSession.h
– session:streamDestroyed: erforderliche Methode
Wird gesendet, wenn ein Stream nicht mehr an die Sitzung übertragen wird.
- (void)session:(nonnull OTSession *)session streamDestroyed:(nonnull OTStream *)stream
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
stream |
Der mit diesem Ereignis verbundene Stream. |
Angemeldet in
OTSession.h
Überwachung von Verbindungen in einer Sitzung
– session:connectionCreated:
Wird gesendet, wenn sich ein weiterer Client mit der Sitzung verbindet. Die connection Objekt
stellt die Verbindung des Clients dar.
- (void)session:(nonnull OTSession *)session connectionCreated:(nonnull OTConnection *)connection
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
connection |
Das neue OTConnection Objekt. |
Diskussion
Diese Meldung wird nicht gesendet, wenn sich Ihr eigener Client mit der Sitzung verbindet. Stattdessen wird die [OTSessionDelegate sessionDidConnect:] Die Meldung wird gesendet, wenn sich Ihr eigener Client mit der Sitzung verbindet.
Angemeldet in
OTSession.h
– session:connectionDestroyed:
Wird gesendet, wenn ein anderer Client die Verbindung zur Sitzung trennt. Die connection
Das Objekt repräsentiert die Verbindung, die der Client zur Sitzung hatte.
- (void)session:(nonnull OTSession *)session connectionDestroyed:(nonnull OTConnection *)connection
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
connection |
Die OTConnection Objekt für den Client, der die Verbindung zur Sitzung getrennt hat. |
Diskussion
Diese Meldung wird nicht gesendet, wenn Ihr eigener Client die Verbindung zur Sitzung trennt. Stattdessen wird die [OTSessionDelegate sessionDidDisconnect:] Die Meldung wird gesendet, wenn sich Ihr eigener Client mit der Sitzung verbindet.
Angemeldet in
OTSession.h
– session:receivedSignalType:fromConnection:withString:
Wird gesendet, wenn eine Nachricht in der Sitzung empfangen wird.
- (void)session:(nonnull OTSession *)session receivedSignalType:(NSString *_Nullable)type fromConnection:(OTConnection *_Nullable)connection withString:(NSString *_Nullable)string
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
type |
Die Typzeichenfolge des Signals. |
connection |
Die Verbindung, die den Client identifiziert, der die Nachricht gesendet hat. Dieser Wert kann nil. |
string |
Die Signaldaten. |
Angemeldet in
OTSession.h
Überwachung von Archivierungsvorgängen
– session:archiveStartedWithId:name:
Wird gesendet, wenn die Aufzeichnung einer Sitzung aus dem Archiv beginnt. Wenn Sie sich mit einer Sitzung verbinden, deren Aufzeichnung bereits läuft, wird diese Meldung bei der Verbindung gesendet.
- (void)session:(nonnull OTSession *)session archiveStartedWithId:(nonnull NSString *)archiveId name:(NSString *_Nullable)name
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
archiveId |
Die eindeutige ID des Archivs. |
name |
Der Name des Archivs (sofern bei der Erstellung des Archivs ein Name angegeben wurde). |
Diskussion
Als Reaktion auf diese Meldung möchten Sie möglicherweise eine Benachrichtigung in der Benutzeroberfläche hinzufügen (z. B. ein Symbol in der Publisher-Ansicht), die darauf hinweist, dass die Sitzung aufgezeichnet wird.
Weitere Informationen finden Sie auf der OpenTok-Website Überblick über die Archivierung.
Angemeldet in
OTSession.h
– session:archiveStoppedWithId:
Wird gesendet, wenn die Wiedergabe einer Archivaufzeichnung einer Sitzung beendet wird.
- (void)session:(nonnull OTSession *)session archiveStoppedWithId:(nonnull NSString *)archiveId
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
archiveId |
Die eindeutige ID des Archivs. |
Diskussion
Als Reaktion auf diese Meldung möchten Sie möglicherweise eine Benachrichtigung in der Benutzeroberfläche (z. B. ein Symbol in der Publisher-Ansicht) ändern oder entfernen, die darauf hinweist, dass die Sitzung aufgezeichnet wird.
Weitere Informationen finden Sie auf der OpenTok-Website Überblick über die Archivierung.
Angemeldet in
OTSession.h
Wiederverbindung zu einer Sitzung
– sessionDidBeginReconnecting:
Wird gesendet, wenn der lokale Client die Verbindung zu einer OpenTok-Sitzung verloren hat und versucht, die Verbindung wiederherzustellen. Dies ist auf einen Ausfall der Netzwerkverbindung zurückzuführen. Wenn der Client die Verbindung zur Sitzung wiederherstellen kann, wird die [OTSessionDelegate sessionDidReconnect:] Die Nachricht wird gesendet. Andernfalls, wenn der Client die Verbindung nicht wiederherstellen kann, wird die [OTSessionDelegate sessionDidDisconnect:] Die Nachricht wird gesendet.
- (void)sessionDidBeginReconnecting:(nonnull OTSession *)session
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
Diskussion
Als Reaktion auf den Versand dieser Nachricht sollten Sie möglicherweise eine Benachrichtigung über die Benutzeroberfläche anzeigen, um den Benutzer darüber zu informieren, dass die App versucht, die Verbindung zur Sitzung wiederherzustellen, und dass die Audio- und Videostreams vorübergehend unterbrochen sind.
Angemeldet in
OTSession.h
– sessionDidReconnect:
Wird gesendet, wenn der lokale Client die Verbindung zur OpenTok-Sitzung wiederhergestellt hat, nachdem seine
Netzwerkverbindung vorübergehend unterbrochen war. Wenn die Verbindung unterbrochen wird, wird die
[OTSessionDelegate sessionDidBeginReconnecting:] Die Nachricht wird gesendet, bevor
die [OTSessionDelegate sessionDidReconnect:] Meldung.
Wenn der Client die Verbindung zur Sitzung nicht wiederherstellen kann, wird die
[OTSessionDelegate sessionDidDisconnect:] Nachricht gesendet wird.
- (void)sessionDidReconnect:(nonnull OTSession *)session
Parameter
session |
Die OTSession Instanz, die diese Nachricht gesendet hat. |
Diskussion
Alle bestehenden Publisher und Subscriber werden automatisch wieder verbunden, wenn der Client die Verbindung wiederherstellt und diese Nachricht gesendet wird.
Standardmäßig werden alle Signale, die vom lokalen Client mithilfe der
[OTSession signalWithType:string:connection:error:] Die Signale der Methode werden gesendet, wenn
der Client die Verbindung wiederherstellt. Um zu verhindern, dass Signale, die während der Unterbrechung der Verbindung ausgelöst wurden,
gesendet werden, verwenden Sie die
[OTSession signalWithType:string:connection:retryAfterReconnect:error:]
Methode zum Senden des Signals und legen Sie die retryAfterReconnect
Parameter zu NO. (Alle Signale, die von anderen Clients gesendet wurden, während die Verbindung Ihres
Clients unterbrochen war, werden bei der Wiederherstellung der Verbindung empfangen.)
Siehe [OTSessionDelegate sessionDidBeginReconnecting:].
Angemeldet in
OTSession.h
Überwachung von Änderungen des Stummschaltstatus
– session:muteForced:
Wird gesendet, wenn ein Moderator Streams in der Sitzung stummschaltet oder den Stummschaltstatus in der Sitzung aufhebt.
- (void)session:(nonnull OTSession *)session muteForced:(nonnull OTMuteForcedInfo *)muteForcedInfo
Parameter
session |
Die Sitzung. |
muteForcedInfo |
Prüfen Sie die active Eigenschaft dieses Objekts. Wenn sie auf YES, hat der Moderator die Streams in der Sitzung stummgeschaltet. Wenn die Einstellung auf NO, ein Moderator hat den Stummschaltungsstatus in der Sitzung deaktiviert. |
Diskussion
Siehe [OTSession forceMuteAll:error:], [OTSession-Funktionen], [OTPublisherKitDelegate muteForced:]und Stummschalten des Tons von Streams in einer Sitzung.
Angemeldet in
OTSession.h