Sitzungen verwalten

Sessions sind ein integraler Bestandteil der Vonage Client SDKs. Eine Sitzung ist ein Live-Kommunikationsstrom zwischen dem Client SDK und den Vonage-Servern.

Erstellen einer Sitzung

Um mit dem Vonage Client SDK Anrufe tätigen oder empfangen zu können, müssen Sie eine Sitzung erstellen. Eine Voraussetzung für die Erstellung einer Sitzung ist, dass Sie einen Benutzer und ein JWT für diesen Benutzer haben. Mehr über Benutzer und JWTs erfahren Sie in der Erstellen Sie Ihre Applikation Anleitung. Sobald Sie einen Benutzer und das zugehörige JWT haben, können Sie die createSession Funktion auf dem SDK. Die Beispiele in diesem Leitfaden sind in JavaScript, aber die Funktionsnamen sind für alle 3 Plattformen gleich.

client.createSession(jwt)
 .then(sessionId => {
    console.log("Id of created session: ", sessionId);
 })
 .catch(error => {
    console.error("Error creating session: ", error);
 });

Bei Erfolg erhalten Sie eine Sitzungs-ID. Damit können Sie bei Bedarf erneut eine Verbindung zu dieser speziellen Sitzung herstellen. Sitzungen haben eine TTL von 15 Minuten.

Wiederaufnahme einer Sitzung

Wenn Sie die Verbindung zu einer bestehenden Sitzung wiederherstellen möchten, müssen Sie die createSession nimmt optional eine Sitzungs-ID als Parameter an.

client.createSession(jwt, existingSessionId)
 .then(sessionId => {
    console.log("Id of session: ", sessionId);
 })
 .catch(error => {
    console.error("Error: ", error);
 });

Fehlerbehebung bei der Erstellung von Sitzungen

Wenn Sie eine Sitzung nicht erfolgreich erstellen können, gibt Ihnen die zurückgegebene Fehlermeldung Aufschluss über das Problem. Hier sind einige allgemeine Schritte zur Fehlerbehebung

  1. Überprüfen Sie die Existenz des Vonage-Benutzers, indem Sie eine GET-Anfrage an die Benutzer-API
  2. Wenn der Benutzer existiert, vergewissern Sie sich, dass er sich in der gleichen Region mit dem das Vonage Client SDK versucht, eine Verbindung herzustellen. Die user._links Objekt aus dem Users API-Aufruf wird die Region des Benutzers aufgelistet.
  3. Geben Sie Ihr JWT in jwt.io um sicherzustellen, dass das JWT den richtigen Benutzernamen auf der sub Anspruch und ist nicht abgelaufen. Hier können Sie auch überprüfen, ob die ACL-Pfade korrekt sind und das Objekt die richtige Verschachtelung aufweist.

Auffrischen einer Sitzung

Wenn Sie derzeit eine aktive Sitzung haben und wissen, dass das zur Erstellung der Sitzung verwendete JWT bald abläuft, können Sie die Sitzung mit einem neuen JWT aktualisieren.

client.refreshSession(jwt)
 .then(() => {
    console.log("Session refreshed");
 })
 .catch(error => {
    console.error("Error refreshing session: ", error);
 });

Löschen einer Sitzung

Sie können eine Sitzung auch löschen. Sie würden dies zum Beispiel als Teil eines Abmeldevorgangs tun.

client.deleteSession(jwt)
 .then(() => {
    console.log("Session deleted");
 })
 .catch(error => {
    console.error("Error deleting session: ", error);
 });

Haben Sie Fragen?

Sollten Sie weitere Fragen, Probleme oder Feedback haben, kontaktieren Sie uns bitte unter devrel@vonage.com oder die Vonage Entwickler-Community Slack.