Neues Video API 2.33: Client-Beobachtbarkeit und Plattform-Updates

Einführung

Wir freuen uns, die Veröffentlichung von Vonage Video API 2.33 bekannt geben zu können. Dieses Update bringt signifikante Verbesserungen der clientseitigen Beobachtbarkeit, führt granulare Kontrollen für die Videoqualität der Publisher sowohl auf Web- als auch auf nativen Plattformen ein und erweitert unsere Plattformunterstützung auf Apple Silicon Macs und Debian 13.

Hier finden Sie einen Überblick über die neuen Funktionen und Verbesserungen in dieser Version. Wie immer empfehlen wir einen Blick in die vollständigen Versionshinweise für alle Änderungen.

Verbesserte Beobachtbarkeit der Kunden

Für die Aufrechterhaltung qualitativ hochwertiger Videositzungen ist es entscheidend, Einblicke in die Erfahrung der Endbenutzer zu erhalten. Version 2.33 führt eine umfassende Reihe neuer Metriken und Qualitätsereignisse für die Client-SDKs ein. Diese Verbesserungen ermöglichen es Entwicklern, die Publisher- und Subscriber-Performance effektiver zu überwachen und bieten einen tieferen Einblick in die Netzwerk- und Gerätebedingungen, die sich auf die Endpunkte der Benutzer auswirken. Diese neuen Datenpunkte sollen Ihnen helfen, Qualitätsprobleme proaktiv und in Echtzeit zu erkennen und zu beheben.

Für Verleger haben Sie jetzt Zugang zu:

• Metriken der Simulcast/SVC-Ebene, einschließlich kodierter Bildabmessungen, Ausgangsbildraten und Bitrate für jede Ebene

• Einblicke in Qualitätseinschränkungen die Ihnen genau sagen, warum die Qualität reduziert wird - ob es an der Bandbreite, der CPU oder anderen Beschränkungen liegt

• Detaillierte Aufschlüsselung der Bitrate Trennung der eigentlichen Video-Nutzlast vom Protokoll-Overhead

• Skalierbarkeitsmodus und Codec-Informationen für feinkörnige Optimierung

Für Abonnenten gibt es neue Statistiken:

• Dekodierte Auflösung und Bildrate um genau zu verstehen, was die Nutzer empfangen

• Erkennung von eingefrorenen Videos und Pausen mit präziser Verfolgung der Dauer

• Metriken zur Rendering-Leistung zur Ermittlung von Engpässen bei der Medienwiedergabe

Ereignisse zur Änderung der Videoqualität liefern Echtzeit-Benachrichtigungen, wenn signifikante Qualitätsänderungen auftreten, und ermöglichen es Ihnen, proaktive Qualitätsmanagement-Funktionen in Ihre Applikationen einzubauen.

Diese Verbesserungen der Beobachtbarkeit ermöglichen es Ihnen,:

• Qualitätsprobleme schneller und genauer diagnostizieren

• Erstellen Sie intelligentere, adaptive Erlebnisse auf der Grundlage realer Bedingungen

• Bessere Unterstützung für Ihre Endnutzer mit konkreten Metriken

• Optimieren Sie die Nutzung von Netzwerk- und Rechenressourcen

Lesen Sie den Leitfaden zur Client-Beobachtbarkeit.

API für bevorzugte Auflösung und Bildrate des Herausgebers (JS Web)

Applikationen benötigen oft eine dynamische Kontrolle über die Videoqualität, um sich an veränderte UI-Layouts oder Bandbreitenbeschränkungen anzupassen. Das JavaScript Web SDK enthält jetzt neue APIs, mit denen Sie die bevorzugte Auflösung und Bildrate eines Publishers nach dessen Initialisierung anpassen können. Diese Funktion ermöglicht es Entwicklern, die Auflösung und Bildrate eines Clients zu verringern, wenn die ursprünglichen Einstellungen Qualitätsprobleme verursachen, um eine effiziente Ressourcennutzung zu gewährleisten und sicherzustellen, dass das veröffentlichte Video den spezifischen Anforderungen der Anwendung entspricht.

// Set preferred resolution
await publisher.setPreferredResolution({ width: 1280, height: 720 });

// Set preferred frame rate
await publisher.setPreferredFrameRate(30);

Wichtiger Hinweis: Sie können zwar bevorzugte Werte festlegen, aber die tatsächlich gelieferte Qualität wird letztendlich durch die verfügbare Netzwerkbandbreite und die Gerätefähigkeiten bestimmt. Die neuen Werte sollten eine niedrigere Auflösung oder Bildrate haben als die ursprünglichen initialisierten Werte.

Erfahren Sie mehr über Video-Einschränkungen für Herausgeber.

Publisher Degradation Präferenz (Native SDKs)

Bei mobilen und Desktop-Applikationen, die auf nativen Plattformen ausgeführt werden, ist die Steuerung des Verhaltens von Videos unter Stress entscheidend für die Bindung von Benutzern.

Die nativen SDKs unterstützen jetzt den Parameter "Publisher Degradation Preference". Mit dieser Einstellung können Sie festlegen, wie der Stream eines Publishers auf schlechte CPU- oder Netzwerkbedingungen reagieren soll, z. B. die Auflösung verringern, um die Bildrate beizubehalten, oder umgekehrt.

Diese Steuerung ist besonders nützlich, um die Leistung auf eingeschränkten Geräten zu optimieren und das bestmögliche Erlebnis zu gewährleisten, auch wenn die Ressourcen begrenzt sind, oder wenn bestimmte Anwendungen einer bestimmten Metrik Vorrang vor einer anderen einräumen müssen. So kann beispielsweise eine Anwendung im Gesundheitswesen die Videoqualität jederzeit der Audioqualität vorziehen, während eine Anwendung, die Spiele oder Sportinhalte streamt, eine konstante Bildrate der visuellen Wiedergabetreue vorzieht.

Siehe die Anleitung zum Einstellung der Publisher Degradation Präferenz.

Erweiterter Plattform-Support

iOS SDK auf dem Mac (Apple Silicon)

Wir haben offiziell Unterstützung für das Vonage iOS SDK auf Mac-Rechnern mit Apple Silicon hinzugefügt. Durch die Nutzung der architektonischen Ähnlichkeiten zwischen Apples mobilem und Desktop-Silizium bietet dieses Update Mac-Nutzern und Entwicklern eine robuste, native SDK-Option für die Erstellung von macOS-Applikationen.

Ansicht der iOS SDK Übersicht.

Debian 13-Unterstützung

Unsere Linux-Unterstützung entwickelt sich mit der Aufnahme von Debian 13 weiter. Entwickler können die Video API von Vonage jetzt auf der neuesten Debian-Distribution einsetzen und so die Kompatibilität mit modernen Infrastrukturstandards sicherstellen.

Allgemein verfügbare Funktionen (GA)

Teilnehmer-Downlink-Schätzung

Die Funktion "Subscriber Downlink Estimation", die zuvor als Beta-Version verfügbar war, ist nun allgemein verfügbar. Diese Beobachtungsmetriken liefern eine Schätzung der verfügbaren Bandbreite eines Teilnehmers für den Empfang von Videodaten. Diese Daten sind unerlässlich für die Implementierung einer adaptiven Logik, die die Qualität des Abonnements auf der Grundlage der tatsächlichen Netzwerkkapazität des Benutzers anpasst.

Sehen Sie sich die Dokumentation für Sender-seitige Statistiken für Client-Beobachtbarkeit.

Google Chrome für iOS

Wir bieten jetzt vollständige Unterstützung für Google Chrome auf iOS und gewährleisten so ein konsistentes und zuverlässiges Videoerlebnis für Benutzer, die über Chrome auf Apple-Mobilgeräten auf Ihre Anwendung zugreifen.

Erste Schritte

Sind Sie bereit für ein Upgrade? Hier ist, was Sie wissen müssen.

Installation für JavaScript/Web:

npm install @vonage/client-sdk-video@2.33.0

Für native SDKs, besuchen Sie unsere Dokumentation für plattformspezifische Installationsanweisungen.

Schlussfolgerung

Wir hoffen, dass die zusätzlichen Qualitätsmetriken und die Möglichkeit, die Qualität im laufenden Betrieb anzupassen, Ihnen helfen werden, effizientere Video-Applikationen zu entwickeln. Mit Echtzeit-Zugriff auf diese Metriken können Entwickler bessere Benutzerinteraktionen in ihren Anwendungen entwickeln.