Best Practices für den Einstieg in Vonage Video

In diesem Leitfaden werden einige Best Practices für den Einstieg in die Vonage Video API beschrieben. Dabei werden Themen wie die Konfiguration Ihrer Umgebung, die Gewährleistung einer guten Benutzererfahrung sowie Sicherheit und Datenschutz behandelt.

Was ist die Video API?

Vonage Video nutzt webRTC für die Audio-Video-Kommunikation und besteht aus Client-Bibliotheken für Web, iOS, Android, React Native, Windowsund Linuxsowie Server-SDKs und REST-APIs. Schlüsselbegriffe:

  • Die Video API-Plattform verwendet Token für die Autorisierung, d. h. Sie müssen sich nicht um die Erstellung von Benutzern auf der Plattform kümmern; diese können bei Bedarf von der Anwendung erstellt werden.
  • Sitzung: Eine Sitzung ist eine logische Gruppe von Verbindungen und Datenströmen. Verbindungen innerhalb der gleichen Sitzung können Nachrichten austauschen. Stellen Sie sich eine Sitzung als den "virtuellen Raum" vor, in dem die Teilnehmer miteinander interagieren können. Sitzungen sollten nicht wiederverwendet werden, da dies die Fehlersuche erschwert und Ihre Implementierung möglicherweise weniger sicher macht.
  • VerbindungVerbindung: ist ein Endpunkt, der an einer Sitzung teilnimmt und in der Lage ist, Nachrichten zu senden und zu empfangen. Eine Verbindung hat eine Präsenz, sie ist entweder verbunden und kann Nachrichten empfangen, oder sie ist getrennt.
  • Stream: Medienstrom zwischen zwei Verbindungen. Dies bedeutet, dass tatsächlich Bytes mit Medien ausgetauscht werden. Die Medien können nur aus Audio oder aus Audio und Video bestehen. Sie können auch Bildschirmfreigaben und benutzerdefinierte Streams erstellen.
  • Herausgeber: Kunden, die Medienströme veröffentlichen.
  • Abonnent: Clients, die Medienströme empfangen.

Weitere Informationen über die Video API finden Sie auf der Seite Technische Details Seite, und eine ausführliche Anleitung für die Nutzung der Video API finden Sie unter Erste Schritte.

Bewährte Praktiken für Projekte und Server

Einrichten Ihrer Umgebung

Wenn Sie eine Videoanwendung entwerfen, sollten Sie zwei Umgebungen in Betracht ziehen: eine zum Testen und eine für die Produktion. Um einfache Elemente zu testen oder Probleme zu reproduzieren, können Sie auch unseren Spielplatz verwenden, der unten verlinkt ist:

  1. Erstellen Sie eine Anwendung für jede Umgebung, z. B. Entwicklung und Produktion.
  2. Spielplatz

Verständnis für die Versionierung von API (und SDK)

Für Kunden der Enterprise-Umgebung ist es wichtig zu wissen, dass neu erstellte Applications standardmäßig in der Standard-Umgebung erstellt werden. Wenn Sie Ihre Umgebung von Standard auf Enterprise umstellen müssen, können Sie dies in Ihrer Applikationseinstellungen.

Um sicherzustellen, dass Ihre Anwendung das Enterprise JS SDK aufruft, verwenden Sie source = https://video.enterprise.vonage.com/v2/js/opentok.js um sicherzustellen, dass Sie langfristigen Support für Ihre SDKs erhalten.

Für weitere Informationen besuchen Sie die Leitfaden für die Unternehmensumgebung.

Bewährte Verfahren für die Einrichtung Ihrer Account-Zugangsdaten

Beachten Sie diese Richtlinien bei der Erstellung Ihrer Account-Anmeldedaten:

Application ID und privater Schlüssel

  • Vonage Video verwendet nicht den Account-API-Schlüssel und -Geheimnis, sondern verlässt sich auf die Verwendung einer Vonage Applikation.
  • Halten Sie den privaten Schlüssel geheim, indem Sie ihn NICHT in öffentlichen Repos offenlegen.
  • Speichern Sie den privaten Schlüssel NICHT in Client-Bibliotheken/kompilierten mobilen SDKs.
  • Führen Sie keine REST-API-Aufrufe von den Client-Anwendungen oder mobilen Anwendungen aus. Dies würde Ihren privaten Schlüssel offenlegen und Ihr Konto angreifbar machen. Nur die Application ID sollte als öffentliche Information betrachtet werden.

Sitzungs-ID

  • Erzeugen Sie immer eine neue sessionId für jede neu erstellte Sitzung.
  • Die Qualitätsbewertungen und Daten der Sitzungen werden indiziert durch sessionId. Wenn es mehrere Gespräche (Sitzungen) pro sessionIdwird es schwierig sein, die Fehlerbehebung mit Vonages Inspektionswerkzeug, weil wiederverwendet sessionIdDie von den Betreibern gemeldeten Gesamtqualitätswerte sind in der Regel niedriger als die von den Endnutzern tatsächlich wahrgenommene Anrufqualität.

Wertmarken

  • Ihr Server, der die Token generiert, muss sich hinter einem gesicherten/authentifizierten Endpunkt befinden.
  • Erzeugen Sie für jeden Teilnehmer immer neue Token.
  • Token dürfen nicht aufbewahrt oder wiederverwendet werden.
  • Standardmäßig laufen die Token nach 24 Stunden ab, dies wird zum Zeitpunkt der Verbindung überprüft. Passen Sie die Gültigkeitsdauer je nach Anwendungsfall und Anwendung nach Bedarf an.
  • Fügen Sie den Token (unter Verwendung des Datenparameters) zusätzliche Informationen hinzu, z. B. Benutzernamen oder andere Informationen zur Identifizierung der Teilnehmer, aber verwenden Sie NIEMALS persönliche Informationen.
  • Legen Sie gegebenenfalls Rollen fest, z. B. Moderator, Herausgeber und Abonnent.
  • Weitere Informationen über Token finden Sie in der Token-Erstellung Übersicht.

Verstehen von Media Router und Media Modes

Wenn Sie eine Sitzung erstellen, legen Sie fest, wie die Clients in der Sitzung Audio- und Videoströme senden sollen, was als Medienmodus bezeichnet wird. Es gibt zwei Optionen: Relayed Mode oder Routed Mode:

Relayed Mode:

Bei diesem Medienmodus werden keine Vonage-Medienserver verwendet, sondern es wird versucht, eine direkte Medienverbindung zwischen den Teilnehmern herzustellen. Bevor Sie sich für den Relayed Mode entscheiden, sollten Sie folgende Punkte beachten:

  • Plattformfunktionen wie Archivierung (Aufzeichnung), SIP-Integration, Live-Streaming und Experience Composer werden nicht benötigt
  • dass der Anwendungsfall nur Eins-zu-Eins- und 3-Parteien-Sitzungen sind
  • Wenn direkte Medien zwischen den Teilnehmern bevorzugt werden
  • Eine Ende-zu-Ende-Verschlüsselung der Medien ist erforderlich

Beachten Sie, dass die Medienqualität im Relayed-Modus nicht verwaltet wird, da die Medien zwischen den Clients ausgetauscht werden. Daher funktioniert die Einstellung der Bildrate und/oder Auflösung des Teilnehmers nicht. Weitere Informationen über Token finden Sie in der Skalierbares Video Seite.

Gerouteter Modus:

Dieser Medienmodus verwendet Vonage-Medienserver. Bevor Sie entscheiden, ob Sie den gerouteten Modus verwenden möchten oder nicht, sollten Sie Folgendes prüfen:

  • dass Ihre Videositzungen drei oder mehr Teilnehmer haben werden
  • Möglicherweise müssen Sie archivieren
  • Erforderliche Medienqualitätskontrolle (Audio-Fallback und Video-Wiederherstellung)
  • Möglicherweise muss eine SIP-Zusammenschaltung verwendet werden
  • Möglicherweise besteht Bedarf an interaktiven oder Live-Streaming-Übertragungen
  • End-to-End-Verschlüsselung erfordert ein Add-on-Abonnement und wird nicht von allen SDKs unterstützt.

Weitere Informationen zu den Medienmodi finden Sie in der Übersicht über die Erstellung von Sitzungen.

Weitere Informationen zur Ende-zu-Ende-Verschlüsselung im Routed Mode finden Sie in der Ende-zu-Ende-Verschlüsselung Seite.

Adaptives Medien-Routing

Ab OpenTok.js v2.24.7 werden geroutete Sitzungen so optimiert, dass sie, wenn möglich, adaptives Media Routing verwenden. Adaptives Media Routing bestimmt, ob Medien ohne den Media Router für One-on-One-Video-Streaming weitergeleitet werden können, um die Medienleistung zwischen zwei Teilnehmern zu optimieren. Die geroutete Sitzung passt das Medien-Routing automatisch an, um den Media Router zu verwenden, wenn dies erforderlich ist - für Sitzungen mit drei oder mehr Teilnehmern, Archivierung, Live-Streaming-Übertragungen, SIP-Interconnect, Experience Composer und Audio Connector.

Audio-Fallback

Im gerouteten Modus fällt das Vonage SDK automatisch in den reinen Audiomodus zurück, wenn die Bandbreite für Videoanrufe zu gering ist. Wenn Sie dieses Verhalten jedoch außer Kraft setzen möchten, ist dies möglich, indem Sie audioFallback auf false über die OT.initPublisher.

Getstats-Methode

Zusätzlich zur Implementierung des oben erwähnten benutzerdefinierten Audio-Fallbacks, getStats() Die Abfrage kann dazu verwendet werden, Informationen über die Qualität der Verbindung zu erfassen, um dem Benutzer Echtzeitinformationen anzuzeigen und die Fehlerbehebung zu erleichtern.

Vonage Inspektor-Tool

Die Vonage Inspektor-Tool kann verwendet werden, um die Medienleistung während der Sitzung zu verstehen und um zu erfahren, welche Codecs, Modi (weitergeleitet oder geroutet), Ereignisse und erweiterten Funktionen während des Anrufs verwendet wurden.

Berichtausgabe Methode

Es ist möglich, Fehler zur späteren Überprüfung im Inspektor zu markieren. Die Website Problem-ID melden kann auch verwendet werden, um den Inspektor ohne Kenntnis der sessionId zu suchen.

Sendung

Die Video API bietet Nutzern zwei Möglichkeiten, Live-Videos für ein größeres Publikum zu veröffentlichen - eine interaktive Übertragung und eine Live-Streaming-Übertragung.

Interaktive Übertragung

Diese Art der Übertragung ermöglicht es den Kunden, miteinander zu interagieren, indem sie den Stream des anderen abonnieren. Es ist wichtig zu wissen, dass diese Art der Übertragung bis zu 15.000 Abonnenten in Full HD unterstützen kann. Im Folgenden finden Sie einige Punkte, die Sie bei der Verwendung dieser Übertragung beachten sollten:

  • Besuchen Sie Vonage Skalierbares Video-Simulcast um mehr über Simulcast zu erfahren. Standardmäßig wird Simulcast aktiviert, wenn die dritte Verbindung dem Anruf beitritt (um Simulcast bei Einzelgesprächen zu vermeiden).

  • Um die Standardeinstellung außer Kraft zu setzen und skalierbares Video für Publisher in einer gerouteten Sitzung zu deaktivieren, können Sie die scalableVideo Option in der OT.initPublisher() Methode. Denken Sie daran, dass sich die maximale Anzahl der Abonnenten ändert, wenn die Zahl der Verlage steigt. Um die maximale Abonnentenzahl zu ermitteln, konsultieren Sie die Tabelle auf der Seite "Leitfaden "Interaktive Live-Videoübertragungen.

  • Um die Stabilität in großen Sitzungen zu gewährleisten, unterdrücken Sie Verbindungsereignisse, siehe die "Leitfaden "Unterdrückung von Verbindungsereignissen.

  • Größere WebRTC-Sitzungen sind möglich, wenn Sie die Erlebnis-Komponist.

Live-Streaming

Bei dieser Art der Übertragung können mehr als 15.000 Abonnenten Streams abonnieren. Es gibt zwei Arten von Protokollen für die Videoübertragung: RTMP (Real Time Messaging Protocol) und HLS (HTTP Live Streaming). Unabhängig davon, für welches Protokoll Sie sich entscheiden, sollten Sie die Anzahl der Publisher begrenzen, um ein besseres Zuschauererlebnis zu gewährleisten.

HLS vs. RTMP

  • HLS unterstützt eine unbegrenzte Anzahl von Abonnenten, während RTMP durch die RTMP-Übertragungsplattform begrenzt ist.
  • HLS verzögert sich um 15-20 Sekunden, während RTMP (von der Vonage-Plattform) um fünf Sekunden verzögert wird; dies schließt jedoch nicht die Verzögerung durch die RTMP-Übertragungsplattform ein, da auch sie aufgrund ihrer Videoverarbeitung Verzögerungen verursacht.
  • HLS mit niedriger Latenz (LL-HLS) wird um 4-6 Sekunden verzögert
  • Die HLS-Wiedergabe wird nicht von allen Browsern unterstützt, aber es gibt Plugins, die Sie verwenden können, wie z. B. flowplayer. Die Wiedergabe ermöglicht es den Nutzern, vom Beginn des Livestreams bis zum aktuellen Livestream zurückzuspringen, sozusagen ein Video-Scrubbing (Zurückspulen/Vorspulen).
  • Der DVR-Modus kann aktiviert werden, wenn Sie eine HLS-Sitzung erstellen. Dies ist ein Apple-Standard, der es den Benutzern ermöglicht, HLS-Live-Sendungen innerhalb eines Zeitfensters von 2 Stunden wiederzugeben/anzuhalten und fortzusetzen.
  • HLS/RTMP hat eine Standard-Höchstdauer von vier Stunden. Wenn die Sendung länger dauern soll, ändern Sie die Eigenschaft "Maximale Dauer" (die maximale Dauer beträgt 10 Stunden).
  • HLS/RTMP-Streams werden automatisch sechzig Sekunden nach der Trennung des letzten Clients von der Sitzung beendet.

Wenn Sie mehr über Live-Streaming erfahren möchten, z. B. über Layouts, maximale Dauer und das Starten und Stoppen von Live-Streaming, besuchen Sie die Leitfaden für Live-Streaming-Übertragungen.

Bewährte Praktiken für Benutzeroberfläche und Benutzererfahrung

Im Allgemeinen wird empfohlen, die folgenden Hinweise zu lesen und zu beachten Dokumentation zur UI-Anpassung und folgen Sie den Abschnitten, die für Ihre Bewerbung relevant sind.

Sicherstellung einer guten Benutzererfahrung

Precall-Test

Fügen Sie einen Pre-Call-Test hinzu, bei dem das Gerät und die Verbindung des Benutzers einem Netzwerk- und Hardwaretest unterzogen werden, bevor er einer Sitzung beitritt. Denken Sie daran, für jeden Test neue Sitzungs-IDs zu generieren und den Test mindestens 30 Sekunden lang laufen zu lassen, um genauere Ergebnisse zu erhalten.

Die allgemeine Vonage Precall Test Tool kann von Ihnen und Ihren Kunden für allgemeine Verbindungstests mit der Video API verwendet werden.

Wenn Sie Ihren eigenen PreCall-Test integrieren und alle Testdaten sammeln möchten, stehen Ihnen dazu mehrere Ressourcen zur Verfügung:

Video-Stream-Handler

Completion Handlers können Ihnen Feedback geben, wenn Sie versuchen, eine Verbindung zu einer Video API-Sitzung herzustellen, zu veröffentlichen, zu abonnieren oder Signale zu senden. Sie werden hier beschrieben:

Sie können auch auf Ausnahmeereignisse für das OT-Objekt warten, die Ausnahmeereignisse für allgemeinere Fehler auslösen, die in Außergewöhnliche Ereignisse

Wenn die Verbindung hergestellt ist, veröffentlichen Sie normalerweise Audio- und Videodateien und abonnieren auch die Streams anderer Teilnehmer. Bei der Verwaltung der Verleger und Abonnenten in Bezug auf die Benutzeroberfläche können Sie die jeweiligen Ereignisse der Verleger- und Abonnenteninstanzen nutzen, die Ihnen helfen, den Benutzern nützliche Informationen anzuzeigen, wenn bestimmte Ereignisse oder Ausnahmen auftreten. Publisher- und Subscriber-Ereignisse können unterschiedlich sein und werden hier beschrieben:

Audio-Fallback

Unser Medienserver prüft ständig die Netzwerkbedingungen, und wenn er ein Problem mit der Verbindung des Endnutzers feststellt, unterbricht er automatisch das Video und fährt nur mit dem Audio fort, wenn der Paketverlust mehr als 15 % beträgt; in diesem Fall wird ein Ereignis gesendet. Es wird empfohlen, dass ein solches Ereignis auf der Benutzeroberfläche angezeigt wird, um die betroffenen Benutzer darauf hinzuweisen, dass die Qualität ihrer Verbindung gesunken ist und sie zu einer reinen Audioverbindung wechseln. Der Schwellenwert für die Umschaltung auf Nur-Audio ist nicht konfigurierbar. Weitere Informationen finden Sie in diesen Beispielen:

Audio Fallback ist standardmäßig aktiviert, kann aber mit der Option audioFallbackEnabled Parameter. Siehe hier

Wiederherstellung der Verbindung zur Sitzung

Wenn ein Teilnehmer aufgrund von Netzwerkproblemen plötzlich aus einer Sitzung ausscheidet, versucht er, sich wieder mit der Sitzung zu verbinden. Um die Benutzerfreundlichkeit zu verbessern, wird empfohlen, solche Ereignisse zu erfassen und auf der Benutzeroberfläche ordnungsgemäß anzuzeigen, damit der Benutzer weiß, dass er versucht, die Verbindung zur Sitzung wiederherzustellen. Weitere Informationen finden Sie unter hier.

Aktiver Lautsprecher

Versuchen Sie bei reinen Audiositzungen, eine Audiopegelanzeige einzufügen, damit die Teilnehmer sehen können, wer der/die aktive(n) Sprecher ist/sind. Versuchen Sie bei Videositzungen, das Layout so zu ändern, dass der aktive Sprecher mehr Bildschirmfläche erhält. Sie können die audioLevelUpdated Ereignis, das in regelmäßigen Abständen gesendet wird, um die UI-Anpassungen.

Loudness-Detektor

Es ist sinnvoll, einen Lautheitsdetektor zu implementieren, um zu erkennen, wann ein stummgeschalteter Benutzer zu sprechen versucht. In diesem Fall muss der audioLevelUpdated Ereignis wird ausgelöst, wenn audioLevel auf 0 gesetzt ist. Daher ist es notwendig, einen AudioContext zu verwenden, um diese Situation zu vermeiden.

Steuerung der Auflösung/Bildrate

Das Subscriber-Objekt bietet Methoden, um die empfangene Auflösung und/oder die Bildrate zu verringern. Dies ist nützlich, um Bandbreite und CPU-Ressourcen zu sparen, wenn Sie eine große Anzahl von Teilnehmern anzeigen (z. B. mehr als 4 auf einem Handy oder mehr als 8 auf einem Desktop)

Vermeiden von Audioproblemen

Bei großen Anrufen können die Teilnehmer versehentlich Rauschen oder Echos in den Anruf einbringen. Je höher die Anzahl der Teilnehmer ist, desto wahrscheinlicher ist es, dass dies Probleme verursacht. Daher könnten Sie für größere Sitzungen eine automatische Stummschaltung beim Beitritt und/oder eine Taste zum Stummschalten aller Moderatoren in Betracht ziehen.

Berichtsausgabe-API

Meldung eines Problems ermöglicht es dem Endverbraucher der Anwendung, eine eindeutige Problem-ID auf der Client-Seite auszulösen. Unser Kunde kann diese Problem-ID speichern und sie verwenden, wenn er ein Ticket beim Support anfordert. Die Problem-ID hilft dabei, die eindeutige Verbindungs-ID zu identifizieren, die das Problem gemeldet hat, und die Untersuchung durch den Support zu fokussieren.

Standort-Hinweis

Wenn Erstellen einer Sitzungkönnen Sie eine bevorzugte Region festlegen, in der der Videoanruf stattfinden soll. Dies kann für große Sitzungen nützlich sein, bei denen Sie wissen, dass die meisten Benutzer aus einer bestimmten Region teilnehmen werden. Beachten Sie, dass dies keine Garantie dafür ist, dass ein bestimmtes Rechenzentrum verwendet wird; siehe dazu Regionale Medienzonen.

Verbessern der Erfahrung im Bereitschaftsdienst

  • Hintergrund Unschärfe/Ersatz - Das JS SDK bietet eine einfache Methode, um den Hintergrund unscharf zu machen oder ihn durch ein Bild zu ersetzen. Im letzteren Fall sollten Sie sicherstellen, dass das Hintergrundbild das gleiche Seitenverhältnis wie der veröffentlichte Stream hat, und beachten Sie, dass der Hintergrund je nach fitMode beschriebene Einstellung hier. Beachten Sie, dass das Weichzeichnen und Ersetzen des Hintergrunds nur in aktuellen Versionen von Chrome, Electron, Opera und Edge unterstützt wird. In anderen (nicht auf Chrome basierenden) Browsern oder auf iOS wird sie nicht unterstützt.

Sie sollten überprüfen, ob das immer noch der Fall ist.

  • Medienprozessor - Verwenden Sie die Vonage Media Processor-Bibliothek, um benutzerdefinierte Transformationen auf veröffentlichte Videos auf dem Desktop und auf Mobilgeräten anzuwenden, auch nativ mit unseren mobilen SDKs. Dies unterstützt Hintergrundunschärfe und -ersetzung, aber auch fortgeschrittenere Anwendungsfälle wie Augmented Reality und räumliches Audio.

  • Live-Untertitel API - Verwenden Sie diese einfache API, um Audiostreams zu transkribieren und Echtzeit-Untertitel für Ihre Anwendung zu generieren. Mit der Live Captions API können Sie Endbenutzern in einer Vonage Video-Sitzung mithilfe eines Transkriptionsdienstes Live-Untertitel anzeigen.

  • Audio-Anschluss - Mit Audio Connector können Sie rohe Audioströme (PCM 16 kHz/16 Bit) aus einer Live-Videositzung von Vonage an externe Dienste wie AWS, GCP, Azure usw. senden, einzeln oder gemischt. Sie können auch den Sprecher identifizieren, indem Sie die Audioströme einzeln senden, indem Sie mehrere WS-Verbindungen öffnen. Kunden nutzen diese Funktion, um Anwendungsfälle wie medizinische Transkriptionen und Echtzeit-Übersetzungen zu erstellen.

Verlobungsmerkmale

  • Chat (Textnachrichten) - können Sie Nachrichten senden mit Signalisierung von VonageBeachten Sie jedoch, dass die Nachrichten nicht auf der Videoplattform von Vonage gespeichert werden. Beachten Sie beim Hinzufügen von Textnachrichtenfunktionen, dass einige Benutzer möglicherweise erst nach dem Versenden von Textnachrichten zu einer Sitzung hinzukommen bzw. ihr beitreten; Nachzügler können gesendete Nachrichten nicht mehr einsehen. Sollten Sie sich für die Aufzeichnung einer Sitzung entscheiden, werden Textnachrichten nicht aufgezeichnet, es sei denn, Sie implementieren Experience Composer.

  • Bildschirmfreigabe

    • Ziehen Sie in Erwägung, den Publisher, der den Bildschirm mitbenutzt, auszublenden, um den Flur-Spiegel-Effekt zu vermeiden.
    • ContentHint: Ermöglicht die Optimierung der Bildschirmfreigabe für Details (z. B. Dias) oder Bewegungen (z. B. Videos).motion, detail, etc. Dieses Flag kann und sollte nach 2.20 gesetzt werden.

Erlebnis-Komponist

Wir stellen Ihnen auch Werkzeuge zur Verfügung, mit denen Sie ein hochgradig individuelles Layout erstellen können. Auf diese Weise können Sie Web-Applikationen erstellen, die den Endbenutzern ein reichhaltiges UI/UX-Erlebnis bieten.

  • Erstellen einer Webseite, die auf der Vonage-Plattform wiedergegeben wird
  • Mischen Sie Videoinhalte mit anderen Webinhalten, z. B.
  • Chat-Fenster
    • Whiteboard
    • Erweiterte Inhalte und Layouts
  • Der Inhalt kann dynamisch sein und sich während der Sitzung ändern
  • Zusammengestellte Inhalte können in anderen Videositzungen veröffentlicht werden, um sie aufzuzeichnen, zu archivieren und auszustrahlen, ohne dass die vielfältigen UI/UX-Erlebnisse für die Benutzer beeinträchtigt werden.

Weitere Informationen finden Sie in der Erlebnis-Komponist Dokumentation.

Bewährte Praktiken der Archivierung

Es gibt zwei Arten von Angeboten, wenn es um die Aufnahme geht: komponierte und individuelle Streams.

Komponiert

  • Kann bis zu 16 Videostreams aufzeichnen, plus weitere 34 Streams, bei denen nur der Ton aufgezeichnet wird, insgesamt also 50 Streams
  • Eine einzige MP4-Datei, die alle Medienstreams enthält
  • Anpassbares Layout
  • Bildschirmaufzeichnung und erweiterte Layouts wie benutzerdefinierte Overlays, Montagen und Wasserzeichen (siehe Erlebnis-Komponist)
  • Kann automatisch gestartet werden (max. 240 Minuten). Wenn die Aufzeichnung nicht gestoppt wird, beginnt sie mit der Archivierung in einer neuen Datei)
  • Es ist möglich Prioritäten setzen bestimmte Streams in die Aufzeichnung einzubeziehen, indem Sie verschiedene Layoutklassen zuweisen.
  • Unterstützt die Formate SD, HD und FHD.

Individueller Stream:

  • Kann bis zu 50 Streams aufzeichnen, sowohl Audio als auch Video
  • Mehrere einzelne Streams/Dateien in einem Zip-Ordner speichern
  • Vorgesehen für die Verwendung mit einem Nachbearbeitungstool zur Erstellung individueller Inhalte
  • Kann nicht automatisch gestartet werden

Aufbewahrung von Archiven

Vonage bewahrt die Archive 72 Stunden lang auf, wenn das Hochladen fehlschlägt, der Cloud-Speicher nicht konfiguriert wurde oder die Option zum Deaktivieren des Speicher-Fallbacks nicht ausgewählt wurde. Denken Sie daran, dass die Archive nicht wiederhergestellt werden können, wenn Sie den Upload-Fallback nicht aktivieren und der Upload aus irgendeinem Grund fehlschlägt.

FAQs zur Archivierung

  1. Sind die Archive verschlüsselt?

Nicht standardmäßig. Aber man kann eine Verschlüsselungsfunktion für zusammengesetzte Archive hinzufügen. Um mehr zu erfahren, besuchen Sie Archiv-Verschlüsselung

  1. Können Sie nur den Ton oder nur das Video aufnehmen?

Ja. Die Verwendung des REST-APIsetzen Sie die hasVideo/hasAudio Parameter auf true oder false.

  1. Kann ich das Archiv so benennen, dass ich sie namentlich identifizieren kann?

Ja. Die Verwendung des REST-APIsetzen Sie die name auf den gewünschten Bezeichner.

  1. Wie kann ich den Status der Archive überprüfen?

Verwenden Sie die Archivinspektor.

  1. Kann ich bestimmte Streams einer Sitzung aufzeichnen?

Ja, siehe Auswahl der in ein Archiv aufzunehmenden Streams.

  1. Kann ich gleichzeitig in verschiedenen Formaten aufnehmen?

Ja, Sie können die Archivierung für eine bestimmte Sitzung mehr als einmal starten. Das bedeutet, dass Sie z. B. ein zusammengesetztes Layout gleichzeitig mit einer separaten Aufzeichnung pro Teilnehmer aufzeichnen können (d. h. Einzelarchivierung).

Qualität, Leistung und Kompatibilität

  • Geräte - Versuchen Sie bei Sitzungen mit mehreren Teilnehmern, die Anzahl der Teilnehmer zu begrenzen, da mehr Teilnehmer mehr Rechenleistung erfordern. Wir empfehlen die folgende Anzahl von Teilnehmern:

    • Mobil = 4 (nach offizieller Aussage der Ingenieure sind bis zu 8 möglich)
    • Laptop = 10
    • Schreibtisch = 25

  • Steuerung der Auflösung/Bildrate - Das Subscriber-Objekt bietet Methoden, um die empfangene Auflösung und/oder Bildrate zu verringern. Dies ist im Zusammenhang mit der Einsparung von Bandbreite und CPU-Ressourcen nützlich, wenn Sie eine große Anzahl von Teilnehmern anzeigen (z. B. mehr als 4 auf einem Mobiltelefon oder mehr als 8 auf einem Desktop)

  • Bandbreitenanforderungen siehe "Wie hoch ist die Mindestbandbreite für die Nutzung der Vonage Video API?"

  • Proxy - wenn Benutzer nur über einen Proxy auf das Internet zugreifen können, stellen Sie sicher, dass es sich um einen "transparenten" Proxy handelt, andernfalls muss er im Browser für eine HTTPS-Verbindung konfiguriert werden, da webRTC nicht gut mit Proxys funktioniert, die eine Authentifizierung erfordern. Schauen Sie sich unseren Netzwerk-Checkflow in Richtlinien für eingeschränkte Netze

  • Firewall - der Artikel "Was sind die Anforderungen an die Netzwerkkonnektivität der Vonage Video API?" enthält weitere Informationen zu den optimalen Anschlüssen für den schnellsten Verbindungsaufbau und die beste Videoqualität.

  • Codecs- Vonage unterstützt VP9, VP8 und H.264 Codecs; siehe die Codecs Anleitung für weitere Informationen zu den Unterschieden zwischen den einzelnen Codecs.

Überwachung von Sitzungen

Überwachung von Sitzungen ermöglicht es Ihnen, eine Webhook-URL zu registrieren. Verwenden Sie diese Funktion, um Sitzungen und Streams zu überwachen - ein Beispiel dafür ist die Begrenzung der Teilnehmerzahl in einer Sitzung, die oft zusammen mit forceDisconnect Funktion. Der Moderator kann auch eine Aktion an den Server senden, damit dieser eine REST-Aufruf zum erzwungenen Trennen der Verbindung.

  • Es kann auch dazu verwendet werden, die Nutzung zu verfolgen, aber für eine bessere Verfolgung der Nutzung verwenden Sie die Einblicke API.

  • Wenn innerhalb von 30 Minuten mehr als 50 Ereignisübermittlungsfehler auftreten (d. h. wenn wir beim Senden einer HTTP-Anfrage an Ihre Callback-URL keine 200-Erfolgsantwort erhalten), deaktivieren wir die Ereignisweiterleitung der Sitzungsüberwachung. In diesem Fall senden wir eine E-Mail. Sie können die Sitzungsüberwachung auf Ihrer Account-Seite wieder aktivieren.

  • ConnectionCreated: Sie können verwenden VerbindungsDaten um die Verbindungen der Benutzer zu identifizieren. Sie können z. B. die Benutzer-ID, den Namen oder andere den Client beschreibende Daten übergeben (verwenden Sie keine persönlichen Informationen in Token-Daten)

Add-ons

Die meisten Kunden können Add-ons mit einem einzigen Klick erwerben (oder entfernen), der über das Self-Service-Tool konfiguriert wird.

Sicherheit und Datenschutz

Die Vonage Video API kann so angepasst werden, dass sie die höchsten Sicherheitsstandards erfüllt. Unsere Plattform ist GDPR-konform und wir sind HIPAA-konform. Für europäische Kunden bieten wir erweiterte Add-ons an, die die Einhaltung zusätzlicher lokaler Zertifizierungen und Standards ermöglichen, wie z. B. die KBV-Zertifizierung (Deutschland) oder andere Datenschutzgesetze, die auf einen besseren Datenbesitz und -schutz abzielen (europaweit).

Lesen Sie mehr über:

Auf Anfrage und unter NDA können wir weitere Berichte wie das Data Transfer Impact Assessment, den SOC2 Type 2 Audit-Bericht und externe Pen-Tests zur Verfügung stellen, die die hohen Sicherheitsstandards unserer Video-Plattform belegen.

Preisgestaltung

Wo kann ich weitere Hilfe erhalten?

Wenn Sie Fragen haben, können Sie sich an unser Entwicklergemeinschaft auf Slackoder kontaktieren Sie alternativ unser API-Support-Team.