Ein Publisher erfasst einen Audio-Video-Stream aus den von Ihnen angegebenen Quellen. Mehr...

Erbt von IDisposable.

Ausführliche Beschreibung

Ein Publisher erfasst einen Audio-Video-Stream aus den von Ihnen angegebenen Quellen.

Verwenden Sie die Herausgeber.Builder Klasse zum Erstellen einer Herausgeber Beispiel. Anschließend können Sie den Audio-Video-Stream in einer Vonage Video API-Sitzung veröffentlichen, indem Sie die Session.Publish(Publisher) Methode.

Die Herausgeber Die Klasse implementiert die Schnittstelle „System.IDisposable“. Achten Sie darauf, die Methode Dispose() Methode der Herausgeber Das Objekt muss seine Ressourcen freigeben, wenn Sie das Objekt nicht mehr benötigen (zum Beispiel, wenn die Herausgeber (wird entfernt 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

Dispose()

Entsorgt die Herausgeber Ressourcen des Objekts.

Beachten Sie, dass die HerausgeberDie Ressourcen von … sind nicht wird entsorgt, wenn Sie die Session.Publish(Publisher) Methode. Wenn Sie Session.Publish(Publisher), die Ressourcen der Herausgeber Das Objekt wird beibehalten, damit Sie es wiederverwenden können (um es erneut in der Sitzung zu veröffentlichen).

GetRtcStatsReport()

Ruft den RTC-Statistikbericht für den Publisher 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 Subscriber.GetRtcStatsReport().

Dokumentation zur Immobilie

Maximale Videobitrate

Die maximale Videobitrate für den Videostream des Herausgebers (in Bit pro Sekunde).

Diese Eigenschaft legt eine explizite Obergrenze für die Videobitrate des Herausgebers fest. Wird diese Eigenschaft auf 0 gesetzt, wird jede manuelle Begrenzung aufgehoben und das standardmäßige, auf Voreinstellungen basierende adaptive Bitrate-Verhalten ohne explizite Begrenzung wiederhergestellt.

Das Auslesen dieser Eigenschaft gibt die aktuell konfigurierte maximale Bitrate in bps zurück. Wenn keine manuelle Bitrate festgelegt wurde oder eine voreingestellte Bitrate aktiv ist, beträgt der Wert 0.

Der Wert 0 bedeutet, dass keine explizite Bitratenbegrenzung angewendet wird und der Stream nach den Regeln der adaptiven Voreinstellung läuft, um die Qualität zu optimieren.

Video veröffentlichen

TargetScalabilityMode

Der Zielskalierbarkeitsmodus (SVC – Scalable Video Coding) für diesen Publisher. Der Skalierbarkeitsmodus steuert die Anzahl der räumlichen (Auflösung) und zeitlichen (Bildrate) Ebenen, die WebRTC kodiert. Der Modus wird auf den Medienpfad des Media Routers angewendet.

Der Setter kann jederzeit aufgerufen werden – es ist nicht erforderlich, dass die Aushandlung des Medienpfads bereits abgeschlossen ist. Der Modus wird angewendet, sobald der Medienpfad des Media Routers eingerichtet ist.

Wird auf dem Medienpfad des Media Routers ein Nicht-SVC-Codec (VP8, H.264) ausgehandelt, wird der am ehesten passende Modus verwendet: Die räumlichen Ebenen werden auf 1 gesetzt, wobei die zeitliche Dimension beibehalten wird (z. B. L2T2 → L1T2, wenn VP8 ausgehandelt wird).

Der Zuspieler wirft OpenTokException wenn der angeforderte Modus kein gültiger Skalierbarkeitsmodus ist (d. h. nicht zu den Modi L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2 oder L3T3 gehört).

Der Getter gibt den zuletzt an den Setter übergebenen Wert zurück oder „null“, wenn kein Wert explizit festgelegt wurde. Dies entspricht der Absicht des Benutzers und nicht dem tatsächlich angewendeten Modus (der sich aufgrund eines codecabhängigen Fallbacks unterscheiden kann).

Dies ist eine Beta-Funktion.

Voreinstellung für die Videobitrate

Die auf den Videostream des Herausgebers angewendete Strategie zur Voreinstellung der Videobitrate.

Diese Eigenschaft konfiguriert eine vordefinierte Bitrate-Strategie, um ein Gleichgewicht zwischen Videoqualität und Bandbreitennutzung herzustellen. Voreingestellte Konfigurationen und manuelle Bitrate-Einstellungen schließen sich gegenseitig aus. Durch das Festlegen der Eigenschaft „MaxVideoBitrate“ werden alle Voreinstellungen überschrieben und diese Eigenschaft wird automatisch auf VideoBitratePreset.Custom.

Das Auslesen dieser Eigenschaft gibt die derzeit aktive Voreinstellung zurück. Wenn manuell eine benutzerdefinierte Bitrate festgelegt wurde, lautet der Wert VideoBitratePreset.Custom.

Der Standardwert ist VideoBitratePreset.Default.

Anmerkung: Die VideoBitratePreset.Custom Der Wert kann nicht direkt festgelegt werden.

Für weitere Informationen siehe Herausgeber Maximale Bitrate.

Veranstaltungsdokumentation

Netzwerkstatus geändert

Tritt auf, wenn auf der Publisher-Seite Ä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.

Video deaktiviert

Wird aufgerufen, wenn der Publisher die Übertragung des Videos beendet.

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 Publisher feststellt, dass sich der Auslastungsgrad des Netzwerks verschlechtert hat und das Video deaktiviert wird, sollte sich die Auslastung weiter verschlechtern.

Sollte sich die Netzwerkqualität weiter verschlechtern, wird die Herausgeber deaktiviert das Video und sendet die „AudioFallback“-Nachricht. Wenn sich die Stream-Qualität verbessert, wird die Herausgeber löst das Ereignis „VideoDisableWarningLifted“ aus.

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

Video-Warnung deaktiviert

Wird aufgerufen, wenn der Publisher feststellt, dass sich die Netzwerkauslastung so weit verbessert hat, dass das deaktivierte Video kein unmittelbares Risiko mehr darstellt.

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

Video aktiviert

Wird aufgerufen, wenn der Videostream des Anbieters wieder aufgenommen 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 sich der Qualitätsstatus des Videostreams des Anbieters ändert.

Dieses Ereignis liefert aktuelle Videostatistiken sowie einen Fehlercode, der angibt, warum es zu der Qualitätsänderung gekommen ist.

Die VideoReason Der Wert gibt die Ursache des Ereignisses an und folgt dieser Prioritätsreihenfolge: Bandbreitenbeeinträchtigung, CPU-Beeinträchtigung, sonstige Gründe für Qualitätsbeeinträchtigungen, Codec-Änderungen sowie Änderungen der Auflösung oder der Ebene.

Diese Veranstaltung unterscheidet sich von der Video deaktiviert und Video aktiviert Ereignisse, da es qualitätsbezogene Änderungen und nicht bloße Änderungen des Ein-/Aus-Zustands meldet. Das Video deaktiviert und Video aktiviert Ereignisse zeigen an, wann die Videospur des Anbieters deaktiviert oder aktiviert wird (beispielsweise aufgrund eines Audio-Fallbacks oder von Aktualisierungen der Stream-Eigenschaften). Im Gegensatz dazu, Videoqualität geändert liefert diagnostische Erkenntnisse zu den Ursachen für Qualitätseinbußen – wie beispielsweise CPU- oder Bandbreitenbeschränkungen – und kann auch dann ausgelöst werden, wenn die Videowiedergabe weiterhin aktiviert ist.

Applications can use this event to monitor video quality and respond accordingly, such as updating UI indicators or notifying users of performance issues.