Funciones del transformador de medios. Más...

#include "audio_data.h" #include "video_frame.h"
Macros
#define OTC_MEDIA_TRANSFORMER_ERROR_SPACE   0x0A000000
Definiciones de tipos
typedef struct otc_video_transformer otc_video_transformer
typedef struct otc_audio_transformer otc_audio_transformer
Enumeraciones
enum otc_media_transformer_error_code {   OTC_MEDIA_TRANSFORMER_ERROR_INTERNO = 0x0A000000 , OTC_MEDIA_TRANSFORMER_TIPO_NO_VÁLIDO , 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_SÍMBOLO_NO_ENCONTRADO }
enum otc_media_transformer_type { OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM = 0, OTC_MEDIA_TRANSFORMER_TYPE_VONAGE }
Tipos de transformadores de medio disponibles.
Funciones
struct otc_video_transformer * otc_video_transformer_create (enum otc_media_transformer_type tipo, const char *nombre, const char *propiedades, video_transform_callback cb, void *user_data)
struct otc_audio_transformer * otc_audio_transformer_create (enum otc_media_transformer_type tipo, const char *nombre, const char *propiedades, audio_transform_callback cb, void *user_data)
otc_status otc_video_transformer_delete (struct otc_video_transformer *video_transformer)
Elimina un transformador de vídeo. Más...
otc_status otc_audio_transformer_delete (struct otc_audio_transformer *audio_transformer)
Elimina un transformador de audio. Más...
const char * otc_get_media_transformers_error_message (error de int)

Descripción detallada

Funciones del transformador de medios.

Este archivo incluye funciones para trabajar con transformadores multimedia personalizados y con los transformadores de la biblioteca Vonage Media Processor. Para obtener más información, consulta esta guía para desarrolladores.

Nota: Esta funcionalidad solo es aplicable al SDK para macOS de la Video API de Vonage. No funciona en el SDK para Linux de la Video API de Vonage.

Documentación sobre `typedef`

otc_audio_transformer

Transformador de audio de OpenTok.

otc_video_transformer

Transformador de vídeo de OpenTok.

Documentación de funciones

otc_audio_transformer_create()
struct otc_audio_transformer * otc_audio_transformer_create ( enum otc_media_transformer_type tipo,
const char * nombre,
const char * propiedades,
audio_transform_callback cb,
void * datos_usuario
)

Crea una instancia de un transformador de audio personalizado.

Nota: Esta función solo es aplicable al SDK de macOS de la Video API de Vonage. No funciona en el SDK de Linux de la Video API de Vonage. Si se produce un error, se devuelve NULL y se establece «errno».

Parámetros : | | | | | --- | --- | --- | | | tipo | El tipo de transformador. Establecer el valor en OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM para un transformador personalizado. | | | nombre | Un nombre para el transformador personalizado. | | | propiedades | Una cadena JSON con las propiedades del transformador de audio de Vonage. | | [in] | cb | La función de devolución de llamada que realizará una transformación personalizada (no se tiene en cuenta para los transformadores de Vonage) | | [in] | user_data | Datos opacos pasados por el usuario y devueltos en la función de devolución de llamada. |

Devuelve : puntero opaco a un transformador de audio que se va a crear. NULL si se produce un error (lo cual se puede comprobar mediante «errno»).

otc_audio_transformer_delete()
otc_status otc_audio_transformer_delete ( struct otc_audio_transformer * audio_transformer )

Elimina un transformador de audio.

Nota: Esta función solo es aplicable al SDK de macOS de la Video API de Vonage. No funciona en el SDK de Linux de la Video API de Vonage.

Parámetros : | | | | | --- | --- | --- | | [in] | audio_transformer | Puntero opaco al transformador de audio que se va a eliminar. |

otc_get_media_transformers_error_message()
const char * otc_get_media_transformers_error_message ( int error )

Obtiene el mensaje de error asociado al código de error de los transformadores multimedia proporcionado.

Parámetros : | | | | --- | --- | | error | El código de error de los transformadores multimedia. |

Devuelve : El mensaje de error asociado o «null» si no se encuentra ninguna descripción de error para este código.

otc_video_transformer_create()
struct otc_video_transformer * otc_video_transformer_create ( enum otc_media_transformer_type tipo,
const char * nombre,
const char * propiedades,
video_transform_callback cb,
void * datos_usuario
)

Crea una instancia de un transformador de vídeo de Vonage Media Library o de un transformador de vídeo personalizado. Esta función es compatible con el Vonage Client SDK para macOS (pero no con el SDK para Linux). Para obtener más información, consulta Uso de la biblioteca Vonage Media Processor.

Importante: En la versión 2.27.3+ del Client SDK de Vonage Video para macOS, es necesario añadir la biblioteca multimedia de Vonage por separado del Client SDK de Vonage Video para macOS. Para obtener más información, consulta Integración con la biblioteca multimedia de Vonage. Consulta la información adicional en el archivo README.md de la biblioteca multimedia de Vonage.

Si se produce un error, se devuelve NULL y se establece «errno».

Parámetros : | | | | | --- | --- | --- | | | tipo | El tipo de transformador. Establecer el valor en OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM para un transformador personalizado. Establece el valor en OTC_MEDIA_TRANSFORMER_TYPE_VONAGE para un transformador de Vonage Media Library. | | | nombre | El nombre del transformador de Vonage Media Library o un nombre único para el transformador de vídeo personalizado. | | | propiedades | Una cadena JSON con las propiedades del transformador de vídeo de Vonage. | | [in] | cb | La función de devolución de llamada que realizará una transformación personalizada (no se tiene en cuenta para los transformadores de Vonage) | | [in] | user_data | Datos opacos pasados por el usuario y devueltos en la función de devolución de llamada. |

Devuelve : video_transformer: puntero opaco al transformador de vídeo que se va a crear. NULL si se produce un error (lo cual se puede comprobar mediante «errno»).

otc_video_transformer_delete()
otc_status otc_video_transformer_delete ( struct otc_video_transformer * video_transformer )

Elimina un transformador de vídeo.

Nota: Esta función solo es aplicable al SDK de macOS de la Video API de Vonage. No funciona en el SDK de Linux de la Video API de Vonage.

Parámetros : | | | | | --- | --- | --- | | [in] | video_transformer | puntero opaco al transformador de vídeo que se va a eliminar. |