Erstellen einer Sitzung — Node.js

Sie können die OpenTok-Node.js-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

Der folgende Node.js-Code erstellt eine Sitzung, die den OpenTok Media Router nutzt:

var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"routed"}, function(error, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

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 generateToken() Methode.

Die OpenTok Media Router bietet die folgenden Vorteile:

Der OpenTok Media Router kann den Bandbreitenverbrauch bei Mehrparteien-Sitzungen senken. (Wenn die Eigenschaft „mediaMode“ auf „MediaMode.RELAYED“ gesetzt ist, muss jeder Client einen separaten Audio-Video-Stream an jeden Client 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 Node.js-Beispielcode, der eine neue Sitzung mit dem Medienbetrieb auf „Relayed“ gesetzt:

var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"relayed"}, function(error, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

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 Beispielcode in Node, der eine automatisch archivierte Sitzung erstellt:

opentok.createSession({mediaMode:'routed', archiveMode:'always'}, function(err, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

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.