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 = 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_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
| typedef struct otc_audio_transformer otc_audio_transformer |
Transformador de áudio OpenTok.
otc_video_transformer
| typedef struct otc_video_transformer 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. |