OpenTok Publisher. Mehr...

#include "base.h" #include "config.h" #include "stream.h" #include "video_frame.h" #include "camera_capture_resolution.h" #include "media_transformer.h" #include "video_capturer.h" #include "media_utils.h"

Ausführliche Beschreibung

OpenTok Publisher.

Diese Datei enthält die Typdefinition für einen OpenTok-Publisher sowie mehrere Funktionsdeklarationen.

Typedef-Dokumentation

otc_publisher

Definition des OpenTok-Publisher-Typs.

Ein Typ, der einen Anbieter eines Audio-Video-Streams für eine OpenTok-Sitzung darstellt.

otc_publisher_settings

Typdefinition für OpenTok-Publisher-Einstellungen.

Dokumentation zu Aufzählungstypen

otc_Abbaubarkeit_Präferenz

Beschreibt die Richtlinie, nach der die Video-Engine versucht, die Bildrate und Auflösung an begrenzte Bandbreite und CPU-Leistung anzupassen. Hierbei handelt es sich um eine „Best-Effort“-Richtlinie. Es gibt keine Garantien hinsichtlich der Bildrate, und einige Bilder können aus anderen Gründen dennoch übersprungen werden.

Für weitere Informationen siehe Abbaubarkeitspräferenz.

otc_publisher_error_code

Auflistung der Fehlercodes für OpenTok-Publisher.

Diese Aufzählung enthält verschiedene Fehlercodes, die mit einem Herausgeber in Verbindung stehen.

otc_publisher_video_type

Auflistung der Videoformate des Herausgebers.

Diese Aufzählung enthält die verschiedenen unterstützten Videotypen.

otc_video_bitrate_preset

Voreingestellte Strategien zur Steuerung der Video-Bitrate im Stream eines Anbieters.

Mit diesen Voreinstellungen können Entwickler Bandbreitenstrategien anwenden, ohne die Bitraten manuell festlegen zu müssen. Die Voreinstellungen schließen eine manuelle Bitratenkonfiguration aus.

Für weitere Informationen siehe Herausgeber Maximale Bitrate.

Funktionsdokumentation

otc_publisher_delete()

Gibt eine Publisher-Instanz frei, einschließlich aller damit verknüpften Hardware-Ressourcen.

Parameter : | | | | --- | --- | | publisher | Die zu löschende Publisher-Instanz. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_get_degradation_preference()

Ruft die bevorzugte Richtlinie ab, nach der die Video-Engine die Bildrate und Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst. Eine Beschreibung der möglichen Werte finden Sie unter „otc_degradation_preference“.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. |

Rückgabewerte : Die aktuell eingestellte Degradationseinstellung.

otc_publisher_get_max_video_bitrate()

Ruft die maximale Videobitrate ab, die für den Videostream dieses Publishers festgelegt ist.

Gibt die aktuell konfigurierte maximale Video-Bitrate in Bit pro Sekunde (bps) zurück. Wenn keine manuelle Bitrate über otc_publisher_set_max_video_bitrate(), oder wenn eine Voreinstellung aktiv ist (einschließlich der Standardeinstellung), gibt diese Funktion 0 zurück.

Anmerkung: Ein Rückgabewert von 0 bedeutet, dass keine explizite Bitratenbegrenzung angewendet wird und der Stream stattdessen auf voreingestellten Werten basiert.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. |

Rückgabewert : Die aktuelle maximale Video-Bitrate in Bit pro Sekunde oder 0, falls nicht manuell festgelegt.

otc_publisher_get_name()

Ruft den Namen eines bestimmten Herausgebers ab.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgabewert : Der Name.

otc_publisher_get_publish_audio()

Gibt zurück, ob der Publisher Audio sendet oder nicht.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgaben : Gibt an, ob der Verlag Hörbücher veröffentlicht oder nicht.

otc_publisher_get_publish_captions()

Gibt zurück, ob beim Publisher Untertitel aktiviert sind.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgaben : Gibt an, ob der Herausgeber Bildunterschriften aktiviert hat oder nicht.

otc_publisher_get_publish_video()

Gibt zurück, ob der Herausgeber ein Video veröffentlicht oder nicht.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgaben : Gibt an, ob der Herausgeber Videos veröffentlicht oder nicht.

otc_publisher_get_publisher_id()

Ruft eine eindeutige Kennung für einen Herausgeber ab.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgabewerte : Eine eindeutige Kennung für den Herausgeber. Im Fehlerfall ist dieser Wert null.

otc_publisher_get_rtc_stats_report()

Ruft den RTC-Statistikbericht für den Publisher ab. Dies ist ein asynchroner Vorgang. Erstellen Sie einen otc_publisher_rtc_stats_report_cb Struktur und übergeben Sie sie an die otc_publisher_set_rtc_stats_report_cb Funktion vor dem Aufruf dieser Funktion. Sobald die Statistiken verfügbar sind, wird die otc_publisher_set_rtc_stats_report_cb Callback-Funktion aufgerufen wird.

Siehe auch otc_publisher_callbacks.on_audio_stats, otc_publisher_callbacks.on_video_statsund otc_subscriber_get_rtc_stats_report.

Parameter : | | | | --- | --- | | Herausgeber | Der Herausgeber. |

otc_publisher_get_session()

Gibt die otc_session dieser Publisher-Instanz zugeordnet.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rücksendungen : Die otc_session dieser Instanz zugeordnet. Im Fehlerfall ist der Wert null.

otc_publisher_get_stream()

Gibt den mit dem Publisher verknüpften Stream zurück. Keine Callbacks in otc_publisher_callbacks wird infolge des Aufrufs dieser Methode (oder danach) aufgerufen.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz, von der der Stream abgerufen werden soll. |

Rückgabewert : Der mit dem Publisher verknüpfte Stream. Bei einem Fehler ist dieser Wert null.

otc_publisher_get_target_scalability_mode()

Ruft den Ziel-Skalierbarkeitsmodus ab, der explizit über otc_publisher_set_target_scalability_mode. Gibt den zuletzt an den Setter übergebenen Wert zurück oder NULL, falls der Setter noch nie aufgerufen wurde. Dies spiegelt die Absicht des Benutzers wider, nicht den tatsächlich angewendeten Modus (der aufgrund eines codec-abhängigen Fallbacks abweichen kann).

Dies ist eine Beta-Funktion.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgabewert : Der vom Aufrufer festgelegte Zielskalierbarkeitsmodus oder NULL, falls dieser nicht explizit festgelegt wurde.

otc_publisher_get_user_data()

Ruft die Benutzerdaten für einen bestimmten Herausgeber ab.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgabewerte : Ein Zeiger auf die Benutzerdaten im Speicher.

otc_publisher_get_video_bitrate_preset()

Ruft die derzeit aktive Voreinstellung für die Videobitrate des Streams dieses Publishers ab.

Wenn zuvor mithilfe von otc_publisher_set_max_video_bitrate(), gibt diese Methode den Wert „OTC_VIDEO_BITRATE_PRESET_CUSTOM“ zurück.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. |

Rückgabewerte : Die aktive Bitrate-Voreinstellung.

otc_publisher_get_video_type()

Ruft den Videotyp des Herausgebers ab. Siehe die otc_publisher_set_video_type Funktion.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. |

Rückgabewerte : Der Videotyp des Herausgebers.

otc_publisher_new()

Erstellt eine neue „otc_publisher“-Instanz.

Parameter : | | | | --- | --- | | name | Der Name des Publishers. Andere Clients können die Namen der Streams in der Sitzung abrufen. | | capturer | Verwenden Sie diesen Parameter, wenn Sie einen benutzerdefinierten Video-Capturer bereitstellen möchten. Ist er auf null gesetzt, verwendet der Publisher einen Standard-Video-Capturer, der die Kamera des Systems nutzt. | | callbacks | Ein Zeiger auf die Struktur mit den Zeigern auf die Callback-Funktionen des Publishers. |

Rückgabewert : Eine neue Instanz von `otc_publisher`. Bei einem Fehler ist der Wert `null`.

otc_publisher_new_with_settings()

Erstellt eine neue „otc_publisher“-Instanz.

Parameter : | | | | --- | --- | | callbacks | Ein Zeiger auf die Struktur mit den Zeigern auf die Callback-Funktionen des Publishers. | | settings | Die Struktur „settings“, die die gewünschten Einstellungen für den Publisher enthält. |

Rückgabewert : Eine neue Instanz von `otc_publisher`. Bei einem Fehler ist der Wert `null`.

otc_publisher_set_audio_transformers()

Weist dem Audiostream dieses Publishers ein Array von Audio-Transformatoren zu. Bei „null“ werden die Transformatoren zurückgesetzt.

Das Array kann aus von der ml-Bibliothek bereitgestellten Vonage-Audio-Transformatoren und/oder benutzerdefinierten Transformatoren bestehen. Transformatoren enthalten einen Zeiger auf einen Callback, der bei jedem Audio-Frame aufgerufen wird.

Anmerkung: Diese Funktion gilt nur für das Vonage Video API macOS SDK. Im Vonage Video API Linux SDK funktioniert sie nicht.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. | | [in] | transformers | Array aus undurchsichtigen Zeigern auf `otc_audio_transformer` in der Reihenfolge, in der sie auf den Stream angewendet werden sollen. | | [in] | size | Größe des Arrays. |

Rückgabewerte : im Fehlerfall einen Fehler, andernfalls OTC_SUCCESS.

otc_publisher_set_degradation_preference()

Legt die bevorzugte Richtlinie fest, nach der die Video-Engine die Bildrate und Auflösung an begrenzte Bandbreiten- und CPU-Ressourcen anpasst. Eine Beschreibung der möglichen Werte finden Sie unter „otc_degradation_preference“.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. | | [in] | degradation_preference | Die Degradationseinstellung. |

Rückgabewerte : OTC_SUCCESS oder ein Fehler.

otc_publisher_set_max_audio_bitrate()

Legt die maximale Audio-Bitrate für den Publisher fest.

Parameter : | | | | --- | --- | | publisher | Der betroffene Publisher. | | bitrate | Die gewünschte Bitrate in kbps. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_set_max_video_bitrate()

Ruft die maximale Videobitrate ab, die für den Videostream dieses Publishers festgelegt ist.

Gibt die aktuelle maximale Videobitrate in Bit pro Sekunde (bps) zurück. Wenn keine Bitrate explizit über otc_publisher_set_max_video_bitrate(), oder wenn eine Bitrate-Voreinstellung aktiv ist (einschließlich der Standardvoreinstellung), gibt diese Funktion den Wert 0 zurück.

Anmerkung: Ein Rückgabewert von 0 bedeutet, dass keine manuelle Bitratenbegrenzung aktiv ist und der Stream mit einer voreingestellten Konfiguration läuft.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. |

Rückgabewert : Die aktuelle maximale Video-Bitrate in Bit pro Sekunde oder 0, wenn kein Wert festgelegt wurde oder eine Voreinstellung verwendet wird.

otc_publisher_set_publish_audio()

Ob Audio übertragen werden soll oder nicht. Standardmäßig werden bei Streams sowohl Audio als auch Video übertragen.

Parameter : | | | | --- | --- | | publisher | Der betroffene Publisher. | | publish_audio | Gibt an, ob Audio veröffentlicht werden soll oder nicht. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_set_publish_captions()

Ob Untertitel aktiviert werden sollen oder nicht. Standardmäßig ist diese Option deaktiviert.

Parameter : | | | | --- | --- | | publisher | Der betroffene Publisher. | | publish_captions | Gibt an, ob Untertitel aktiviert werden sollen oder nicht. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_set_publish_video()

Ob Video übertragen werden soll oder nicht. Standardmäßig werden bei Streams sowohl Audio als auch Video übertragen.

Parameter : | | | | --- | --- | | publisher | Der betroffene Publisher. | | publish_video | Gibt an, ob das Video veröffentlicht werden soll oder nicht. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_set_rtc_stats_report_cb()

Legt den Callback für den RTC-Statistikbericht beim Publisher fest.

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. | | cb | Die otc_publisher_rtc_stats_report_cb Struktur, die die Callback-Funktion für den RTC-Statistikbericht enthält. |

Siehe auch : otc_publisher_get_rtc_stats_report.

otc_publisher_set_target_scalability_mode()

Legt den Ziel-Skalierbarkeitsmodus (SVC – Scalable Video Coding) für diesen Publisher fest. Der Skalierbarkeitsmodus steuert die Anzahl der räumlichen (Auflösung) und zeitlichen (Bildrate) Ebenen, die WebRTC codiert. Der Modus wird ausschließlich auf die geroutete Peer-Verbindung (Publisher ↔ SFU) angewendet, unabhängig davon, welche Verbindungsebene derzeit aktiv ist.

Diese Methode kann jederzeit aufgerufen werden – es ist nicht erforderlich, dass die Aushandlung der gerouteten Verbindung bereits abgeschlossen ist. Der Modus wird angewendet, sobald die geroutete Verbindung hergestellt ist.

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

Dies ist eine Beta-Funktion.

Fehler:

• Gibt „OTC_ERROR“ zurück, 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).

Parameter : | | | | --- | --- | | publisher | Die Publisher-Instanz. | | scalability_mode | Der gewünschte Skalierbarkeitsmodus. |

Rückgabewerte : OTC_SUCCESS, wenn der Vorgang erfolgreich ist; andernfalls ein Fehlercode.

otc_publisher_set_video_bitrate_preset()

Legt eine Voreinstellung für die Videobitrate des Videostreams dieses Herausgebers fest.

Wendet eine vordefinierte Strategie für die Videobitrate an, um das Verhalten des Encoders zu steuern. Diese Voreinstellungen dienen dazu, je nach den Anforderungen der Applications ein Gleichgewicht zwischen Videoqualität und Bandbreitennutzung herzustellen.

Anmerkung: Die Voreinstellung „OTC_VIDEO_BITRATE_PRESET_CUSTOM“ kann nicht direkt festgelegt werden. Der Aufruf von otc_publisher_set_max_video_bitrate() überschreibt die Voreinstellung und bewirkt, dass der Preset-Getter den Wert OTC_VIDEO_BITRATE_PRESET_CUSTOM zurückgibt.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. | | [in] | preset | Ein Wert aus otc_video_bitrate_preset um sich zu bewerben. |

Rückgabewerte : im Fehlerfall einen Fehler, andernfalls OTC_SUCCESS.

otc_publisher_set_video_transformers()

Weist dem Videostream dieses Publishers ein Array von Videotransformatoren zu. Bei „null“ werden die Transformatoren zurückgesetzt.

Das Array kann aus von der ml-Library bereitgestellten Vonage-Video-Transformatoren und/oder benutzerdefinierten Transformatoren bestehen. Transformatoren enthalten einen Zeiger auf einen Callback, der bei jedem Videobild aufgerufen wird.

Anmerkung: Diese Funktion gilt nur für das Vonage Video API macOS SDK. Im Vonage Video API Linux SDK funktioniert sie nicht.

Parameter : | | | | | --- | --- | --- | | [in] | publisher | Die Publisher-Instanz. | | [in] | transformers | Array aus undurchsichtigen Zeigern auf `otc_video_transformer` in der Reihenfolge, in der sie auf den Stream angewendet werden sollen. | | [in] | size | Größe des Arrays. |

Rückgabewerte : im Fehlerfall einen Fehler, andernfalls OTC_SUCCESS.

otc_publisher_set_video_type()

Legt den Videotyp des Publishers fest. Standardmäßig ist der Videotyp auf „OTC_PUBLISHER_VIDEO_TYPE_CAMERA“ gesetzt (was angibt, dass die Quelle des Videos eine Kamera ist). Setzen Sie diesen Wert auf „OTC_PUBLISHER_VIDEO_TYPE_SCREEN“, um anzugeben, dass die Videoquelle eine Bildschirmfreigabe ist. Andere Clients können den Videotyp für Streams in der Sitzung erkennen (um den Typ der Videoquelle zu bestimmen).

Parameter : | | | | --- | --- | | publisher | Der betroffene Publisher. | | video_type | Der Videotyp für den Publisher. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_delete()

Löscht eine „otc_publisher_settings“-Instanz.

Parameter : | | | | --- | --- | | settings | Die zu löschende Instanz „otc_publisher_settings“. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_new()

Erstellt eine neue Instanz von „otc_publisher_settings“.

Gibt zurück : Eine neue Instanz von `otc_publisher_settings`

otc_publisher_settings_set_allow_audio_capture_while_muted()

Wenn otc_publisher_settings_set_allow_audio_capture_while_muted wird eingestellt auf false, wird das Mikrofon automatisch ausgeschaltet, sobald alle Redner ihr Mikrofon stummgeschaltet haben. Das Mikrofon wird automatisch wieder eingeschaltet, sobald mindestens ein Redner sein Mikrofon wieder einschaltet. Bei der Einstellung true, Das Mikrofon bleibt immer eingeschaltet, auch wenn alle Publisher ihren Ton stummgeschaltet haben. Beachten Sie, dass bei ausgeschaltetem Mikrofon Callbacks wie „audio_level“ oder „audio_data“ für die Publisher nicht mehr aufgerufen werden. Der Standardwert ist true. Siehe otc_session_new_with_settings.

Parameter : | | | | --- | --- | | settings | Zeiger auf das Objekt mit den Sitzungseinstellungen. | | enable | Boolescher Wert zum Deaktivieren (OTC_FALSE, Standardwert) oder Aktivieren (OTC_TRUE) dieses Flags. |

Rückgabewerte : otc_status Gibt den Status der Operation zurück.

otc_publisher_settings_set_audio_track()

Ermöglicht die Erstellung einer Audiospur für einen Herausgeber mit otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Aktiviert bzw. deaktiviert die Erstellung einer Audiospur für einen Publisher, die mit otc_publisher_new_with_settings. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_auto_gain_control()

Ermöglicht die automatische Lautstärkeregelung für einen Publisher, der mit folgenden Komponenten erstellt wird: otc_publisher_new_with_settings.

Im Vonage Video API Linux SDK funktioniert es nicht.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Gibt an, ob die automatische Verstärkungsregelung aktiviert (true, Standard) oder deaktiviert (false) werden soll. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_default_camera_capture_resolution()

Legt die Aufnahmeauflösung für die Standard-Videoaufzeichnungsfunktionen fest.

Benutzerdefinierte Videoaufzeichnungsgeräte sollten die von otc_publisher_settings_set_default_camera_capture_resolution, dies gilt jedoch nur für Standard-Videoaufzeichnungsprogramme.

Parameter : | | | | --- | --- | | camera_capture_resolution | Die Aufnahmeauflösung der Kamera für Standard-Videoaufzeichnungsgeräte. | | settings | Die betroffene Instanz von „otc_publisher_settings“. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_disable_audio_processing()

Wenn otc_publisher_settings_set_disable_audio_processing wird eingestellt auf true, werden die individuellen Einstellungen für die akustische Echounterdrückung, die automatische Verstärkungsregelung und die Rauschunterdrückung ignoriert, und das Audiosignal wird überhaupt nicht verarbeitet. Der Standardwert ist false. Siehe otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Gibt an, ob die Unterstützung für die Audioverarbeitung aktiviert (true) oder deaktiviert (false, Standard) werden soll. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_echo_cancellation()

Ermöglicht die akustische Echokompensation, damit ein Sender mit folgenden Komponenten aufgebaut werden kann: otc_publisher_new_with_settings.

Anmerkung: Diese Funktion gilt nur für das Vonage Video API macOS SDK. Im Vonage Video API Linux SDK funktioniert sie nicht.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Gibt an, ob die Unterstützung für die akustische Echokompensation aktiviert (true, Standard) oder deaktiviert (false) werden soll. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_name()

Legt den gewünschten Namen für einen zu erstellenden Herausgeber fest otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | name | Der Name des Publishers. Andere Clients können die Namen der Streams in der Sitzung abrufen. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_noise_suppression()

Ermöglicht die Rauschunterdrückung für einen Publisher, der mit folgenden Elementen aufgebaut wird: otc_publisher_new_with_settings.

Anmerkung: Diese Funktion gilt nur für das Vonage Video API macOS SDK. Im Vonage Video API Linux SDK funktioniert sie nicht.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Gibt an, ob die Rauschunterdrückung aktiviert (true, Standard) oder deaktiviert (false) werden soll. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_opus_dtx()

Aktiviert Opus DTX damit ein Publisher erstellt werden kann mit otc_publisher_new_with_settings. Durch die Aktivierung von Opus DTX lässt sich der Bandbreitenverbrauch bei Streams mit langen Stillphasen reduzieren.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Gibt an, ob die Opus-DTX-Unterstützung aktiviert (true) oder deaktiviert (false, Standard) werden soll. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_preferred_video_codecs()

Legt die bevorzugten Videocodecs fest, die für den Stream dieses Publishers verwendet werden sollen.

Mit dieser Funktion lässt sich eine explizite, geordnete Liste von Videocodecs festlegen, denen bei der Aushandlung Vorrang eingeräumt werden soll. Die angegebenen Codecs werden im SDP-Angebot an erster Stelle (in der angegebenen Reihenfolge) aufgeführt, es können jedoch auch andere unterstützte Codecs mit niedrigerer Priorität enthalten sein.

Dies beschränkt die Aushandlung jedoch nicht ausschließlich auf diese Codecs.

Wird eine leere Liste übergeben, wird ein OT_INVALID_PARAMETER-Fehler ausgelöst. Wird diese Funktion nicht aufgerufen, greift das SDK auf das in den Dashboard-Projekteinstellungen definierte Standardverhalten zurück.

Parameter : | | | | | --- | --- | --- | | [in,out] | settings | Die Instanz der Publisher-Einstellungen, die geändert werden soll. | | [in] | codecs | Ein Array mit Videocodecs, die priorisiert werden sollen (darf nicht leer sein). | | [in] | num_codecs | Die Anzahl der Elemente im Array „codecs“. |

Rückgabewerte : OTC_SUCCESS, wenn der Vorgang erfolgreich war; OT_INVALID_PARAMETER, wenn die Liste leer oder ungültig ist.

otc_publisher_settings_set_preferred_video_codecs_automatic()

Aktiviert die automatische Codec-Priorisierung für den Stream dieses Anbieters.

Im automatischen Modus ermittelt das SDK die am besten geeignete Reihenfolge der Codec-Prioritäten und überschreibt dabei die im Dashboard konfigurierten Standard-Projekteinstellungen.

Dies bietet eine einfache Möglichkeit, die Codec-Einstellungen an das SDK zu delegieren, ohne eine Liste manuell angeben zu müssen.

Parameter : | | | | | --- | --- | --- | | [in,out] | Einstellungen | Die Instanz der Publisher-Einstellungen, die geändert werden soll. |

Rückgabewerte : OTC_SUCCESS, wenn der Vorgang erfolgreich ist; andernfalls ein Fehlercode.

otc_publisher_settings_set_publisher_audio_fallback_enabled()

Aktiviert oder deaktiviert die Audio-Fallback-Funktion des Herausgebers.

Wenn die Audio-Fallback-Funktion des Publishers aktiviert ist und der Publisher feststellt, dass sich die Qualität eines Streams erheblich verschlechtert hat, deaktiviert er den Videostream, um die Audioqualität zu erhalten, und sendet den Audiostream weiterhin. Der diesem Publisher zugeordnete Capturer wird nicht deaktiviert, und die erfassten Frames sind auf der Publisher-Seite weiterhin sichtbar.

Die Standardeinstellung lautet OTC_FALSE (die Audio-Fallback-Funktion ist deaktiviert). Bei Verwendung des Bildschirmvideo-Typs in einer Sitzung, die den OpenTok Media Server nutzt, ist die Audio-Fallback-Einstellung des Publishers standardmäßig auf OTC_FALSE gesetzt, damit das Video bei den Abonnenten nicht ausfällt.

Parameter : | | | | --- | --- | | Einstellungen | Die betroffenen Publisher-Einstellungen. | | aktiviert | Ob die Audio-Fallback-Funktion aktiviert werden soll oder nicht. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_scalable_screenshare()

Verwendung von skalierbarem Video zulassen skalierbares Video für einen Verlag, der über die otc_publisher_video_type eingestellt auf OTC_PUBLISHER_VIDEO_TYPE_SCREEN mit otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Aktivieren/Deaktivieren der Verwendung von skalierbarem Video für Bildschirmfreigabe-Streams. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_sender_stats_track()

Ermöglicht die Erstellung eines Absenderstatistikkanals für einen Publisher mit otc_publisher_new_with_settings. Derzeit unterstützt diese Funktion nur Anrufe mit mehr als zwei Teilnehmern. Standardmäßig ist der Kanal für die Absenderstatistik deaktiviert.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Aktiviert bzw. deaktiviert die Erstellung eines Senders-Statistikkanals für einen Publisher mit otc_publisher_new_with_settings. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_stereo()

Ermöglicht die Erstellung von Stereo-Audio für einen Herausgeber mit otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Aktiviert bzw. deaktiviert die Stereo-Audio-Unterstützung für einen Publisher, der mit otc_publisher_new_with_settings. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_subscriber_audio_fallback_enabled()

Aktiviert oder deaktiviert die Audio-Fallback-Funktion für Abonnenten (für Abonnenten des veröffentlichten Streams)

Die Audio-Fallback-Funktion für Teilnehmer ist in Sitzungen verfügbar, die den Vonage Video Media Router nutzen. Ist die Audio-Fallback-Funktion aktiviert (Standardeinstellung), deaktiviert der Vonage Video Media Router das Video für einen bestimmten Teilnehmer, sobald er feststellt, dass die Qualität eines Streams für diesen Teilnehmer erheblich nachgelassen hat, um die Audioqualität zu gewährleisten.

Die Standardeinstellung lautet OTC_TRUE (die Audio-Fallback-Funktion ist aktiviert). Bei Verwendung des Bildschirm-Videotyps ist die Audio-Fallback-Einstellung für Teilnehmer standardmäßig auf OTC_FALSE gesetzt, damit das Video bei den Teilnehmern nicht ausfällt.

Parameter : | | | | --- | --- | | Einstellungen | Die betroffenen Publisher-Einstellungen. | | aktiviert | Ob die Audio-Fallback-Funktion aktiviert werden soll oder nicht. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_video_capturer()

Legt fest, mit welchem Video-Capturer ein Publisher erstellt werden soll otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | capturer | Der Video-Capturer. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.

otc_publisher_settings_set_video_track()

Ermöglicht die Erstellung einer Videospur für einen Publisher mit otc_publisher_new_with_settings.

Parameter : | | | | --- | --- | | settings | Die betroffene Instanz von „otc_publisher_settings“. | | enabled | Aktiviert bzw. deaktiviert die Erstellung einer Videospur für einen Publisher mit otc_publisher_new_with_settings. |

Rückgabewerte : Rückgabewert, der entweder einen Fehler oder einen Erfolg anzeigt.