Video-Javascript-SDK Release Notes

Festgelegt

• Es wurde ein Problem behoben, bei dem das Wechseln der Audio-Eingabegeräte (beispielsweise das Anschließen von Bluetooth-Kopfhörern) kurz nach dem Start der Sitzung einen audioAcquisitionProblem was bei den Remote-Teilnehmern zu einem vollständigen Tonausfall führte, sobald die Sitzung auf eine geroutete Topologie umgestellt wurde.

• Es wurde ein Problem behoben, bei dem Applications, die innerhalb eines Android Chrome WebViews ausgeführt wurden, nicht auf den Precall-Test zugreifen oder an einer Videokonferenz teilnehmen konnten.

• Eine fehlende TypeScript-Definition wurde behoben: die constraints Die Immobilie war nicht in der GetUserMediaProperties Schnittstelle in ot.d.ts, was zu einer Diskrepanz mit dem tatsächlichen Laufzeitverhalten des SDK führt.

Festgelegt

• Es wurde ein Problem behoben, bei dem die Verwendung von `publisher.setPreferredResolution()` in Kombination mit einem Hintergrundfilter (Weichzeichner oder Ersetzung) dazu führte, dass sich die veröffentlichte Auflösung auf einen unerwarteten Wert änderte. Der Publisher behält nun die beabsichtigte Auflösung bei, wenn ein Hintergrundfilter angewendet wird.

• Es wurde ein Problem behoben, bei dem das Aus- und Wiedereinschalten des Videos (publishVideo(false), gefolgt von publishVideo(true)) bei aktivem Hintergrundfilter (Weichzeichner oder Ersetzung) dazu führen konnte, dass ungefilterte Bilder kurzzeitig für Remote-Teilnehmer sichtbar wurden. Das SDK stellt nun sicher, dass nach dem Wiedereinschalten des Videos nur noch gefilterte Bilder gesendet werden.

• Es wurde ein in Version 2.34 eingeführter Fehler behoben, bei dem die TypeScript-Definition von `OT.hasMediaProcessorSupport()` fälschlicherweise einen `mediaType`-Parameter erforderte. Der `mediaType`-Parameter ist nun optional, wodurch die Kompatibilität mit bestehendem Code wiederhergestellt wird, der `OT.hasMediaProcessorSupport()` ohne Argumente aufruft.

Hinzugefügt

• Neue Einblicke in den Netzwerkzustand hinzugefügt. Diese Version erweitert die Client-Observability-Funktion um neue Metriken zum Netzwerkzustand und bietet so detaillierte Einblicke in die Netzwerkleistung und Qualitätsindikatoren. Diese Metriken ergänzen die in Version 2.33.0 eingeführten Publisher- und Subscriber-Statistiken und helfen Entwicklern dabei, Netzwerkbedingungen, die sich auf die Videoqualität auswirken, proaktiv zu überwachen, Verbindungsprobleme zu diagnostizieren und fundierte Entscheidungen über mögliche Anpassungen zu treffen. Weitere Informationen finden Sie unter diese Dokumentation.

• Es wurde Unterstützung für Hintergrundunschärfe und Hintergrundersetzung in Safari und Firefox hinzugefügt. Diese Version bietet nun Unterstützung für Hintergrundunschärfe und Hintergrundersetzung in Safari und Firefox. Dies sorgt für einheitliche Funktionen in allen gängigen Browsern und auf allen Geräten und kommt damit den Kundenwünschen nach einer plattformübergreifend einheitlichen Unterstützung von Hintergrundeffekten nach. Um die Verfügbarkeit der erforderlichen Browser-APIs zu prüfen, verwendet das SDK einen Inline-Webworker. Dieser Inline-Webworker kann in Anwendungen, die eine strenge Content Security Policy (CSP) durchsetzen, Verstöße gegen die CSP auslösen – insbesondere in solchen, die keine blob: und data: im worker-src oder child-src Direktiven. Für weitere Informationen, siehe diese Dokumentation.

• Unterstützung für die Übersetzung von Live-Untertiteln hinzugefügt. Diese Version bietet nun Unterstützung für die Übersetzung von Live-Untertiteln, wodurch Untertitel während Videoanrufen in Echtzeit übersetzt werden. Jeder Teilnehmer kann unabhängig seine bevorzugte Übersetzungssprache auswählen. Diese Funktion unterstützt den gesamten AWS Translate-Sprachumfang. Es handelt sich hierbei um eine Funktion in der privaten Beta-Phase – um die Übersetzung von Live-Untertiteln für Ihr Projekt zu aktivieren, kontaktieren Sie uns bitte. Weitere Informationen zu „Live Captions“ finden Sie unter diese Dokumentation.

Festgelegt

• Diese Version behebt ein Zeitproblem, bei dem das Setzen eines Medienprozessor-Connectors unmittelbar nach der Erstellung eines Abonnenten fehlschlagen konnte. Das SDK wartet nun, bis der Stream verfügbar ist, bevor es den Konnektor anwendet.

• Diese Version behebt ein Problem, bei dem Streams in Sitzungen mit aktivierter End-to-End-Verschlüsselung und Einzel-Peer-Verbindung nicht abonniert werden konnten.

• Diese Version behebt ein Problem mit der automatischen Wiederverbindungsbehandlung, das bei der Wiederherstellung von Netzwerken zu unnötigen Verbindungswiederherstellungen führen konnte. Die Wiederherstellung von Verbindungen erfolgt nun zuverlässiger, ohne dass stabile Peer-Verbindungen unterbrochen werden.

• Diese Version behebt eine Wettlaufsituation, bei der der Aufruf von subscribeToVideo(true) unmittelbar nach der Teilnehmerinitialisierung könnte fehlschlagen, wenn die Videospur noch nicht empfangen wurde.

• In dieser Version wurden Probleme behoben, bei denen der Paketverlust falsch berechnet wurde und bei denen Audio-Fallback-Ereignisse in bestimmten Situationen nicht ausgelöst wurden. Diese Fehler wurden während der Implementierung der Einblicke in den Netzwerkzustand Funktion, da Audio-Fallback-Ereignisse zu den Eingaben gehören, anhand derer der Netzwerkzustand ermittelt wird. Beide Korrekturen führen zu einem genaueren und zuverlässigeren Audio-Fallback-Verhalten.

Anforderungen

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

• Electron (neueste Version)
• 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 (neueste Version)
• Samsung (neueste Version)
• WebView Android API Stufe 36+
• WebView unter iOS 18.6+

Wichtig! OpenTok.js Version 2.16 war die letzte Version, die das Plugin für Internet Explorer unterstützte. OpenTok.js Version 2.16 wurde im Mai 2020 für die Standard-Umgebung und im Juni 2020 für die Enterprise-Umgebung außer Kraft gesetzt.

Die OpenTok.js-Bibliothek verwendet Port 443. Port 443 muss im Client-Netzwerk geöffnet sein.

Bekannte Probleme

Browserspezifische Probleme

Safari

• Die Videoqualität kann beim Streamen von Canvas-Inhalten aufgrund interner Verkleinerung, der Anpassung an das Geräte-Pixel-Verhältnis oder der WebRTC-Kodierung von Safari beeinträchtigt erscheinen. Siehe hierzu WebKit-Fehler.
• Die End-to-End-Verschlüsselung funktioniert nicht, wenn in WebKit-basierten Browsern (Safari unter macOS/iOS, Chrome unter iOS) Entwicklertools geöffnet sind. Wir arbeiten an einer Lösung.
• Das Video-JavaScript-SDK 2.27 und höher wird in Safari 14 und früheren Versionen nicht unterstützt.
• Neue Abonnenten sind nicht zu hören, bis Sie den Fokus auf den Browser-Tab legen. Durch das Wechseln zu diesem Tab wird der Ton wiederhergestellt. Siehe hier WebKit-Fehler.
• In Safari 17.0 und höher wird die Einstellung für die Videoauflösung bei der Bildschirmfreigabe ignoriert. Die resultierende Auflösung beträgt immer 640 × 360. Siehe hier WebKit-Fehler.
• Beim Aufruf von OT.initPublisher() Wenn Sie einen Bildschirmfreigabe-Publisher ohne Handler für Benutzeraktionen initialisieren, erhalten Sie möglicherweise eine InvalidAccessError. Das ist erwartetes Verhalten von Safari.
• Unter iOS 16.4 und höher mit aktiviertem „iCloud Private Relay“ kann es bei Nutzern zu Verbindungsabbrüchen in weitergeleiteten Sitzungen kommen. Siehe hier WebKit-Fehler.
• Nach einem eingehenden Anruf in iOS Safari kann es zu Unterbrechungen bei Audio und Video kommen. Nach der Annahme eines Anrufs und der Rückkehr zur Sitzung kann es zu Unterbrechungen bei Audio und Video vom iOS-Gerät kommen. Siehe diese WebKit-Fehler: #213853, #219318.
• Die Audioqualität von Streams, die über Safari unter iOS/iPadOS veröffentlicht werden, kann sich mit der Zeit verschlechtern und zu Knackgeräuschen oder Verzerrungen führen. Siehe hier WebKit-Fehler.

iOS

• Bei Nutzern, die den iOS-Browser abonniert haben, kann die Lautstärke in einigen Fällen falsch sein. Wir arbeiten derzeit an einer Lösung. Siehe hier WebKit-Fehler.
• Das Video flackert, wenn die Ausrichtung des Geräts geändert oder die Größe des Videos unter iOS 17+ angepasst wird. Siehe hier WebKit-Fehler.
• Videos werden in einem Video-Publisher unter iOS 17+ zunächst mit der falschen Auflösung angezeigt, was beim Anpassen der Größe zu einem sichtbaren Flackern führt. Siehe hier WebKit-Regression.
• Aufgrund einer Fehlfunktion von Apple erscheinen in Videos unter iOS 17 unerwartet Emojis. Reaktionen Funktion. Endnutzer müssen sie manuell deaktivieren: Öffnen Sie das Kontrollzentrum → tippen Sie auf „Videoeffekte“ → tippen Sie auf „Reaktionen“.

Chrome / Chromium

• Unter Windows mit Audiotreibern, die die Intel Smart Sound Technology unterstützen, kann ein Publisher möglicherweise kein audioInputDeviceChanged Problem beim Wechseln der Audio-Eingabegeräte. Die Audioübertragung funktioniert weiterhin einwandfrei. Wir arbeiten an einer Lösung.
• Wird der Laptop-Deckel während des Veröffentlichungsvorgangs geschlossen, wird der Publisher zerstört. Siehe hier Chromium-Fehler.
• Bei Stereo-Audioeingang ist die Echounterdrückung in Chrome 73 und höher deaktiviert. Siehe hier Problem mit Chrome.
• Die Veröffentlichung wird auf folgenden Plattformen nicht unterstützt: http Seiten (außer http://localhost). Seiten müssen über https.
• Bei Streams mit … kann das Video flackern. videoType eingestellt auf "custom" wenn sich der Videoinhalt kaum ändert. Einstellung videoContentHint zu text oder detail mildert das Problem. Siehe die Anleitung zu den Videoeinstellungen.

Firefox

• Die Einstellung der Bildrate hat in Firefox unter macOS bei Verwendung der integrierten FaceTime-Kamera keine Auswirkungen. Siehe hier Mozilla-Fehler.
• Einstellung audioBitrate in OT.initPublisher() hat in Firefox keine Wirkung. Siehe hier Mozilla-Fehler.
• Unter Android 13 müssen die Mikrofon- und Kameraberechtigungen von Firefox nach der Einstellung erst durch einen Neustart des Geräts wirksam werden.
• Unter Android 13 wird die Videoauflösung beim Wechseln der Ausrichtung möglicherweise nicht korrekt aktualisiert. Siehe hier Mozilla-Regression.

Android

• Unter Android 12 und 13 muss in Chrome die Lautstärke über „Media Volume“ und nicht über den Lautstärkeregler des Telefons eingestellt werden. Siehe hier Chromium-Fehler.
• In WebView für Android wird das Video des Publishers ausgeschaltet, sobald die App in den Hintergrund wechselt (App-Wechsel oder eingehender Anruf), und es wird nicht wiederhergestellt, wenn die App wieder in den Vordergrund rückt.

macOS

• Aufgrund einer Änderung seitens Apple tauchen unter macOS 14 (Sonoma) unerwartet Emojis in Videos auf. Reaktionen Funktion. So deaktivieren Sie sie: Klicken Sie auf das grüne Kamerasymbol in der Menüleiste → deaktivieren Sie „Reaktionen“.

Allgemeine Fragen

• Die accessDialogOpened Beim Aufruf von … kann das Ereignis fälschlicherweise ausgelöst werden. OT.getUserMedia(), auch wenn kein Zugriffsdialog angezeigt wurde.
• In einigen Fällen wird das Video beim Teilen einer Google-Präsentation im Tab-Modus mit einem schwarzen Rahmen angezeigt, wenn das Seitenverhältnis des Verfassers 4:3 beträgt. Dies tritt nicht auf, wenn die gesamte Präsentation per Bildschirmfreigabe geteilt wird.
• Bei einigen Nutzern der mobilen Firefox-Version kann die Geräteausrichtung den Videostream des Anbieters beeinträchtigen. Siehe hier Mozilla-Fehler.

Behobene Probleme

• Es wurde ein Speicherleck behoben, das sich auf lang laufende Sitzungen mit mehreren Teilnehmern auswirkte.
• Ein TypeScript-Definitionsfehler wurde behoben, bei dem die Eigenschaft "publisher stats" falsch benannt war transport anstelle von transportStats.

Neue Funktionen und Änderungen

• Es wurden neue Statistiken für Publisher und Abonnenten sowie Ereignisse zu Änderungen der Videoqualität hinzugefügt. Diese Version enthält neue Statistiken für Publisher und Abonnenten, darunter: Metriken zur Videoebene für Simulcast/SVC und Transportstatistiken für Publisher; Metriken zur Erfassung von Videoeinfrierungen und -pausen sowie zur Dekodierung für Abonnenten; sowie Ereignisse zu Änderungen der Videoqualität sowohl für Publisher als auch für Abonnenten. Weitere Informationen finden Sie unter diese Dokumentation.

• Es wurde eine vollständige Unterstützung für Netzwerkstatistiken von Absendern in Videositzungen hinzugefügt. Diese Version bietet nun vollständige Unterstützung für Netzwerkstatistiken von Absendern für Teilnehmer in Videositzungen (was zuvor im Beta-Stadium war). Weitere Informationen finden Sie unter diese Dokumentation.

• Es wurde Unterstützung für die bevorzugte Videoauflösung und Bildrate für Publisher hinzugefügt. Diese Version enthält neue Methoden zur Konfiguration der bevorzugten Videoauflösung und Bildrate für Publisher, sodass Sie die Qualität der ausgehenden Videos dynamisch anpassen können, ohne die ursprünglich bei der Initialisierung des Publishers festgelegte Auflösung oder Bildrate zu überschreiten. Weitere Informationen finden Sie unter diese Dokumentation.

• OpenTok.js bietet nun vollständige Unterstützung für Google Chrome für iOS. Weitere Informationen finden Sie unter diese Dokumentation.

• Wir haben die Option video.frameRate Eigenschaft in den Statistikobjekten, die von der Subscriber.getStats() Abschluss-Handler. Diese Eigenschaft ist veraltet und wird in Zukunft entfernt. Bitte verwenden Sie stattdessen die video.decodedFrameRate Eigenschaft statt. Für weitere Informationen, siehe diese Dokumentation.

Behobene Probleme

• Es wurde ein Problem behoben, bei dem TypeScript-Definitionen für Publisher Max Bitrate in früheren Versionen nicht enthalten waren.
• Es wurde ein Speicherleck in der Websocket-Handhabungslogik für das Signalisierungsprotokoll behoben.
• Es wurde ein Problem behoben, bei dem die Audioverarbeitungsoptionen (Verstärkungsregelung, Echokompensation usw.) in bestimmten Szenarien nicht korrekt angewendet wurden.
• Probleme bei der Verwaltung von Änderungen an Audio-Eingabegeräten wurden behoben, einschließlich der Erkennung von Standard-Gerätewechseln und der Genauigkeit der Geräteverfolgung.