Funktionen des Medientransformators. Mehr...

#include "audio_data.h" #include "video_frame.h"
Makros
#define OTC_MEDIA_TRANSFORMER_ERROR_SPACE   0x0A000000
Aufzählungen
enum otc_media_transformer_error_code {   OTC_MEDIA_TRANSFORMER_INTERNAL_ERROR = 0x0A000000 , OTC_MEDIA_TRANSFORMER_INVALID_TYPE , OTC_MEDIA_TRANSFORMER_NAME_NOT_PROVIDED , OTC_MEDIA_TRANSFORMER_CUSTOM_CALLBACK_NOT_PROVIDED ,   OTC_MEDIA_TRANSFORMER_PROPERTIES_NOT_PROVIDED , OTC_MEDIA_TRANSFORMER_MODEL_NOT_FOUND , OTC_MEDIA_TRANSFORMER_OPENTOK_TRANSFORMERS_LIBRARY_NOT_LOADED , OTC_MEDIA_TRANSFORMER_OPENTOK_TRANSFORMERS_SYMBOL_NOT_FOUND }
enum otc_media_transformer_type { OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM = 0 , OTC_MEDIA_TRANSFORMER_TYPE_VONAGE }
Verfügbare Typen von Medienwandlern.
Funktionen
struct otc_video_transformer * otc_video_transformer_create (enum otc_media_transformer_type Typ, const char *name, const char *properties, video_transform_callback cb, void *user_data)
struct otc_audio_transformer * otc_audio_transformer_create (enum otc_media_transformer_type Typ, const char *name, const char *properties, audio_transform_callback cb, void *user_data)
otc_status otc_video_transformer_delete (struct otc_video_transformer *video_transformer)
Löscht einen Video-Transformer. Mehr...
otc_status otc_audio_transformer_delete (struct otc_audio_transformer *audio_transformer)
Löscht einen Audio-Transformator. Mehr...
const char * otc_get_media_transformers_error_message (int Fehler)

Ausführliche Beschreibung

Funktionen des Medientransformators.

Diese Datei enthält Funktionen für die Arbeit mit benutzerdefinierten Medientransformatoren und Transformatoren aus der Vonage Media Processor-Bibliothek. Weitere Informationen finden Sie unter dieses Entwicklerhandbuch.

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

Typedef-Dokumentation

otc_audio_transformer

OpenTok-Audio-Transformer.

otc_video_transformer

OpenTok-Videokonverter.

Funktionsdokumentation

otc_audio_transformer_create()
struct otc_audio_transformer * otc_audio_transformer_create ( enum otc_media_transformer_type Typ,
const char * Name,
const char * Eigenschaften,
audio_transform_callback cb,
void * user_data
)

Erstellt eine Instanz eines benutzerdefinierten Audio-Transformators.

Anmerkung: Diese Funktion gilt nur für das Vonage Video API macOS SDK. Im Vonage Video API Linux SDK funktioniert sie nicht. Tritt ein Fehler auf, wird NULL zurückgegeben und „errno“ gesetzt.

Parameter : | | | | | --- | --- | --- | | | Typ | Der Typ des Transformators. Setzen Sie den Wert auf OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM für einen benutzerdefinierten Transformator. | | | name | Ein Name für den benutzerdefinierten Transformator. | | | properties | Eine JSON-Zeichenkette mit den Eigenschaften des Vonage-Audio-Transformators. | | [in] | cb | Der Callback, der eine benutzerdefinierte Transformation durchführt (wird bei Vonage-Transformatoren ignoriert) | | [in] | user_data | Undurchsichtige Daten, die vom Benutzer übergeben und im Callback zurückgegeben werden. |

Rückgabewerte : audio_transformer – Undurchsichtiger Zeiger auf den zu erstellenden Audio-Transformer. NULL, wenn ein Fehler auftritt (dies kann über „errno“ überprüft werden).

otc_audio_transformer_delete()
otc_status otc_audio_transformer_delete ( struct otc_audio_transformer * audio_transformer )

Löscht einen Audio-Transformator.

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

Parameter : | | | | | --- | --- | --- | | [in] | audio_transformer | Undurchsichtiger Zeiger auf den zu löschenden Audio-Transformer. |

otc_get_media_transformers_error_message()
const char * otc_get_media_transformers_error_message ( int Fehler )

Ruft die Fehlermeldung ab, die dem angegebenen Fehlercode des Medientransformators zugeordnet ist.

Parameter : | | | | --- | --- | | Fehler | Der Fehlercode des Medienwandlers. |

Rückgabewerte : Die zugehörige Fehlermeldung oder null, wenn für diesen Code keine Fehlerbeschreibung gefunden wurde.

otc_video_transformer_create()
struct otc_video_transformer * otc_video_transformer_create ( enum otc_media_transformer_type Typ,
const char * Name,
const char * Eigenschaften,
video_transform_callback cb,
void * user_data
)

Erstellt eine Instanz eines Videotransformers aus der Vonage Media Library oder eines benutzerdefinierten Videotransformers. Diese Funktion wird im Vonage Video Client SDK für macOS unterstützt (nicht im Linux-SDK). Weitere Informationen finden Sie unter Verwendung der Vonage Medienprozessor-Bibliothek.

Das ist wichtig: Ab Version 2.27.3+ des Vonage Video-Client SDK für macOS müssen Sie die Vonage Media Library separat vom Vonage Video-macOS-SDK hinzufügen. Weitere Informationen finden Sie unter Integration der Vonage-Mediathek. Weitere Informationen finden Sie in der Datei „README.md“ in der Vonage-Medienbibliothek.

Tritt ein Fehler auf, wird NULL zurückgegeben und „errno“ gesetzt.

Parameter : | | | | | --- | --- | --- | | | Typ | Der Typ des Transformators. Setzen Sie den Wert auf OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM für einen benutzerdefinierten Transformator. Setzen Sie den Wert auf OTC_MEDIA_TRANSFORMER_TYPE_VONAGE für einen Vonage Media Library-Transformer. | | | name | Der Name des Vonage Media Library-Transformers oder ein eindeutiger Name für den benutzerdefinierten Video-Transformer. | | | properties | Eine JSON-Zeichenkette mit den Eigenschaften des Vonage-Video-Transformers. | | [in] | cb | Der Callback, der eine benutzerdefinierte Transformation durchführt (wird bei Vonage-Transformatoren ignoriert) | | [in] | user_data | Undurchsichtige Daten, die vom Benutzer übergeben und im Callback zurückgegeben werden. |

Rückgabewerte : video_transformer – Undurchsichtiger Zeiger auf den zu erstellenden Videotransformer. NULL, wenn ein Fehler auftritt (dies kann über „errno“ überprüft werden).

otc_video_transformer_delete()
otc_status otc_video_transformer_delete ( struct otc_video_transformer * video_transformer )

Löscht einen Video-Transformer.

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

Parameter : | | | | | --- | --- | --- | | [in] | video_transformer | Undurchsichtiger Zeiger auf den zu löschenden Video-Transformer. |