Dispositivo de áudio. Mais...
#include <stdlib.h>
#include "config.h"
#include "base.h"
| Estruturas de Dados | |
| struct | otc_configurações_do_dispositivo_de_áudio |
| struct | otc_audio_device_callbacks |
| Definições de tipos | |
| typedef struct otc_audio_device | otc_audio_device |
| Funções | |
| size_t | otc_audio_device_read_render_data (int16_t *buffer, size_t número_de_amostras) |
| otc_status | otc_audio_device_write_capture_data (const int16_t *buffer, size_t número_de_amostras) |
| otc_status | otc_set_audio_device (const struct otc_audio_device_callbacks *callbacks) |
| otc_status | otc_audio_device_restart_input () |
| otc_status | otc_audio_device_restart_output () |
Descrição detalhada
Dispositivo de áudio.
Este arquivo inclui a definição do tipo de um dispositivo de áudio, juntamente com as estruturas e funções utilizadas com ele.
Use um dispositivo de áudio para definir um capturador de áudio personalizado para todos os emissores e um renderizador de áudio personalizado para todos os emissores e receptores. Se você não usar um dispositivo de áudio personalizado, o aplicativo utilizará o dispositivo de áudio padrão, que utiliza o microfone e o alto-falante do sistema.
Um áudio personalizado é utilizado para qualquer emissor e receptor em qualquer sessão à qual o cliente se conecte. Uma vez configurado, o dispositivo de áudio passa a ter efeito global. Os parâmetros de captura e reprodução do dispositivo de áudio configurado são utilizados para reproduzir e capturar áudio para todos os participantes da sessão. Não é possível configurar um dispositivo de áudio exclusivamente para um determinado emissor ou receptor.
Instanciar um otc_audio_device_callbacks estrutura, definindo funções de retorno de chamada para eventos relacionados ao dispositivo de áudio. Em seguida, chame otc_set_audio_device(const struct otc_audio_device_callbacks callbacks) para associar as funções de retorno de chamada ao dispositivo de áudio a ser utilizado. É necessário chamar essa função antes de se conectar a uma sessão. Além disso, trata-se de uma operação global que deve persistir durante todo o tempo de vida de um aplicativo.
Ligue para o otc_audio_device_read_render_data função para recuperar amostras de áudio não renderizadas.
Ligue para o otc_audio_device_write_capture_data função para gravar amostras de áudio que serão incluídas nas transmissões que você publicar.
Documentação sobre `typedef`
otc_audio_device
| typedef struct otc_audio_device otc_audio_device |
Definição do tipo de dispositivo de áudio.
Documentação da função
otc_audio_device_read_render_data()
| size_t otc_audio_device_read_render_data | ( | int16_t * | buffer, |
| size_t | número_de_amostras | ||
| ) |
Recupera amostras de áudio não renderizadas da sessão. Essas amostras são mixadas a partir dos fluxos da sessão à qual você está inscrito.
Parâmetros : | | | | --- | --- | | buffer | O buffer que contém os dados de áudio. | | number_of_samples | O número de amostras solicitadas. |
Retorna : O número de amostras copiadas do buffer de áudio.
otc_audio_device_restart_input()
| otc_status otc_audio_device_restart_input | ( | ) |
Reinicia o dispositivo de entrada de áudio. Esse método deve ser chamado sempre que ocorrer uma alteração no dispositivo de entrada no dispositivo de áudio personalizado, para permitir que o SDK realize as correções necessárias para o novo dispositivo. Além disso, isso acionará o seguinte otc_audio_device_callbacks métodos, na seguinte ordem:
-
stop_capturer
-
init_capturer (somente se is_capturer_initialized retornar false)
-
start_capturer (somente se is_capturer_started retornar false)
Retornos : Valor de retorno que indica se houve erro ou sucesso.
otc_audio_device_restart_output()
| otc_status otc_audio_device_restart_output | ( | ) |
Reinicia o dispositivo de saída de áudio. Esse método deve ser chamado sempre que ocorrer uma alteração no dispositivo de saída no dispositivo de áudio personalizado, para permitir que o SDK realize as correções necessárias para o novo dispositivo. Além disso, isso acionará o seguinte otc_audio_device_callbacks métodos, na seguinte ordem:
-
stop_renderer
-
init_renderer (somente se is_renderer_initialized retornar false)
-
start_renderer (somente se is_renderer_started retornar false)
Retornos : Valor de retorno que indica se houve erro ou sucesso.
otc_audio_device_write_capture_data()
| otc_status otc_audio_device_write_capture_data | ( | const int16_t * | buffer, |
| size_t | número_de_amostras | ||
| ) |
Envia dados de áudio do dispositivo de áudio para transmissão a uma sessão. Esses dados de áudio são utilizados pelos fluxos que você publica na sessão.
Parâmetros : | | | | --- | --- | | buffer | O buffer que contém os dados de áudio. | | number_of_samples | O número de amostras disponíveis para cópia. |
Retornos : Valor de retorno que indica se houve erro ou sucesso.
otc_set_audio_device()
| otc_status otc_set_audio_device | ( | const struct otc_audio_device_callbacks * | callbacks | ) |
Define o dispositivo de áudio a ser utilizado. É necessário chamar essa função antes de se conectar a uma sessão. Além disso, trata-se de uma operação global que deve permanecer válida durante todo o tempo de duração da sessão.
Parâmetros : | | | | --- | --- | | callbacks | Um ponteiro para uma estrutura de callback de função de dispositivo de áudio. |
Retornos : Valor de retorno que indica se houve erro ou sucesso.