Erstellen Sie Ihre Applikation, Benutzer und Token

Um das Client SDK nutzen zu können, müssen Sie drei Dinge einrichten, bevor Sie loslegen können:

  • Vonage Anwendung - eine Application, die die Konfiguration für die App enthält, die Sie bauen.
  • Benutzer - Ein Benutzer ist ein Objekt, das einen eindeutigen Vonage-Benutzer im Kontext einer Vonage-Applikation identifiziert und als Endpunkt für die Kommunikation angesehen werden kann. Vonage ermöglicht es diesen Benutzerinstanzen, miteinander zu kommunizieren.
    • Ein Benutzer hat normalerweise eine 1:1-Zuordnung zu einem Benutzer in der Benutzerdatenbank Ihrer Anwendung.
    • Für eine Person, die über eine Konversation kommunizieren will, muss zunächst ein Benutzerobjekt erstellt werden. Bei der Erstellung des Benutzerobjekts wird ihm eine eindeutige Benutzer-ID zugewiesen.
  • JSON-Web-Token, JWTs - Client SDK verwendet JWTs zur Authentifizierung. Damit sich ein Benutzer anmelden und die SDK-Funktionen nutzen kann, müssen Sie für jeden Benutzer ein JWT bereitstellen. JWTs enthalten alle Informationen, die die Vonage Plattform benötigt, um Anfragen zu authentifizieren, sowie Informationen wie die zugehörigen Applications, Benutzer und Berechtigungen.

All diese können sein erstellt von Ihrem Backend. Wenn Sie sofort loslegen und Erfahrungen SDK sofort nutzen möchten, können Sie auch eine Backend-Anwendung zur Verwendung mit dem Client SDK mit dem Client SDK Beispiel Server-Vorlage. Andernfalls zeigt Ihnen dieses Tutorial, wie Sie dies mit Hilfe des Vonage CLI.

Voraussetzungen

Vergewissern Sie sich, dass Sie die folgenden Informationen haben:

Erstellen einer Vonage-Applikation

Sie müssen nun eine Vonage-Anwendung erstellen. In diesem Beispiel erstellen Sie eine Anwendung, die den Anwendungsfall In-App Voice verarbeiten kann.

  1. Erstellen Sie zunächst Ihr Projektverzeichnis, falls Sie dies noch nicht getan haben.
  2. Wechseln Sie in das Projektverzeichnis, das Sie jetzt erstellt haben.
  3. Verwenden Sie die folgenden Befehle zum Erstellen und Konfigurieren einer Vonage-Applikation mit Sprach- und WebRTC-Funktionen. Ersetzen Sie Sie die Webhook-URLs durch Ihre eigenen. Wenn Ihre Plattform den eingehenden Datenverkehr, den sie empfangen kann, durch IP Adressbereiche einschränkt, müssen Sie die Vonage IP-Adressen zu Ihrer Zulassungsliste hinzufügen. Die IP-Adressen können programmatisch abgerufen werden, indem Sie eine GET-Anfrage an https://api.nexmo.com/ips-v4.

Sprachfähigkeiten hinzufügen:

RTC-Funktionen hinzufügen

Anschließend wird die Anwendung erstellt. Eine private Schlüsseldatei private.key wird ebenfalls erstellt.

Das Erstellen einer Anwendung und die Anwendungsmöglichkeiten werden im Detail in der Applikationsleitfaden.

Einen Benutzer erstellen

Erstellen Sie einen Benutzer, der sich beim Vonage Client SDK anmeldet und an den SDK-Funktionen teilnimmt: Konversationen, Anrufe und so weiter.

Führen Sie den folgenden Befehl in Ihrem Terminal aus, um einen Benutzer namens Alice zu erstellen:

Die Benutzer-ID wird für die Durchführung von Aufgaben durch das SDK verwendet, z. B. für die Anmeldung, das Starten eines Anrufs und mehr.

Erzeugen eines Benutzer-JWTs

JWTs werden verwendet, um einen Benutzer beim Client SDK zu authentifizieren.

Um ein JWT für Alice zu generieren, führen Sie den folgenden Befehl aus (ersetzen Sie ihn durch Ihre Informationen):

Mit dem obigen Befehl wird der Ablauf des JWT standardmäßig auf 24 Stunden festgelegt. Sie können den Ablauf auf eine kürzere Zeitspanne ändern Zeit ändern, indem Sie die --exp Flagge.

ANMERKUNG: In produktiven Anwendungen wird erwartet, dass Ihr Backend einen Endpunkt bereitstellt, der JWT für Ihre Client-Anfrage generiert.

Weitere Informationen