Erstellen einer Sitzung — Python

Sie können die OpenTok-Python-Bibliothek verwenden, um OpenTok-Sitzungen zu erstellen. Jede Sitzung verfügt über eine eindeutige Sitzungs-ID, die Sie in einer OpenTok-Client-Bibliothek verwenden können, um eine Verbindung zu einer OpenTok-Sitzung herzustellen. (Siehe „An einer Sitzung teilnehmen“ für Web, iOS, oder Android.)

Erstellen einer Sitzung, die den OpenTok Media Router nutzt

Die folgende Code-Session, in der der OpenTok Media Router verwendet wird:

import OpenTok

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)
session = opentok_sdk.create_session(media_mode=MediaModes.routed)
print session.session_id

Verwenden Sie die Sitzungs-ID in einer OpenTok-Client-Bibliothek, um eine Verbindung zu einer OpenTok-Sitzung herzustellen.

Außerdem müssen Sie für jeden Benutzer, der eine Verbindung zur OpenTok-Sitzung herstellt, ein Token generieren. Siehe Erstellung eines Verbindungstokens Informationen zu den generate_token() Methode.

Die OpenTok Media Router bietet die folgenden Vorteile:

Der OpenTok Media Router kann den Bandbreitenverbrauch in Sitzungen mit mehreren Teilnehmern senken. (In einer weitergeleiteten Sitzung muss jeder Client einen separaten Audio-Video-Stream an jeden Teilnehmer senden, der diesen abonniert hat.)
Der OpenTok Media Router kann die Qualität des Nutzererlebnisses verbessern durch Audio-Fallback und Video-Wiederherstellung. Dank dieser Funktionen wird das Video auf einem Client unterbrochen (ohne dass andere Clients davon betroffen sind), wenn sich die Verbindung des Clients so weit verschlechtert, dass sie die Wiedergabe des Videos für einen abonnierten Stream nicht mehr unterstützt; der Client empfängt dann nur noch Audio. Verbessert sich die Verbindung des Clients wieder, wird das Video wieder angezeigt.
Der OpenTok Media Router unterstützt die Archivierungsfunktion, mit dem Sie OpenTok-Sitzungen aufzeichnen, speichern und abrufen können.

Erstellen einer weitergeleiteten Sitzung

Hier ist ein Python-Beispielcode, der eine neue Sitzung mit dem Medienbetrieb auf „Relayed“ gesetzt:

import OpenTok

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)

session = opentok_sdk.create_session()
print session.session_id

Bei einer weitergeleiteten Sitzung versuchen die Clients, Streams direkt untereinander auszutauschen. Wenn die Clients jedoch aufgrund von Firewall-Einschränkungen keine Verbindung herstellen können, nutzt die Sitzung den OpenTok-TURN-Server, um Audio- und Videostreams weiterzuleiten.

Das ist wichtig: Einige Funktionen, wie beispielsweise die Archivierung, stehen nur in gerouteten (nicht weitergeleiteten) Sitzungen zur Verfügung. Anweisungen zum Erstellen einer gerouteten Sitzung finden Sie im vorherigen Abschnitt.

Erstellen einer automatisch archivierten Sitzung

Sie können eine Sitzung erstellen, die automatisch archiviert wird. Hier ist ein Python-Beispielcode, der eine automatisch archivierte Sitzung erstellt:

import OpenTok

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)

session = opentok.create_session(media_mode=MediaModes.routed, archive_mode=ArchiveModes.always)
print session.session_id

Beachten Sie, dass archivierte Sitzungen im „Routed Media“-Modus stattfinden müssen.

Weitere Informationen finden Sie in der Archivierung Leitfaden für Entwickler.

Verwendung von Sitzungen in Client-Applikationen

Verwenden Sie die Sitzungs-ID in einem OpenTok-Client SDK um eine Verbindung zu einer OpenTok-Sitzung herzustellen.