Übersicht

In dieser Anleitung erfahren Sie, wie Sie das Client SDK zu Ihrer clientseitigen JavaScript-Anwendung hinzufügen.

Voraussetzungen

Das Client SDK erfordert Node.js und NPM.

So fügen Sie das Client SDK zu Ihrem Projekt hinzu

Navigieren Sie zu Ihrer Anwendung

Öffnen Sie Ihr Terminal. Wenn Sie eine bestehende Anwendung haben, navigieren Sie zu deren Stammverzeichnis. Andernfalls erstellen Sie ein neues Verzeichnis für Ihr Projekt.

Fügen Sie das Client SDK zu Ihrem Projekt hinzu

Installieren Sie das Client SDK-Paket

Einen Standard hinzufügen package.json durch Laufen:

npm init -y

Installieren Sie das Client SDK mit npm:

npm install nexmo-client -s

Importieren Sie das Client SDK in Ihren Code

Wenn Ihre Anwendung die ES6-Modulsyntax verwendet, können Sie das Clientmodul am Anfang Ihres Anwendungscodes importieren:

import NexmoClient from 'nexmo-client';

Wenn Ihre Anwendung auf einer einzelnen Seite läuft, können Sie das Modul mit einem Skript-Tag in Ihr HTML laden:

Vergewissern Sie sich, dass der Pfad zu nexmoClient.js für Ihre Projektstruktur korrekt ist.

Laden Sie das Client SDK-Paket

Laden Sie das Client SDK von einem Content Delivery Network (CDN):

Im Inneren der <head> Ihrer HTML-Datei hinzufügen:

Fügen Sie das Client SDK in Ihren Code ein

Fügen Sie am Anfang Ihres Anwendungscodes etwas hinzu:

//********* Get a reference to NexmoClient **********
const NexmoClient = window.NexmoClient;

Verwendung des Client SDK in Ihrer Anwendung

Benutzer und JWTs erstellen

Ein JSON Web Token (JWT) ist erforderlich, um sich bei Ihrer Vonage Application anzumelden. Das Client SDK kann weder Benutzer verwalten noch JWTs generieren, daher müssen Sie eine Methode zur Handhabung im Backend wählen:

Für Einführungs- oder Testzwecke können Sie Ihre clientseitige Anwendung zum Laufen bringen, bevor Sie ein Backend einrichten, indem Sie Generierung eines Test-JWTs aus der Kommandozeile und in Ihrem clientseitigen JavaScript fest zu kodieren.
In der Praxis können Sie JWTs vom Server aus über die Node- oder PHP Backend-SDKsund setzen die jwt Variable in Ihrem Code, indem Sie diese Daten abrufen:
widgets.copy
```
fetch('/getJwt')
  .then(results => results.json())
  .then(data => {
    jwt = data.token;
  })
  .catch(err => console.log(err));
```
Lesen Sie mehr über die Erzeugung von JWTs in diesem Artikel

Instanziierung und Anmeldung des NexmoClient

Es sind keine Argumente erforderlich, um eine neue NexmoClientaber Sie müssen Ihr JWT als Argument an createSession().

let nexmo = new NexmoClient()
  .createSession(jwt)
  .then(app => console.log('Logged in to app', app))
  .catch(err => console.log(err));

Client SDK-Analysen und Nutzungsdaten

Um Vonage mehr Informationen zur Verfügung zu stellen, damit wir Fehler beheben und Funktionen entwickeln können, können Sie wahlweise sich für unser Client SDK-Analyse- und Nutzungsdatenprogramm anmelden.

Um Analysen und Berichte zur Datennutzung zu ermöglichen, setzen Sie bitte die enabled Parameter von log_reporter zu true. Der folgende Code ist ein Beispiel dafür:

new NexmoClient({debug:true, log_reporter: {enabled: true}})

HINWEIS: Diese Funktion ist nur auf freiwilliger Basis verfügbar und ist standardmäßig deaktiviert.

Schlussfolgerung

Sie haben das Client SDK zu Ihrer Client-seitigen JavaScript-Anwendung hinzugefügt und sich bei einer NexmoClient Instanz, die eine Application Objekt. Sie können nun Application.newConversation() um eine Konversation zu erstellen, und dann auf die Funktionen einer Conversation.

Siehe auch

Konfiguration des Rechenzentrums - Dies ist eine erweiterte optionale Konfiguration, die Sie nach dem Hinzufügen des SDK zu Ihrer Anwendung vornehmen können.

Navigation