OTSession


Erbt von	NSObject
Deklariert in	OTSession.h

Übersicht

Der erste Schritt bei der Verwendung des OpenTok-iOS-SDKs besteht darin, ein OTSession-Objekt mit Ihrem API-Schlüssel und einem gültigen Sitzungs-ID Verwenden Sie das OTSession-Objekt, um über Ihren Entwickler eine Verbindung zu OpenTok herzustellen API-Schlüssel und eine gültige Token.

Informationen zur Sitzung abrufen

`sessionConnectionStatus`

Der Status dieser OTSession-Instanz. Nützlich für Ad-hoc-Abfragen zum Sitzungsstatus.

@property (readonly) OTSessionConnectionStatus sessionConnectionStatus

Diskussion

Gültige Werte sind in `OTSessionConnectionStatus` definiert:

OTSessionConnectionStatusNotConnected - Die Sitzung ist nicht verbunden.
OTSessionConnectionStatusConnected - Die Sitzung ist verbunden.
OTSessionConnectionStatusConnecting - Die Sitzung wird gerade hergestellt.
OTSessionConnectionStatusDisconnecting - Die Sitzung wird beendet.
OTSessionConnectionStatusFailed - Bei der Sitzung ist ein schwerwiegender Fehler aufgetreten

Bei der Instanziierung ist mit dem sessionConnectionStatus den Wert zu haben OTSessionConnectionStatusNotConnected.

Sie können einen Schlüssel-Wert-Beobachter verwenden, um diese Eigenschaft zu überwachen. Allerdings ist die [OTSessionDelegate sessionDidConnect:] und [OTSessionDelegate sessionDidDisconnect:] Es werden Nachrichten an den Delegaten der Sitzung gesendet, wenn die Sitzung eine Verbindung herstellt und trennt.

Angemeldet in

OTSession.h

`sessionId`

Die Sitzungs-ID dieser Instanz. Dies ist ein unveränderlicher Wert.

@property (readonly) NSString *sessionId

Angemeldet in

OTSession.h

`streams`

Die Streams, die Teil dieser Sitzung sind, sortiert nach streamId.

@property (readonly) NSDictionary<NSString*OTStream*> *streams

Angemeldet in

OTSession.h

`connection`

Die OTConnection Objekt für diese Sitzung. Die Verbindungseigenschaft ist erst verfügbar, sobald die [OTSessionDelegate sessionDidConnect:] Die Nachricht wird gesendet. Falls die Verbindung zur Sitzung fehlschlägt, bleibt diese Eigenschaft auf „nil“.

@property (readonly) OTConnection *connection

Angemeldet in

OTSession.h

`delegate`

Die OTSessionDelegate Objekt, das als Delegat für dieses OTSession-Objekt dient und Nachrichten im Namen dieser Sitzung verarbeitet.

@property (nonatomic, assign) id<OTSessionDelegate> _Nullable delegate

Angemeldet in

OTSession.h

`apiQueue`

Die Callback-Warteschlange des Delegaten ist anwendungsspezifisch definierbar. Die GCD-Warteschlange für die Ausgabe von Callbacks an den Delegaten kann überschrieben werden, um die Integration mit XCTest (neu in XCode 5) oder anderen Frameworks zu ermöglichen, die im Hauptthread ausgeführt werden müssen.

@property (nonatomic, assign) dispatch_queue_t _Nonnull apiQueue

Angemeldet in

OTSession.h

`capabilities`

Eine OTSessionCapabilities Objekt, das angibt, ob der Client in der Sitzung Streams veröffentlichen und abonnieren kann, basierend auf der Rolle, die dem für die Verbindung zur Sitzung verwendeten Token zugewiesen wurde. Diese Eigenschaft ist auf nil bis Sie eine Verbindung zu einer Sitzung hergestellt haben und die [OTSessionDelegate sessionDidConnect:] Die Methode wurde aufgerufen.

@property (readonly) OTSessionCapabilities *capabilities

Angemeldet in

OTSession.h

Initialisierung und Herstellung einer Verbindung zu einer Sitzung

`– initWithApiKey:sessionId:delegate:`

Initialisieren Sie diese Sitzung mit Ihrem OpenTok-API-Schlüssel, einem Sitzungs-ID, und delegieren Sie dies, bevor Sie eine Verbindung zu OpenTok herstellen. Senden Sie die [OTSession connectWithToken:error:] Meldung um eine Verbindung zur Sitzung herzustellen.

- (nullable id)initWithApiKey:(nonnull NSString *)apiKey sessionId:(nonnull NSString *)sessionId delegate:(nullable id<OTSessionDelegate>)delegate

Parameter


`apiKey`	Ihr OpenTok-API-Schlüssel. Das ist wichtig: Wenn Sie eine Vonage-Anwendung (anstelle eines OpenTok-Projekts) verwenden, geben Sie für diesen Parameter die Anwendungs-ID (nicht einen OpenTok-API-Schlüssel) an.
`sessionId`	Die Sitzungs-ID dieser Instanz.
`delegate`	Der Delegat (OTSessionDelegate), der Nachrichten im Namen dieser Sitzung verarbeitet.

Rückgabewert

Das OTSession-Objekt oder „nil“, falls die Initialisierung fehlschlägt.

Angemeldet in

OTSession.h

`– initWithApiKey:sessionId:delegate:settings:`

Initialisieren Sie das OTSession-Objekt mit den Einstellungen, die durch eine OTSessionEinstellungen Objekt.

- (nullable id)initWithApiKey:(nonnull NSString *)apiKey sessionId:(nonnull NSString *)sessionId delegate:(nullable id<OTSessionDelegate>)delegate settings:(nullable OTSessionSettings *)settings

Parameter


`apiKey`	Ihr OpenTok-API-Schlüssel. Das ist wichtig: Wenn Sie die Video API mit einer Vonage-Anwendung (anstelle eines OpenTok-Projekts) verwenden, geben Sie für diesen Parameter die Anwendungs-ID (nicht einen OpenTok-API-Schlüssel) an.
`sessionId`	Die Sitzungs-ID dieser Instanz.
`delegate`	Der Delegierte (OTSessionDelegate) für die Sitzung.
`settings`	Die (OTSessionEinstellungen) Objekt, das die Einstellungen für die Sitzung definiert.

Angemeldet in

OTSession.h

`– connectWithToken:error:`

Sobald Ihre Bewerbung eine gültige Token, nimm Kontakt auf mit deinem API-Schlüssel um an einer OpenTok-Sitzung teilzunehmen.

- (void)connectWithToken:(nonnull NSString *)token error:(OTError *_Nullable *_Nullable)error

Parameter

token Das für diese Verbindung generierte Token.

error Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die OTSessionErrorCode Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die code Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein synchroner Fehler auftritt. Tritt ein asynchroner Fehler auf, so ist die [OTSessionDelegate session:didFailWithError:] Die Nachricht wird an den Delegaten der Sitzung gesendet.


`token`	Das für diese Verbindung generierte Token.
`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTSessionErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein synchroner Fehler auftritt. Tritt ein asynchroner Fehler auf, so ist die [OTSessionDelegate session:didFailWithError:] Die Nachricht wird an den Delegaten der Sitzung gesendet.

Diskussion

Wenn die Sitzung erfolgreich hergestellt wurde, wird die [OTSessionDelegate sessionDidConnect:] Die Nachricht wird an den Delegaten der Sitzung gesendet.

Wenn die Sitzung keine Verbindung herstellen kann, wird die [OTSessionDelegate session:didFailWithError:] Die Nachricht wird an den Delegaten der Sitzung gesendet.

Wenn die Sitzung getrennt wird, wird die [OTSessionDelegate sessionDidDisconnect:] Die Nachricht wird an den Delegaten der Sitzung gesendet.

Beachten Sie, dass Sitzungen automatisch unterbrochen werden, wenn die Anwendung angehalten wird.

Stellen Sie sicher, dass Sie eine Delegationsmethode für die [OTSessionDelegate session:didFailWithError:] Nachricht.

Angemeldet in

OTSession.h

`– disconnect:`

Die Verbindung zu einer aktiven OpenTok-Sitzung trennen.

- (void)disconnect:(OTError *_Nullable *_Nullable)error

Parameter


`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTSessionErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt.

Diskussion

Diese Methode baut alle OTPublisher- und OTSubscriber-Objekte ab, die initialisiert wurden.

Als bewährte Vorgehensweise sollten Sie vor dem Aufruf dieser Methode die Methode [OTSession unpublish:Fehler:] Methode für alle Herausgeber aufrufen und auf die [OTPublisherKitDelegate publisher:streamDestroyed:] Meldung. Dadurch wird die vollständige Entfernung von Publishern sichergestellt, insbesondere wenn Probleme mit der Netzwerkverbindung die Entfernung aufgrund der Wiederverbindungsfunktion verhindern, die Publisher-Streams für eine mögliche Wiederverbindung aufrechterhalten kann.

Wenn die Sitzung getrennt wird, wird die [OTSessionDelegate sessionDidDisconnect:] Die Nachricht wird an den Delegaten der Sitzung gesendet.

Angemeldet in

OTSession.h

Audio- und Videostreams in eine Sitzung übertragen

`– publish:error:`

Fügt der Sitzung einen Herausgeber hinzu.

- (void)publish:(nonnull OTPublisherKit *)publisher error:(OTError *_Nullable *_Nullable)error

Parameter

publisher Die OTPublisherKit Objekt, mit dem gestreamt werden soll.

error Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die OTPublisherErrorCode Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die code Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt. Tritt ein asynchroner Fehler auf, wird die [OTPublisherKitDelegate publisher:didFailWithError:] Die Nachricht wird an den Beauftragten des Herausgebers gesendet.


`publisher`	Die OTPublisherKit Objekt, mit dem gestreamt werden soll.
`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTPublisherErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt. Tritt ein asynchroner Fehler auf, wird die [OTPublisherKitDelegate publisher:didFailWithError:] Die Nachricht wird an den Beauftragten des Herausgebers gesendet.

Diskussion

Sobald der Publisher mit dem Streaming von Daten beginnt, wird die [OTPublisherKitDelegate publisher:streamCreated:] Die Nachricht wird an den Publisher-Delegaten „delegate“ gesendet.

Falls die Veröffentlichung fehlschlägt, [OTPublisherKitDelegate publisher:didFailWithError:] wird an den Publisher-Delegaten gesendet, und es wird keine Session-Delegat-Nachricht weitergeleitet.

Bitte beachten Sie, dass mehrere Herausgeber nicht unterstützt werden.

Angemeldet in

OTSession.h

`– unpublish:error:`

Entfernt einen Herausgeber aus der Sitzung.

- (void)unpublish:(nonnull OTPublisherKit *)publisher error:(OTError *_Nullable *_Nullable)error

Parameter


`publisher`	Die OTPublisher Objekt, das aus der Sitzung entfernt werden soll.
`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTPublisherErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt.

Diskussion

Nach dem Entfernen des Herausgebers wird die [OTPublisherKitDelegate publisher:streamDestroyed:] Die Nachricht wird an den Publisher-Delegaten gesendet, nachdem das Streaming beendet wurde.

Angemeldet in

OTSession.h

Audio- und Videostreams abonnieren

`– subscribe:error:`

Verbindet diese Abonnenteninstanz mit der Sitzung und beginnt mit dem Abonnieren. Wenn der übergebene Abonnent aus einem OTStream Instanz aus einer anderen OTSession In diesem Fall ist das Verhalten dieser Funktion nicht definiert.

- (void)subscribe:(nonnull OTSubscriberKit *)subscriber error:(OTError *_Nullable *_Nullable)error

Parameter

subscriber Der Abonnent muss sich anmelden und das Abonnement starten.

error Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die OTSubscriberErrorCode Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die code Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt. Tritt ein asynchroner Fehler auf, wird die [OTSubscriberKitDelegate subscriber:didFailWithError:] Die Nachricht wird an den Beauftragten des Teilnehmers gesendet.


`subscriber`	Der Abonnent muss sich anmelden und das Abonnement starten.
`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTSubscriberErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt. Tritt ein asynchroner Fehler auf, wird die [OTSubscriberKitDelegate subscriber:didFailWithError:] Die Nachricht wird an den Beauftragten des Teilnehmers gesendet.

Angemeldet in

OTSession.h

`– unsubscribe:error:`

Trennt diese Teilnehmerinstanz von der Sitzung und leitet die Objektbereinigung ein.

- (void)unsubscribe:(nonnull OTSubscriberKit *)subscriber error:(OTError *_Nullable *_Nullable)error

Parameter


`subscriber`	Der Teilnehmer soll die Verbindung trennen und aus dieser Sitzung entfernt werden.
`error`	Wird gesetzt, wenn bei der Bearbeitung der Anfrage synchron ein Fehler auftritt. Die `OTSubscriberErrorCode` Die Enumeration (definiert in der Datei „OTError.h“) definiert Werte für die `code` Eigenschaft dieses Objekts. Dieses Objekt ist NULL, wenn kein Fehler auftritt.

Angemeldet in

OTSession.h

Senden und Empfangen von Signalen in einer Sitzung

`– signalWithType:string:connection:error:`

Sendet ein Signal an einen oder mehrere Clients in einer Sitzung.

- (void)signalWithType:(NSString *_Nullable)type string:(NSString *_Nullable)string connection:(OTConnection *_Nullable)connection error:(OTError *_Nullable *_Nullable)error

Parameter


`type`	Der Typ des Signals. Der Typ wird ebenfalls in der [OTSessionDelegate session:receivedSignalType:fromConnection:withString:] Meldung. Die maximale Länge der Zeichenfolge beträgt 128 Zeichen; sie darf ausschließlich Buchstaben (A–Z und a–z), Numbers (0–9) sowie die Zeichen „-“, „_“ und „~“ enthalten.
`string`	Die zu sendenden Daten. Die maximale Datengröße beträgt 8 KB.
`connection`	Ein OTConnection-Zielobjekt. Setzen Sie diesen Parameter auf „nil“, um alle Teilnehmer der Sitzung zu benachrichtigen.
`error`	Wenn das Senden eines Signals fehlschlägt, wird dieser Wert auf ein OTError-Objekt gesetzt. Die Enumeration OTSessionErrorCode (in OTError.h) enthält für diese Fehler die Konstanten OTSessionInvalidSignalType und OTSessionSignalDataTooLong. Beachten Sie, dass ein erfolgreicher Abschluss bedeutet, dass die an die Methode übergebenen Optionen gültig sind und das Signal gesendet wurde. Er bedeutet jedoch nicht, dass das Signal von einem der vorgesehenen Empfänger erfolgreich empfangen wurde.

Diskussion

Siehe [OTSession signalWithType:string:connection:retryAfterReconnect:error:] und [OTSessionDelegate session:receivedSignalType:fromConnection:withString:].

Angemeldet in

OTSession.h

`– signalWithType:string:connection:retryAfterReconnect:error:`

Sendet ein Signal an einen oder mehrere Clients in einer Sitzung. Diese Version der Methode enthält eine retryAfterReconnect Parameter.

- (void)signalWithType:(NSString *_Nullable)type string:(NSString *_Nullable)string connection:(OTConnection *_Nullable)connection retryAfterReconnect:(BOOL)retryAfterReconnect error:(OTError *_Nullable *_Nullable)error

Parameter


`type`	Der Typ des Signals. Der Typ wird ebenfalls in der [OTSessionDelegate session:receivedSignalType:fromConnection:withString:] Meldung. Die maximale Länge der Zeichenfolge beträgt 128 Zeichen; sie darf ausschließlich Buchstaben (A–Z und a–z), Numbers (0–9) sowie die Zeichen „-“, „_“ und „~“ enthalten. Siehe [OTSession signalWithType:string:connection:retryAfterReconnect:error:], [OTSessionDelegate session:receivedSignalType:fromConnection:withString:]und [OTSessionDelegate sessionDidBeginReconnecting:].
`string`	Die zu sendenden Daten. Die maximale Datengröße beträgt 8 KB.
`connection`	Ein OTConnection-Zielobjekt. Setzen Sie diesen Parameter auf „nil“, um alle Teilnehmer der Sitzung zu benachrichtigen.
`retryAfterReconnect`	Bei der Wiederherstellung der Verbindung zur Sitzung: Soll die Übertragung von Signalen fortgesetzt werden, die während der Unterbrechung der Verbindung ausgelöst wurden? Wenn Ihr Client aufgrund einer Unterbrechung der Netzwerkverbindung die Verbindung zur OpenTok-Sitzung verliert, versucht der Client, die Verbindung zur Sitzung wiederherzustellen, und die [OTSessionDelegate sessionDidBeginReconnecting:] Die Nachricht wird gesendet. Standardmäßig werden Signale, die während einer Unterbrechung der Verbindung ausgelöst wurden, gesendet, sobald (und falls) der Client die Verbindung zur OpenTok-Sitzung wiederherstellt. Sie können dies verhindern, indem Sie die `retryAfterReconnect` Parameter zu `false`. (Der Standardwert ist `true`.)
`error`	Wenn das Senden eines Signals fehlschlägt, wird dieser Wert auf ein OTError-Objekt gesetzt. Die Enumeration OTSessionErrorCode (in OTError.h) enthält für diese Fehler die Konstanten OTSessionInvalidSignalType und OTSessionSignalDataTooLong. Beachten Sie, dass ein erfolgreicher Abschluss bedeutet, dass die an die Methode übergebenen Optionen gültig sind und das Signal gesendet wurde. Er bedeutet jedoch nicht, dass das Signal von einem der vorgesehenen Empfänger erfolgreich empfangen wurde.

Angemeldet in

OTSession.h

Streams zwangsweise stummschalten

`– forceMuteAll:error:`

Zwingt alle Sender in der Sitzung (mit Ausnahme derjenigen, die ausgeschlossene Streams übertragen) dazu, den Ton stummzuschalten.

- (void)forceMuteAll:(NSArray<OTStream*> *_Nullable)excludedStreams error:(OTError *_Nullable *_Nullable)error

Parameter


`excludedStreams`	Streams, die von der Stummschaltanforderung ausgenommen werden sollen. Setzen Sie diesen Wert auf null, um alle Streams in der Sitzung stummzuschalten (einschließlich der vom lokalen Client veröffentlichten).
`error`	Wenn die Aktion fehlschlägt, wird dieser Wert auf ein OTError-Objekt gesetzt. Beachten Sie, dass ein Erfolg bedeutet, dass die an die Methode übergebenen Optionen gültig sind und die Anforderung zum Stummschalten der Streams gesendet wurde. Dies bedeutet jedoch nicht, dass die Anforderung von den Ziel-Clients erfolgreich umgesetzt wurde.

Diskussion

Außerdem werden alle Streams, die nach dem Aufruf der Funktion [OTSession forceMuteAll:error:] Methode werden mit stummgeschaltetem Ton veröffentlicht. Sie können den Stummschaltstatus einer Sitzung aufheben, indem Sie die [OTSession disableForceMute:] Methode. Nachdem Sie die [OTSession disableForceMute:] Mit dieser Methode wird bei neuen Streams, die in der Sitzung veröffentlicht werden, der Ton nicht mehr stummgeschaltet.

Durch den Aufruf dieser Methode wird die Nachricht an jeden mit der Sitzung verbundenen Client gesendet, wobei die active Eigenschaft der muteForcedInfo Objekt gesetzt auf YES.

Prüfen Sie die canForceMute Eigenschaft der [OTSession-Funktionen] Objekt, um zu prüfen, ob Sie diese Funktion erfolgreich aufrufen können. Dies ist für Clients reserviert, die sich mit einem Token verbunden haben, dem die Moderatorenrolle zugewiesen wurde (siehe die Token – Überblick über die Erstellung).

Siehe [OTSession forceMuteStream:error:], [OTSession-Funktionen], [OTSessionDelegate session:muteForced:], [OTPublisherKitDelegate muteForced:]und Stummschalten des Tons von Streams in einer Sitzung.

Angemeldet in

OTSession.h

`– disableForceMute:`

Hebt den aktiven Stummschaltungsstatus der Sitzung auf. Nachdem Sie diese Methode aufgerufen haben, wird bei neuen Streams, die in der Sitzung veröffentlicht werden, der Ton nicht mehr stummgeschaltet.

- (void)disableForceMute:(OTError *_Nullable *_Nullable)error

Parameter


`error`	Wenn die Aktion fehlschlägt, wird hier ein OTError-Objekt gespeichert.

Diskussion

Nachdem Sie die [OTSession forceMuteAll:error:] Methode (oder ein Moderator in einem anderen Client löst einen Befehl aus, alle Streams stummzuschalten), werden alle Streams, die nach dem Moderationsbefehl veröffentlicht werden, mit stummgeschaltetem Ton veröffentlicht. Rufen Sie die disableForceMute() Methode zum Aufheben der Stummschaltung einer Sitzung (damit neu veröffentlichte Streams nicht automatisch stummgeschaltet werden).

Durch den Aufruf dieser Methode wird die Nachricht an jeden mit der Sitzung verbundenen Client gesendet, wobei die active Eigenschaft der muteForcedInfo Objekt gesetzt auf NO.

Siehe [OTSession forceMuteAll:error:], [OTSession-Funktionen], [OTSessionDelegate session:muteForced:]und Stummschalten des Tons von Streams in einer Sitzung.

Angemeldet in

OTSession.h

`– forceMuteStream:error:`

Zwingt den Anbieter eines bestimmten Streams dazu, dessen Ton stummzuschalten.

- (void)forceMuteStream:(nonnull OTStream *)stream error:(OTError *_Nullable *_Nullable)error

Parameter


`stream`	Der Stream, der stummgeschaltet werden soll.
`error`	Wenn die Aktion fehlschlägt, wird dieser Wert auf ein OTError-Objekt gesetzt. Beachten Sie, dass ein Erfolg bedeutet, dass die an die Methode übergebenen Optionen gültig sind und die Anforderung zum Stummschalten der Streams gesendet wurde. Dies bedeutet jedoch nicht, dass die Anforderung von den Ziel-Clients erfolgreich umgesetzt wurde.

Diskussion

Siehe [OTSession forceMuteAll:error:], [OTSession-Funktionen], [OTSessionDelegate session:muteForced:], [OTPublisherKitDelegate muteForced:]und Stummschalten des Tons von Streams in einer Sitzung.

Angemeldet in

OTSession.h

Erzwingen von Verbindungsabbrüchen bei Kunden

`– forceDisconnect:error:`

Zwingt einen Client, die Verbindung zur Sitzung zu trennen.

- (void)forceDisconnect:(OTConnection *_Nullable)connection error:(OTError *_Nullable *_Nullable)error

Parameter


`connection`	Die OTConnection zum Trennen der Verbindung.
`error`	Wenn die erzwungene Trennung fehlschlägt, wird dieser Wert auf ein OTError-Objekt gesetzt. Die Enumeration „OTSessionErrorCode“ (in OTError.h) enthält für diese Fehler den Eintrag „OTSessionUnableToForceDisconnect“.

Diskussion

Sie können zwar die [OTSession forceDisconnect:error:] Methode zum Beenden der eigenen Verbindung durch Aufruf der [OTSession-Verbindung unterbrochen:] Die Methode ist einfacher. Es wird ein Fehler zurückgegeben, wenn die Rolle des Clients nicht über die erforderlichen Berechtigungen verfügt, um andere Benutzer zur Trennung der Verbindung zu zwingen. Die Rolle eines Clients legen Sie beim Erstellen des Benutzer-Tokens fest. Wenn eine Verbindung mithilfe dieser Methode beendet wird, [OTSessionDelegate sessionDidDisconnect:], [OTSessionDelegate session:connectionDestroyed:] und [OTPublisherKitDelegate publisher:streamDestroyed:] Nachrichten werden auf dieselbe Weise versendet, als hätte sich die Verbindung selbst beendet, und zwar mithilfe von [OTSession-Verbindung unterbrochen:]

Angemeldet in

OTSession.h

Meldung eines Problems

`– reportIssue:`

Melden Sie, dass bei Ihrer App ein Problem aufgetreten ist. Sie können die Problem-ID mit der Inspektor oder wenn Sie ein Problem mit dem Support-Team der Vonage Video API besprechen.

- (void)reportIssue:(NSString *_Nullable *_Nullable)issueId

Parameter


`issueId`	Ein Zeiger auf eine Zeichenkette, die als eindeutige Kennung für das gemeldete Problem festgelegt wird. Wenn der Aufruf der Methode fehlschlägt (beispielsweise aufgrund einer fehlenden Netzwerkverbindung), wird dieser Wert auf „nil“ gesetzt.

Angemeldet in

OTSession.h

`– setEncryptionSecret:error:`

Legt den Schlüssel für die End-to-End-Verschlüsselung fest, der von allen Herausgebern und Abonnenten verwendet wird.

- (void)setEncryptionSecret:(nonnull NSString *)secret error:(OTError *_Nullable *_Nullable)error

Parameter


`secret`	Wert des Verschlüsselungsschlüssels.
`error`	Wenn die Aktion fehlschlägt, wird dieser Parameter auf ein OTError-Objekt gesetzt.

Diskussion

Siehe die End-to-End- Verschlüsselung Leitfaden für Entwickler.

Angemeldet in

OTSession.h