Fonctions du transformateur multimédia. En savoir plus...

#include "audio_data.h" #include "video_frame.h"
Macros
#define OTC_MEDIA_TRANSFORMER_ERROR_SPACE   0x0A000000
Définitions de types
typedef struct otc_video_transformer otc_video_transformer
typedef struct otc_audio_transformer otc_audio_transformer
Énumérations
énumération otc_media_transformer_code_d'erreur {   OTC_MEDIA_TRANSFORMER_ERREUR_INTERNE = 0x0A000000 , OTC_MEDIA_TRANSFORMER_TYPE_NON_VALIDE , OTC_MEDIA_TRANSFORMER_NAME_NOT_PROVIDED , OTC_MEDIA_TRANSFORMER_CUSTOM_CALLBACK_NOT_PROVIDED ,   OTC_MEDIA_TRANSFORMER_PROPRIÉTÉS_NON_FOURNIES , OTC_MEDIA_TRANSFORMER_MODEL_NOT_FOUND , OTC_MEDIA_TRANSFORMER_OPENTOK_TRANSFORMERS_LIBRARY_NOT_LOADED , OTC_MEDIA_TRANSFORMER_OPENTOK_TRANSFORMERS_SYMBOLE_INCONNU }
énumération otc_media_transformer_type { OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM = 0 , OTC_MEDIA_TRANSFORMER_TYPE_VONAGE }
Types de transformateurs de média disponibles.
Fonctions
struct otc_video_transformer * otc_video_transformer_create (énumération otc_media_transformer_type type, const char *nom, const char *propriétés, video_transform_callback cb, void *user_data)
struct otc_audio_transformer * otc_audio_transformer_create (énumération otc_media_transformer_type type, const char *nom, const char *propriétés, audio_transform_callback cb, void *user_data)
otc_status otc_video_transformer_delete (struct otc_video_transformer *video_transformer)
Supprime un transformateur vidéo. En savoir plus...
otc_status otc_audio_transformer_delete (struct otc_audio_transformer *audio_transformer)
Supprime un transformateur audio. En savoir plus...
const char * otc_get_media_transformers_message_d'erreur (erreur d'entier)

Description détaillée

Fonctions du transformateur multimédia.

Ce fichier contient des fonctions permettant d'utiliser des transformateurs multimédias personnalisés et ceux de la bibliothèque Vonage Media Processor. Pour plus d'informations, consultez ce guide du développeur.

Remarque : Cette fonctionnalité ne s'applique qu'au SDK macOS de la Video API Vonage. Elle ne fonctionne pas avec le SDK Linux de la Video API Vonage.

Documentation sur `typedef`

otc_audio_transformer

Transformateur audio OpenTok.

otc_video_transformer

Transformateur vidéo OpenTok.

Documentation des fonctions

otc_audio_transformer_create()
struct otc_audio_transformer * otc_audio_transformer_create ( énumération otc_media_transformer_type type,
const char * nom,
const char * propriétés,
audio_transform_callback cb,
void * données_utilisateur
)

Crée une instance d'un transformateur audio personnalisé.

Remarque : Cette fonction s'applique uniquement au SDK macOS de la Video API. Elle ne fonctionne pas dans le SDK Linux de la Video API. En cas d'erreur, la valeur NULL est renvoyée et « errno » est défini.

Paramètres : | | | | | --- | --- | --- | | | type | Le type de transformateur. Définissez la valeur sur OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM pour un transformateur personnalisé. | | | nom | Nom du transformateur personnalisé. | | | propriétés | Chaîne JSON contenant les propriétés du transformateur audio Vonage. | | [in] | cb | La fonction de rappel qui effectuera une transformation personnalisée (ignorée pour les transformateurs Vonage) | | [in] | user_data | Données opaques transmises par l'utilisateur et renvoyées dans la fonction de rappel. |

Retourne : un pointeur opaque vers le transformateur audio à créer. NULL en cas d'erreur (ce qui peut être vérifié via « errno »).

otc_audio_transformer_delete()
otc_status otc_audio_transformer_delete ( struct otc_audio_transformer * audio_transformer )

Supprime un transformateur audio.

Remarque : Cette fonction ne s'applique qu'au SDK macOS de la Video API Vonage. Elle ne fonctionne pas dans le SDK Linux de la Video API Vonage.

Paramètres : | | | | | --- | --- | --- | | [in] | audio_transformer | Pointeur opaque vers le transformateur audio à supprimer. |

otc_get_media_transformers_error_message()
const char * otc_get_media_transformers_error_message ( int erreur )

Récupère le message d'erreur associé au code d'erreur du transformateur multimédia indiqué.

Paramètres : | | | | --- | --- | | erreur | Code d'erreur des transformateurs multimédias. |

Retourne : Le message d'erreur associé ou la valeur null si aucune description d'erreur n'est trouvée pour ce code.

otc_video_transformer_create()
struct otc_video_transformer * otc_video_transformer_create ( énumération otc_media_transformer_type type,
const char * nom,
const char * propriétés,
video_transform_callback cb,
void * données_utilisateur
)

Crée une instance d'un transformateur vidéo de la bibliothèque multimédia Vonage ou d'un transformateur vidéo personnalisé. Cette fonction est prise en charge dans le Client SDK Vonage Video pour macOS (mais pas dans le SDK Linux). Pour plus d'informations, consultez Utilisation de la bibliothèque Vonage Media Processor.

Important : Dans la version 2.27.3+ du Vonage Client SDK pour macOS, vous devez ajouter la bibliothèque multimédia Vonage séparément du Vonage Video Client SDK pour macOS. Pour plus d'informations, consultez Intégration de la médiathèque de Vonage. Consultez les informations complémentaires dans le fichier README.md de la médiathèque Vonage.

En cas d'erreur, la valeur NULL est renvoyée et « errno » est mis à jour.

Paramètres : | | | | | --- | --- | --- | | | type | Le type de transformateur. Définissez la valeur sur OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM pour un transformateur personnalisé. Définissez la valeur sur OTC_MEDIA_TRANSFORMER_TYPE_VONAGE pour un transformateur Vonage Media Library. | | | nom | Le nom du transformateur Vonage Media Library ou un nom unique pour le transformateur vidéo personnalisé. | | | propriétés | Une chaîne JSON contenant les propriétés du transformateur vidéo Vonage. | | [in] | cb | La fonction de rappel qui effectuera une transformation personnalisée (ignorée pour les transformateurs Vonage) | | [in] | user_data | Données opaques transmises par l'utilisateur et renvoyées dans la fonction de rappel. |

Retourne : video_transformer : pointeur opaque vers le transformateur vidéo à créer. NULL en cas d'erreur (à vérifier via « errno »).

otc_video_transformer_delete()
otc_status otc_video_transformer_delete ( struct otc_video_transformer * video_transformer )

Supprime un transformateur vidéo.

Remarque : Cette fonction ne s'applique qu'au SDK macOS de la Video API Vonage. Elle ne fonctionne pas dans le SDK Linux de la Video API Vonage.

Paramètres : | | | | | --- | --- | --- | | [in] | video_transformer | Pointeur opaque vers le transformateur vidéo à supprimer. |