#include <publisher.h>
Ausführliche Beschreibung
Callback-Funktionen des Herausgebers.
Bei dieser Struktur handelt es sich um eine Reihe von Funktionszeigern auf Callback-Funktionen, die als Reaktion auf Ereignisse im Zusammenhang mit einem OpenTok-Publisher aufgerufen werden können.
Alle Rückrufe erfolgen nicht über die Anwendung oder den Hauptthread, sondern über einen internen Thread. Die Anwendung sollte den Rückruf so schnell wie möglich zurückgeben, um ein Blockieren des internen Threads zu vermeiden.
Daten, die an eine Callback-Funktion übergeben werden (mit Ausnahme von publisher und user_data) wird nach dem Aufruf des Callbacks freigegeben. Erstellen Sie eine Kopie der Daten, falls Sie diese behalten möchten.
Felddokumentation
on_audio_level_updated
| void(* on_audio_level_updated) (otc_publisher *publisher, void *user_data, float audio_level) |
Wird in regelmäßigen Abständen aufgerufen, um den Audiopegel des Publishers zu melden.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | audio_level | Der Wert für die Lautstärke, zwischen 0 und 1,0. |
on_audio_stats
| void(* on_audio_stats) (otc_publisher *publisher, void *user_data, struct otc_verlag_audio_statistiken audio_stats[], size_t Anzahl_der_Statistiken) |
Wird in regelmäßigen Abständen aufgerufen, um Audiostatistiken für den Herausgeber zu melden.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | audio_stats | Ein Array mit den Audio-Statistiken des Publishers. | | number_of_stats | Die Anzahl der Audio-Statistiken im Array. |
on_error
| void(* on_error) (otc_publisher *publisher, void *user_data, const char *error_string, enum otc_publisher_error_code Fehlercode) |
Wird aufgerufen, wenn der Publisher fehlschlägt.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | error_string | Eine Zeichenkette, die die Fehlermeldung enthält. | | error_code | Ein Wert aus der Fehlercode-Enumeration. |
on_publisher_mute_forced
| void(* on_publisher_mute_forced) (otc_publisher *publisher, void *user_data) |
Wird aufgerufen, wenn ein Moderator diesen Publisher dazu gezwungen hat, den Ton stummzuschalten.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. |
on_render_frame
| void(* on_render_frame) (otc_publisher *publisher, void *user_data, const otc_video_frame *Rahmen) |
Wird aufgerufen, wenn ein neuer Frame vom Publisher zur Darstellung bereitgestellt wird.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | frame | Ein Zeiger auf das neue Videobild. |
on_stream_created
| void(* on_stream_created) (otc_publisher *publisher, void *user_data, const otc_stream *Stream) |
Wird aufgerufen, wenn der Stream des Publishers erstellt wird.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | stream | Ein Zeiger auf den Stream. |
on_stream_destroyed
| void(* on_stream_destroyed) (otc_publisher *publisher, void *user_data, const otc_stream *Stream) |
Wird aufgerufen, wenn der Stream des Publishers zerstört wird.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | stream | Ein Zeiger auf den Stream. |
on_video_disable_warning
| void(* on_video_disable_warning) (otc_publisher *publisher, void *user_data) |
Wird aufgerufen, wenn der Publisher feststellt, dass sich die Netzwerkauslastung verschlechtert hat und das Video deaktiviert wird, sollte sich die Qualität weiter verschlechtern.
Parameter : | | | | --- | --- | | publisher | Die Instanz, die diesen Aufruf auslöst. | | user_data | Zeiger auf benutzerdefinierte Daten, die an diese Struktur gebunden sind. |
on_video_disable_warning_aufgehoben
| void(* on_video_disable_warning_lifted) (otc_publisher *publisher, void *user_data) |
Wird aufgerufen, wenn der Publisher feststellt, dass sich die Netzwerkauslastung so weit verbessert hat, dass das deaktivierte Video kein unmittelbares Risiko mehr darstellt.
Parameter : | | | | --- | --- | | publisher | Die Instanz, die diesen Aufruf auslöst. | | user_data | Zeiger auf benutzerdefinierte Daten, die an diese Struktur gebunden sind. |
on_video_disabled
| void(* on_video_disabled) (otc_publisher *publisher, void *user_data, enum otc_video_reason Grund) |
Wird aufgerufen, wenn das Video des Herausgebers deaktiviert ist.
Parameter : | | | | --- | --- | | publisher | Die Instanz, die diesen Aufruf auslöst. | | user_data | Zeiger auf benutzerdefinierte Daten, die an diese Struktur gebunden sind. | | reason | Enthält weitere Details dazu, warum das Video deaktiviert wurde. |
on_video_enabled
| void(* on_video_enabled) (otc_publisher *publisher, void *user_data, enum otc_video_reason Grund) |
Wird aufgerufen, wenn das Video des Herausgebers aktiviert ist.
Parameter : | | | | --- | --- | | publisher | Die Instanz, die diesen Aufruf auslöst. | | user_data | Zeiger auf benutzerdefinierte Daten, die an diese Struktur gebunden sind. | | reason | Liefert weitere Details dazu, warum das Video aktiviert wurde. |
on_video_stats
| void(* on_video_stats) (otc_publisher *publisher, void *user_data, struct otc_verlag_video_statistiken video_stats[], size_t Anzahl_der_Statistiken) |
Wird in regelmäßigen Abständen aufgerufen, um Videostatistiken für den Publisher zu melden.
Parameter : | | | | --- | --- | | publisher | Ein Zeiger auf den Publisher. | | user_data | Ein Zeiger auf die user_data, die Sie für den Publisher festgelegt haben. | | video_stats | Ein Array mit den Videostatistiken des Publishers. | | number_of_stats | Die Anzahl der Videostatistiken im Array. |
reserviert
| void* reserviert |
Ein void-Zeiger auf einen Speicherbereich, der reservierte Ressourcen enthält, die für die interne Implementierung verwendet werden.
user_data
| void* user_data |
Ein Zeiger auf die von Ihnen festgelegten Daten zum Herausgeber.