Web Client SDK

Wichtig
Aktualisiertes Web SDK. Sie wird jetzt von https://video.standard.vonage.com/v2/js/opentok.min.js. In Safari 15.4 und 15.5 behobene Probleme. Die Safari-Versionen 15.4 und 15.5 (die mit iOS 15.4 und 15.5 und macOS 12.3 und 12.4 ausgeliefert werden) beheben die folgenden Probleme, die sich auf Apps auswirken können, die OpenTok.js (in Safari) verwenden:
Audioprobleme bei der Verwendung bestimmter Modelle von Bluetooth-Headsets. Bei bestimmten Modellen von Bluetooth-Headsets kann es zu Tonausfällen kommen. Dies WebKit-Fehler ist in Safari 15.4 behoben.
Echo-Probleme beim Umschalten von Mikrofonen in macOS Safari. Der Wechsel des Mikrofons, das von einem Herausgeber verwendet wird, konnte zu einem Echo des Herausgebers führen. Auf der Seite des Teilnehmers trat das Echo nicht auf. Dies WebKit-Fehler ist in Safari 15.5 behoben.
Kritischer Fehler bei der Veröffentlichung von H.264-Videos in gerouteten Sitzungen in iOS 15.1. In iOS 15.1 schlägt die Veröffentlichung von H.264-Videos in gerouteten Sitzungen fehl. Dies WebKit-Fehler wurde in Safari 15.4 behoben. Geringe Audio-Lautstärke ist iOS Safari. Diese WebKit-Fehler ist in Safari 15.4 behoben.

Ende-zu-Ende-Verschlüsselung: In OpenTok.js 2.27.0 funktioniert die Ende-zu-Ende-Verschlüsselung nicht mit Clients, die frühere Versionen von OpenTok.js verwenden. Wenn Sie Ihre Anwendung aktualisieren um OpenTok.js 2.27.0+ zu verwenden, stellen Sie sicher, dass alle Clients OpenTok.js 2.27.0+ verwenden wenn die Anwendung eine Ende-zu-Ende-Verschlüsselung verwendet.

Übersicht

Alle Applikationen, die die Vonage Video API nutzen, bestehen aus zwei Teilen:

  • Die Client-Seite, die die Vonage Video-Client-SDKs verwendet und im Browser oder in der mobilen Anwendung des Benutzers läuft
  • Die Serverseite, die die Vonage Video-Server-SDKs und läuft auf Ihrem Server, um Authentifizierungsinformationen an den Client weiterzugeben

Das Client SDK zur Erstellung webbasierter Applikationen, die die Vonage Video API nutzen, ist OpenTok.js. Diese JavaScript-Bibliothek bietet die meisten der Kernfunktionen für Ihre Anwendung, einschließlich:

  • Verbinden mit einer Sitzung
  • Veröffentlichen von Streams in einer Sitzung
  • Abonnieren von Streams in einer Sitzung

Alle Vonage Video-Client-SDKs werden miteinander interagieren können. Mehr über die Grundlagen von Vonage Video Clients, Servern, Sessions und mehr erfahren Sie auf unserer Video API Übersicht Seite.

Die Vonage Video API Web SDK-Referenz finden Sie hier hier.

OpenTok.js laden

Um OpenTok.js in Ihre Webseite zu laden, fügen Sie das folgende Skript-Tag hinzu:

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

Sie können OpenTok.js auch mit dem @vonage/client-sdk-video npm-Paket.

Besuchen Sie die Referenzhandbuch um alle für das OpenTok.js SDK verfügbaren Methoden zu sehen.

Die aktuelle Version der OpenTok.js-Bibliothek kann mit Vonage Video-Anwendungen interagieren, die mit Version 2.30+ des Vonage Video Client SDKs geschrieben wurden:

  • OpenTok.js (Web)
  • Android-SDK
  • iOS-SDK
  • Windows-SDK
  • macOS-SDK
  • Linux-SDK
  • React Native SDK

Browser-Unterstützung

Die OpenTok.js-Bibliothek wird derzeit unterstützt in:

  • Google Chrome (neueste Version)
  • Google Chrome für Android (neueste Version)
  • Beta-Unterstützung für Google Chrome für iOS (neueste Version)
  • Firefox (neueste Version)
  • Firefox für Android (neueste Version)
  • Beta-Unterstützung für Firefox für iOS (neueste Version)
  • Microsoft Edge Versionen 79+ für Windows und macOS (Chromium-basierte Versionen von Edge)
  • Safari 11+ auf macOS und iOS. Informationen zur Video-Interoperabilität und anderen Problemen finden Sie in der Safari-Browser-Unterstützung Seite.
  • Opera (nur die neueste Version der Desktop-Version)
  • Electron (neueste Version)
  • Samsung Internet (neueste Version)
  • WebView Android API Stufe 36+
  • WebView unter iOS 18.6+

Safari-Unterstützung

Apple hat die Unterstützung für WebRTC in Safari 11 für macOS und Safari auf iOS 11 hinzugefügt, und Sie können jetzt OpenTok.js-Apps in Safari verwenden.

Darüber hinaus unterstützt Safari 12.1 zusätzlich zu H.264 auch den VP8-Videocodec. Die VP8-Unterstützung in Safari 12.1 wird mit macOS 10.14.4 ausgeliefert und ist auch für macOS 10.13.6 und 10.12.6 verfügbar. Und sie ist in der neuesten Version von iOS 12.2 verfügbar.

Sie müssen Version 2.16.0 oder höher von OpenTok.js verwenden, um den VP8-Videocodec in Safari zu nutzen.

Weitere Informationen zur Unterstützung von Videocodecs finden Sie hier Entwicklerhandbuch.

Beschränkungen

Die folgenden Einschränkungen gelten für OpenTok.js in Safari:

  • Das Veröffentlichen von Videos zur Bildschirmfreigabe wird in Safari unter iOS und in Safari 12 und älter unter macOS nicht unterstützt. Es wird in Safari 13+ unter macOS unterstützt.
  • Safari unterstützt keinen Kamerazugriff (oder Stream-Publishing) in Seiten, die über die URI-Schemata http: (unsicher) oder file: (Dateisystem) geladen werden. Sie müssen die Seite über https: (sicher) bereitstellen. Sie können jedoch ein Flag setzen, um HTTP zu unterstützen (zum Testen).
  • Safari unterstützt den Kamerazugriff über localhost nicht. Sie müssen 0.0.0.0:xx verwenden (wobei xx die Portnummer ist, z. B. 80).
  • Die Ende-zu-Ende-Verschlüsselung kann in Safari nicht funktionieren, wenn die Entwicklerwerkzeuge geöffnet sind.

Ältere Versionen

Ältere Versionen von Safari verwenden ausschließlich den H.264-Videocodec und unterstützen daher den VP8-Videocodec nicht.

Unter weitergeleitete Sitzungen (Sitzungen, die den Media Router verwenden), müssen Sie ein Projekt verwenden, bei dem der bevorzugte Codec auf H.264 eingestellt ist, damit ältere Versionen von Safari Videos veröffentlichen und abonnieren können. Legen Sie den bevorzugten Videocodec für ein Projekt auf der Projektseite Ihres Video API Accounts fest.

In einem weitergeleitete Sitzung (eine Sitzung, die den OpenTok Media Router verwendet) in einem Projekt, bei dem der bevorzugte Videocodec auf VP8 (nicht H.264) eingestellt ist, können Clients, die ältere Versionen von Safari verwenden, die Vonage Videoplattform nutzen, jedoch ohne Videounterstützung.

Nummer der Version

Sie können die OpenTok.js-Bibliothek in Ihre Webseite einbinden, indem Sie eine <script> Tag:

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

Die Versionsnummer von OpenTok.js besteht aus drei Teilen:

  • Die Hauptversionsnummer - Diese Nummer (die erste Zahl) wird erhöht, wenn es eine neue Version gibt, die eine API-Änderung enthält, die nicht abwärtskompatibel ist.
  • Die Minor-Versionsnummer - Diese Nummer (die zweite Zahl) wird erhöht, wenn eine neue Version mit neuen Funktionen herauskommt.
  • Die Patch-Nummer - Diese Nummer (die dritte) wird erhöht, wenn es eine neue Version gibt, die Fehler behebt oder die Leistung verbessert, ohne neue Funktionen hinzuzufügen.

Zum Beispiel ist v2.4.0 die Hauptversion 2, die Nebenversion 4 (von Hauptversion 2) und die Revision 0 (von v2.4). Bei der Freigabe von Revisionsversionen werden die Änderungen in die Stamm-Nebenversion aufgenommen. Wenn zum Beispiel v2.2.3 veröffentlicht wird, werden die Änderungen in v2.2 aufgenommen.

Um auf eine bestimmte Version zu verweisen, können Sie die vollständige Versionsnummer (z. B. "v2.4.0") in die src Attribut. Wir empfehlen jedoch, dass Sie nur die Hauptversionsnummer angeben. Vonage unterstützt offiziell die aktuelle Version der Bibliothek. Wenn Sie eine ältere Version laden, bitten wir Sie, ein Upgrade durchzuführen, um die neuesten Fehlerbehebungen und Funktionen der Vonage Videoplattform zu nutzen.

Das ist wichtig: Verwenden Sie die von uns zur Verfügung gestellten Bibliotheken immer in unveränderter Form. Dadurch wird sichergestellt, dass Sie den neuesten, aktuellen und getesteten Code verwenden. Die Vonage Video API unterstützt die Verwendung von modifizierten Bibliotheken nicht.

Um zu erfahren, wann neue Versionen von OpenTok.js verfügbar sind, abonnieren Sie die Vonage Video API Ankündigungen Forum.