Wird verwendet, um einen Audio-Video-Stream in der Vonage Video API-Sitzung abzurufen. Mehr...

Erbt von IDisposable.

Ausführliche Beschreibung

Wird verwendet, um einen Audio-Video-Stream in der Vonage Video API-Sitzung abzurufen.

Verwenden Sie die Subscriber.Builder Klasse zum Erstellen einer Abonnent Beispiel: Abonnenten können eine Verbindung herstellen, um Medien zu empfangen, wenn Sie die Session.Subscribe(Subscriber) Methode.

Die Abonnent Die Klasse implementiert die Schnittstelle „System.IDisposable“. Achten Sie darauf, die Methode Dispose() Methode der Abonnent Das Objekt muss seine Ressourcen freigeben, wenn Sie das Objekt nicht mehr benötigen (zum Beispiel, wenn die Abonnent das Streaming des Videos unterbrochen wird oder wenn die App oder das Fenster geschlossen wird).

Dokumentation zur Mitgliederauflistung

VideoReason

Legt Werte für die VideoEventArgs.Reason und VideoEventArgs.Reason Eigenschaften.

Dokumentation zu Member-Funktionen

GetRtcStatsReport()

Ruft den RTC-Statistikbericht für den Teilnehmer ab. Dies ist ein asynchroner Vorgang. Sobald die Statistiken verfügbar sind, wird die RtcStatsReport Nachricht gesendet wird.

Siehe auch Audio-Statistiken aktualisiert, Video-Statistiken – Aktualisiertund Publisher.GetRtcStatsReport().

Dokumentation zur Immobilie

Lautstärke

Die Lautstärke des Teilnehmers.

Die Lautstärke des Teilnehmers im Bereich von 0 bis 100. Liegt der eingestellte Wert außerhalb dieses Bereichs, wird er auf diesen Bereich begrenzt.

Der Standardwert beträgt 100.

UntertitelÜbersetzungSprache

Die bevorzugte Sprache für die Übersetzung der Untertitel dieses Abonnenten.

Dies ist eine Beta-Funktion..

Diese Einstellung wird nur wirksam, wenn Untertitel aktiviert sind. Wählen Sie hier einen unterstützten BCP-47-Sprachcode aus, um übersetzte Untertitel zu erhalten, oder null um die Übersetzung zu deaktivieren. Der Standardwert lautet null (Es wurde keine Übersetzung konfiguriert).

Die unterstützten Sprachcodes sind in der Server-API-Spezifikation definiert.

Bevorzugte Bildrate

Die bevorzugte Bildrate für den Stream des Abonnenten.

Begrenzung der Bildrate und der Videoauflösung (Bevorzugte Lösung) reduziert die Netzwerk- und CPU-Auslastung auf dem abonnierenden Client. Je nach den Abmessungen des Videos des Abonnenten in der App empfiehlt es sich möglicherweise, eine niedrigere Auflösung zu verwenden. Für Abonnenten eines Streams, der weniger wichtig (und kleiner) ist als andere Streams, empfiehlt es sich möglicherweise, eine niedrigere Bildrate oder Auflösung zu verwenden.

Diese Eigenschaft gilt nur beim Abonnieren eines Streams, der die Skalierbare Videofunktion. Skalierbare Videos sind verfügbar:

• Nur in Sitzungen, die den Vonage Video API Media Router verwenden (Sitzungen mit dem Medienbetrieb auf geroutet gesetzt).
• Gilt nur für Streams, die von Clients veröffentlicht werden, die skalierbares Video unterstützen (siehe die Dokumentation zu Skalierbare Videofunktion).

Bei Streams, die kein skalierbares Video verwenden, hat die Einstellung dieser Eigenschaft keine Auswirkung.

Anmerkung: Die Bildrate für skalierbare Videostreams wird für jeden Teilnehmer automatisch an die Netzwerkbedingungen und die CPU-Auslastung angepasst, auch wenn Sie diese Eigenschaft nicht festlegen. Legen Sie diese Eigenschaft fest, wenn Sie eine maximale Bildrate für diesen Teilnehmer festlegen möchten.

Die verfügbaren Bildraten richten sich nach der maximalen Bildrate, die für den Stream zur Verfügung steht. Wenn Sie die bevorzugte Bildrate für den Abonnenten festlegen, wählt das Vonage Video API Windows SDK unter Berücksichtigung der Bandbreiten- und CPU-Einschränkungen des Clients die beste verfügbare Bildrate aus, die der bevorzugten Bildrate am nächsten kommt.

Die tatsächlich verfügbaren Bildraten hängen dynamisch von den Netzwerk- und CPU-Ressourcen ab, die dem Publisher zur Verfügung stehen.

Bevorzugte Lösung

Die bevorzugte Auflösung für den Stream des Abonnenten.

Die bevorzugte Auflösung für den Stream des Abonnenten.

Begrenzung der Videoauflösung und Bildfrequenz (Bevorzugte Bildrate) reduziert die Netzwerk- und CPU-Auslastung auf dem abonnierenden Client. Je nach den Abmessungen des Videos des Abonnenten in der App empfiehlt es sich möglicherweise, eine niedrigere Auflösung zu verwenden. Für Abonnenten eines Streams, der weniger wichtig (und kleiner) ist als andere Streams, empfiehlt es sich möglicherweise, eine niedrigere Bildrate oder Auflösung zu verwenden.

Diese Eigenschaft gilt nur beim Abonnieren eines Streams, der die Skalierbare Videofunktion. Skalierbare Videos sind verfügbar:

• Nur in Sitzungen, die den Vonage Video API Media Router verwenden (Sitzungen mit dem Medienbetrieb auf geroutet gesetzt).
• Gilt nur für Streams, die von Clients veröffentlicht werden, die skalierbares Video unterstützen (siehe die Dokumentation zu Skalierbare Videofunktion).

Bei Streams, die kein skalierbares Video verwenden, hat die Einstellung dieser Eigenschaft keine Auswirkung.

Anmerkung: Die Auflösung für skalierbare Videostreams wird für jeden Teilnehmer automatisch an die Netzwerkbedingungen und die CPU-Auslastung angepasst, auch wenn Sie diese Eigenschaft nicht festlegen. Legen Sie diese Eigenschaft fest, wenn Sie eine maximale Auflösung für diesen Teilnehmer festlegen möchten.

Nicht jede Auflösung steht einem Abonnenten zur Verfügung. Wenn Sie die gewünschte Auflösung festlegen, wählt das Vonage Video API Windows SDK die beste verfügbare Auflösung aus, die Ihren Vorgaben entspricht. Die verfügbaren Auflösungen hängen von der maximalen Breite und Höhe ab, die Herausgeber Sätze für den Stream, die von der Stream.Width und Stream.Height Eigenschaften der Stream Objekt. Alle für einen Stream verfügbaren Auflösungen verwenden dasselbe Seitenverhältnis.

VideoRenderer

Der von diesem Abonnenten verwendete Videorenderer.

Legen Sie den Video-Renderer fest, indem Sie den VideoRenderer beim Aufruf des Konstruktors `Subscriber(Context, Stream, IVideoRenderer)`.

Veranstaltungsdokumentation

Netzwerkstatus geändert

Tritt auf, wenn auf der Teilnehmerseite Änderungen der Netzwerkbedingungen festgestellt werden.

Dieses Ereignis wird ausgelöst, wenn sich die Netzwerkbedingungen wesentlich ändern, und liefert Statistiken zur Medienverbindung sowie den Grund für die Änderung.

Stream unterbrochen

Wird aufgerufen, wenn der Stream des Teilnehmers unterbrochen wurde.

Als Reaktion auf den Aufruf dieser Methode sollten Sie möglicherweise eine Benachrichtigung über die Benutzeroberfläche anzeigen, um den Benutzer darüber zu informieren, dass die Verbindung zum Audio-Video-Stream vorübergehend unterbrochen ist und die App versucht, die Verbindung zum Stream wiederherzustellen.

Wenn der Client die Verbindung zum Stream wiederherstellt, sendet der Abonnent die Stream wieder verbunden Ereignis. Andernfalls wird das Sitzung Das Objekt sendet die Session.StreamDropped Veranstaltung.

Stream wieder verbunden

Wird gesendet, wenn der Stream des Abonnenten wieder aufgenommen wird (nach einer vorübergehenden Unterbrechung der Verbindung).

Die Abonnent sendet dieses Ereignis, nachdem es das Stream unterbrochen Veranstaltung.

Video deaktiviert

Wird aufgerufen, wenn der Teilnehmer kein Video mehr empfängt.

Prüfen Sie die reason Eigenschaft der Ereignisargumente, die den Grund für den Stopp des Videos angibt.

Video-Warnung deaktivieren

Wird aufgerufen, wenn der Vonage Video API Media Router feststellt, dass sich die Stream-Qualität verschlechtert hat und das Video deaktiviert wird, sollte sich die Qualität weiter verschlechtern.

Sollte sich die Qualität weiter verschlechtern, deaktiviert der Abonnent das Video und die Abonnent sendet die „VideoDisabled“-Meldung. Wenn sich die Stream-Qualität verbessert, wird die Abonnent löst das Ereignis „VideoDisableWarningLifted“ aus.

Diese Funktion ist nur in Sitzungen verfügbar, die den Vonage Video API Media Router verwenden (Sitzungen, bei denen der Medienmodus auf „routed“ eingestellt ist), nicht jedoch in Sitzungen, bei denen der Medienmodus auf „relayed“ eingestellt ist. (Siehe Der OpenTok Media Router und die Medienmodi).

Diese Methode wird vor allem dann aufgerufen, wenn sich die Verbindungsqualität verschlechtert.

Video-Warnung deaktiviert

Wird aufgerufen, wenn der Vonage Video API Media Router feststellt, dass sich die Stream-Qualität so weit verbessert hat, dass das Deaktivieren des Videos kein unmittelbares Risiko mehr darstellt.

Diese Funktion ist nur in Sitzungen verfügbar, die den Vonage Video API Media Router verwenden (Sitzungen, bei denen der Medienmodus auf „routed“ eingestellt ist), nicht jedoch in Sitzungen, bei denen der Medienmodus auf „relayed“ eingestellt ist. (Siehe Der OpenTok Media Router und die Medienmodi).

Diese Methode wird hauptsächlich aufgerufen, wenn sich die Verbindungsqualität verbessert.

Video aktiviert

Wird aufgerufen, wenn der Videostream des Teilnehmers startet (wenn zuvor kein Video vorhanden war) oder fortgesetzt wird (nachdem das Video deaktiviert wurde).

Prüfen Sie die reason Eigenschaft der Ereignisargumente, die angibt, aus welchem Grund das Video aktiviert wurde.

Videoqualität geändert

Tritt auf, wenn auf der Abonnentenseite ein qualitätsbezogenes Ereignis festgestellt wird.

Dieses Ereignis wird ausgelöst, wenn sich die Qualität des Videostreams des Abonnenten erheblich ändert, beispielsweise bei einer erkannten Videounterbrechung (Pause) oder einem Codec-Wechsel.

Die aktuelle Implementierung löst dieses Ereignis nur bei Videounterbrechungen oder Codec-Wechseln aus. Einfrieren werden intern erfasst und in den Statistiken berücksichtigt, lösen dieses Ereignis jedoch aufgrund ihrer kurzen Dauer und hohen Häufigkeit nicht einzeln aus. Ein Callback wird nur ausgelöst, wenn eine Pause (kein gerenderter Frame für mehr als 5 Sekunden) erkannt wird, da dies eine wesentlichere Unterbrechung der Wiedergabe darstellt.

Die VideoReason Der Wert gibt die Ursache des Ereignisses an und folgt dieser Prioritätsreihenfolge: VideoInterruption, CodecChange.

Diese Veranstaltung unterscheidet sich von Video deaktiviert und Video aktiviert da es qualitätsbezogene Veränderungen und nicht bloße Übergänge zwischen „Track an“ und „Track aus“ meldet. Das Video deaktiviert und Video aktiviert Ereignisse zeigen an, wann die Videospur des Abonnenten deaktiviert oder aktiviert wurde (beispielsweise aufgrund eines Audio-Fallbacks oder von Aktualisierungen der Stream-Eigenschaften). Im Gegensatz dazu liefert dieses Ereignis Diagnoseinformationen zu Ursachen für Qualitätsverluste, wie z. B. Einfrieren, Pausenzahlen und aktualisierte Videostatistiken.

Bei diesem Ereignis wird jede Videounterbrechung berücksichtigt, die fünf Sekunden oder länger dauert. In Fällen wie einem Audio-Fallback oder einer Deaktivierung des Videos wird die Unterbrechung in den Statistiken ebenfalls als Pause erfasst, und es kann ein entsprechendes Ereignis zur Qualitätsänderung ausgelöst werden.

Applications can use this event to respond to quality issues, such as updating UI indicators, logging telemetry, or notifying users.