Dispositivo de audio. Más...

#include <stdlib.h> #include "config.h" #include "base.h"
Estructuras de datos
struct otc_audio_device_settings
struct otc_audio_device_callbacks
Definiciones de tipos
typedef struct otc_audio_device otc_audio_device
Funciones
size_t otc_audio_device_read_render_data (int16_t *buffer, size_t número_de_muestras)
otc_status otc_audio_device_write_capture_data (const int16_t *buffer, size_t número_de_muestras)
otc_status otc_set_audio_device (const struct otc_audio_device_callbacks *funciones de devolución de llamada)
otc_status otc_audio_device_restart_input ()
otc_status otc_audio_device_restart_output ()

Descripción detallada

Dispositivo de audio.

Este archivo incluye la definición del tipo de un dispositivo de audio, junto con las estructuras y funciones que se utilizan con él.

Utiliza un dispositivo de audio para definir un captador de audio personalizado para todos los emisores y un reproductor de audio personalizado para todos los emisores y receptores. Si no utilizas un dispositivo de audio personalizado, la aplicación utilizará el dispositivo de audio predeterminado, es decir, el micrófono y el altavoz del sistema.

Se utiliza un audio personalizado para cualquier emisor y receptor en cualquier sesión a la que se conecte el cliente. Una vez configurado el dispositivo de audio, este se aplica de forma global. Los parámetros de captura y reproducción del dispositivo de audio configurado se utilizan para reproducir y capturar el audio de todos los participantes de la sesión. No es posible configurar un dispositivo de audio únicamente para un emisor o receptor concreto.

Crear una instancia de un otc_audio_device_callbacks estructura, configurando funciones de devolución de llamada para los eventos relacionados con el dispositivo de audio. A continuación, llama a otc_set_audio_device(const struct otc_audio_device_callbacks callbacks) para asociar las funciones de devolución de llamada con el dispositivo de audio que se va a utilizar. Debe llamar a esta función antes de conectarse a una sesión. Además, se trata de una operación global que debe mantenerse durante todo el ciclo de vida de la aplicación.

Llame al otc_audio_device_read_render_data función para recuperar muestras de audio sin procesar.

Llame al otc_audio_device_write_capture_data función para grabar muestras de audio que se incluirán en las retransmisiones que publiques.

Documentación sobre `typedef`

otc_audio_device

Definición del tipo de dispositivo de audio.

Documentación de funciones

otc_audio_device_read_render_data()
size_t otc_audio_device_read_render_data ( int16_t * búfer,
size_t número_de_muestras
)

Recupera muestras de audio sin procesar de la sesión. Estas muestras se mezclan a partir de las transmisiones de la sesión a la que te has suscrito.

Parámetros : | | | | --- | --- | | buffer | El búfer que contiene los datos de audio. | | number_of_samples | El número de muestras solicitadas. |

Devuelve : El número de muestras copiadas del búfer de audio.

otc_audio_device_restart_input()
otc_status otc_audio_device_restart_input ( )

Reinicia el dispositivo de entrada de audio. Este método debe invocarse cada vez que se produzca un cambio en el dispositivo de entrada del dispositivo de audio personalizado, para que el SDK pueda realizar las correcciones necesarias para el nuevo dispositivo. Además, esto activará lo siguiente: otc_audio_device_callbacks métodos, por orden:

  • stop_capturer

  • init_capturer (solo si is_capturer_initialized devuelve «false»)

  • start_capturer (solo si is_capturer_started devuelve «false»)

    Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.

otc_audio_device_restart_output()
otc_status otc_audio_device_restart_output ( )

Reinicia el dispositivo de salida de audio. Este método debe invocarse cada vez que se produzca un cambio en el dispositivo de salida del dispositivo de audio personalizado, para que el SDK pueda realizar las correcciones necesarias para el nuevo dispositivo. Además, esto activará lo siguiente: otc_audio_device_callbacks métodos, por orden:

  • stop_renderer

  • init_renderer (solo si is_renderer_initialized devuelve «false»)

  • start_renderer (solo si is_renderer_started devuelve «false»)

    Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.

otc_audio_device_write_capture_data()
otc_status otc_audio_device_write_capture_data ( const int16_t * búfer,
size_t número_de_muestras
)

Transmite los datos de audio desde el dispositivo de audio para enviarlos a una sesión. Estos datos de audio son utilizados por las transmisiones que publicas en la sesión.

Parámetros : | | | | --- | --- | | buffer | El búfer que contiene los datos de audio. | | number_of_samples | El número de muestras disponibles para copiar. |

Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.

otc_set_audio_device()
otc_status otc_set_audio_device ( const struct otc_audio_device_callbacks * funciones de devolución de llamada )

Establece el dispositivo de audio que se va a utilizar. Debes llamar a esta función antes de conectarte a una sesión. Además, se trata de una operación global que debe mantenerse durante toda la duración de la sesión.

Parámetros : | | | | --- | --- | | callbacks | Un puntero a una estructura de función de devolución de llamada del dispositivo de audio. |

Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.