Video-Einschränkungen: Einstellung der bevorzugten Auflösung und Bildrate

Mit der Vonage Video API können Publisher Videostreams optimieren, indem sie bevorzugte Einschränkungen für die Videoauflösung und die Bildrate festlegen. Diese Einschränkungen helfen dabei, die Bandbreitennutzung zu verwalten, die Gerätefähigkeiten zu berücksichtigen und den Abonnenten ein maßgeschneidertes Benutzererlebnis zu bieten.

Dieser Leitfaden beschreibt die Verwendung der preferredResolution und preferredFrameRate APIs für Verlage.

Anmerkung: Diese APIs sind derzeit nur im JavaScript-SDK verfügbar. Es gibt keinen angekündigten Zeitplan für die Unterstützung in anderen SDKs.

Übersicht

Wenn Sie einen Videostream veröffentlichen, möchten Sie vielleicht die Videoqualität aus verschiedenen Gründen dynamisch anpassen: Einsparung von Bandbreite, Anpassung an die Anforderungen der Benutzeroberfläche oder Einschränkung des Ressourcenverbrauchs für bestimmte Teilnehmerrollen (z. B. Miniaturansichten oder Bildschirme mit geringer Bewegung). Die Publisher-API von Vonage stellt Methoden bereit, mit denen Sie die bevorzugte Auflösung und Bildrate für Ihre Videospuren anpassen können. Diese Einschränkungen werden auf dem Videoeingabegerät mithilfe von Standard-WebRTC-APIs durchgesetzt, um optimale Ergebnisse zu erzielen.

Steuerung von Videoauflösung und Bildrate

Der Verleger kann angeben:

Bevorzugte Auflösung: Die gewünschte Breite und Höhe (in Pixel) für den Videostream.
Bevorzugte Bildrate: Die gewünschte Anzahl von Bildern pro Sekunde (fps) für den Video-Stream.

Sie können diese mit den folgenden Methoden dynamisch steuern nach wird der Verlag initialisiert:

// Set preferred resolution (width x height)
await publisher.setPreferredResolution({ width: 640, height: 360 });

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

Diese Einstellungen steuern direkt die vom Herausgeber ausgehende Videospur, was sich wiederum auf die Qualität für alle Abonnenten auswirkt. Die tatsächlichen Netzwerkbedingungen und Gerätefunktionen können diese Werte jedoch einschränken oder außer Kraft setzen.

Einstellung der bevorzugten Auflösung

Methode: publisher.setPreferredResolution(preferredResolution)

preferredResolution ist ein Objekt mit width und height Eigenschaften (beide positive Ganzzahlen, in Pixel).
Die Auflösung kann nicht größer sein als die ursprüngliche Veröffentlichungsauflösung. Wenn Sie z. B. mit 640×480 veröffentlicht haben, können Sie keine höhere Auflösung als diese einstellen.

Typische Verwendung:

publisher.setPreferredResolution({ width: 320, height: 240 });

Validierungen:

Muss bei einem Publisher aufgerufen werden, der ein Video aufnimmt (publishVideo: true).
Beide width und height müssen positive ganze Zahlen sein.
Die Auflösung kann nicht größer sein als die ursprüngliche Veröffentlichungsauflösung.

Fehler-Fälle:

Schlägt fehl, wenn er bei einem reinen Audioverlag aufgerufen wird oder wenn die Eingabewerte ungültig sind.

Einstellung der bevorzugten Bildrate

Methode: publisher.setPreferredFrameRate(frameRate)

frameRate muss eine ganze Zahl größer oder gleich 1 sein.