Funções do transformador de mídia. Mais...

#include "audio_data.h" #include "video_frame.h"
Macros
#define OTC_MEDIA_TRANSFORMER_ERROR_SPACE   0x0A000000
Definições de tipos
typedef struct otc_video_transformer otc_video_transformer
typedef struct otc_audio_transformer otc_audio_transformer
Enumerações
enum otc_media_transformer_error_code {   OTC_MEDIA_TRANSFORMER_ERRO_INTERNO , 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_SÍMBOLO_NÃO_ENCONTRADO }
enum otc_media_transformer_type { OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM = 0, OTC_MEDIA_TRANSFORMER_TYPE_VONAGE }
Tipos disponíveis de transformadores de mídia.
Funções
struct otc_video_transformer * otc_video_transformer_create (enum otc_media_transformer_type tipo, const char *nome, const char *propriedades, video_transform_callback cb, void *user_data)
struct otc_audio_transformer * otc_audio_transformer_create (enum otc_media_transformer_type tipo, const char *nome, const char *propriedades, audio_transform_callback cb, void *user_data)
otc_status otc_video_transformer_delete (struct otc_video_transformer *video_transformer)
Exclui um transformador de vídeo. Mais...
otc_status otc_audio_transformer_delete (struct otc_audio_transformer *audio_transformer)
Exclui um transformador de áudio. Mais...
const char * otc_get_media_transformers_error_message (erro de inteiro)

Descrição detalhada

Funções do transformador de mídia.

Este arquivo inclui funções para trabalhar com transformadores de mídia personalizados e com os transformadores da biblioteca do Vonage Media Processor. Para obter mais informações, consulte este guia para desenvolvedores.

Observação: Essa funcionalidade se aplica apenas ao SDK do macOS da Video API do Vonage. Ela não funciona no SDK do Linux da Video API do Vonage.

Documentação sobre `typedef`

otc_audio_transformer

Transformador de áudio OpenTok.

otc_video_transformer

Transformador de vídeo OpenTok.

Documentação da função

otc_audio_transformer_create()
struct otc_audio_transformer * otc_audio_transformer_create ( enum otc_media_transformer_type tipo,
const char * nome,
const char * propriedades,
audio_transform_callback cb,
void * dados_do_usuário
)

Cria uma instância de um transformador de áudio personalizado.

Observação: Essa função se aplica apenas ao SDK do macOS da Video API do Vonage. Ela não funciona no SDK do Linux da Video API do Vonage. Se ocorrer um erro, é retornado NULL e “errno” é definido.

Parâmetros : | | | | | --- | --- | --- | | | tipo | O tipo do transformador. Defina o valor como OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM para um transformador personalizado. | | | nome | Um nome para o transformador personalizado. | | | propriedades | Uma string JSON com as propriedades do transformador de áudio da Vonage. | | [in] | cb | O callback que realizará uma transformação personalizada (ignorado para transformadores da Vonage) | | [in] | user_data | Dados opacos passados pelo usuário e retornados no callback. |

Retorna : ponteiro opaco ao transformador de áudio a ser criado. NULL caso ocorra um erro (o que pode ser verificado por meio de “errno”).

otc_audio_transformer_delete()
otc_status otc_audio_transformer_delete ( struct otc_audio_transformer * transformador de áudio )

Exclui um transformador de áudio.

Observação: Essa função se aplica apenas ao SDK do macOS da Video API do Vonage. Ela não funciona no SDK do Linux da Video API do Vonage.

Parâmetros : | | | | | --- | --- | --- | | [in] | audio_transformer | ponteiro opaco para o transformador de áudio a ser excluído. |

otc_get_media_transformers_error_message()
const char * otc_get_media_transformers_error_message ( int erro )

Obtém a mensagem de erro associada ao código de erro dos transformadores de mídia fornecidos.

Parâmetros : | | | | --- | --- | | erro | O código de erro dos transformadores de mídia. |

Retorna : A mensagem de erro associada ou nulo, caso não seja encontrada nenhuma descrição de erro para esse código.

otc_video_transformer_create()
struct otc_video_transformer * otc_video_transformer_create ( enum otc_media_transformer_type tipo,
const char * nome,
const char * propriedades,
video_transform_callback cb,
void * dados_do_usuário
)

Cria uma instância de um transformador de vídeo da Vonage Media Library ou de um transformador de vídeo personalizado. Essa função é compatível com o Vonage Client SDK para macOS (não com o SDK para Linux). Para obter mais informações, consulte Utilizando a biblioteca do Vonage Media Processor.

Importante: Na versão 2.27.3+ do Vonage Client SDK para macOS, é necessário adicionar a Biblioteca de Mídia da Vonage separadamente do Vonage Video Client SDK para macOS. Para mais detalhes, consulte Integração com a Biblioteca de Mídia da Vonage. Consulte as informações adicionais no arquivo README.md da Biblioteca de Mídia da Vonage.

Se ocorrer um erro, é retornado NULL e “errno” é definido.

Parâmetros : | | | | | --- | --- | --- | | | tipo | O tipo do transformador. Defina o valor como OTC_MEDIA_TRANSFORMER_TYPE_CUSTOM para um transformador personalizado. Defina o para OTC_MEDIA_TRANSFORMER_TYPE_VONAGE para um transformador da Biblioteca de Mídia da Vonage. | | | nome | O nome do transformador da Biblioteca de Mídia da Vonage ou um nome exclusivo para o transformador de vídeo personalizado. | | | propriedades | Uma string JSON com as propriedades do transformador de vídeo da Vonage. | | [in] | cb | O callback que executará uma transformação personalizada (ignorado para transformadores da Vonage) | | [in] | user_data | Dados opacos passados pelo usuário e retornados no callback. |

Retorna : video_transformer — ponteiro opaco ao transformador de vídeo a ser criado. NULL caso ocorra um erro (o que pode ser verificado por meio de “errno”).

otc_video_transformer_delete()
otc_status otc_video_transformer_delete ( struct otc_video_transformer * video_transformer )

Exclui um transformador de vídeo.

Observação: Essa função se aplica apenas ao SDK do macOS da Video API do Vonage. Ela não funciona no SDK do Linux da Video API do Vonage.

Parâmetros : | | | | | --- | --- | --- | | [in] | video_transformer | ponteiro opaco para o transformador de vídeo a ser excluído. |