#include <audio_device.h>
Descripción detallada
Esta estructura incluye un conjunto de punteros a funciones de devolución de llamada que se utilizan con un dispositivo de audio. El SDK llama a estas funciones cuando se producen eventos relacionados con el dispositivo de audio.
Ninguna de las llamadas de retorno se realizará en el hilo de la aplicación ni en el hilo principal, sino en un hilo interno. La aplicación debe devolver la llamada de retorno lo antes posible para evitar bloquear el hilo interno.
Además de las funciones de devolución de llamada, la estructura incluye un puntero «user_data», que apunta a los datos que puedes configurar en relación con el dispositivo de audio.
Documentación de campo
destruir
| otc_bool(* destruir) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita que se elimine el dispositivo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
destruir_capturador
| otc_bool(* destroy_capturer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK ha terminado de capturar audio y es el momento de eliminar el capturador de audio del dispositivo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
destroy_renderer
| otc_bool(* destroy_renderer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK ha terminado de reproducir el audio y es el momento de destruir el reproductor de audio del dispositivo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
get_capture_settings
| otc_bool(* get_capture_settings) (const otc_audio_device *audio_device, void *datos_usuario, struct otc_audio_device_settings *configuración) |
Se invoca cuando el SDK solicita la configuración de captura de audio utilizada por el dispositivo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. | | settings | Un puntero a una estructura que contiene la configuración. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
obtener_retraso_estimado_de_captura
| int(* get_estimated_capture_delay) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita el retraso estimado de captura del dispositivo de audio, en milisegundos.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Devuelve : El retraso estimado de captura en milisegundos.
get_estimated_render_delay
| int(* get_estimated_render_delay) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita el retraso estimado de reproducción del dispositivo de audio, en milisegundos.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Devuelve : El retraso estimado en la generación de la página, en milisegundos.
get_render_settings
| otc_bool(* get_render_settings) (const otc_audio_device *audio_device, void *datos_usuario, struct otc_audio_device_settings *configuración) |
Se invoca cuando el SDK solicita la configuración de reproducción de audio que utiliza el dispositivo.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. | | settings | Un puntero a una estructura que contiene la configuración. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
init
| otc_bool(* init) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
init_capturer
| otc_bool(* init_capturer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al capturador de audio que inicialice el dispositivo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
init_renderer
| otc_bool(* init_renderer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice para la reproducción de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
is_capturer_initialized
| otc_bool(* is_capturer_initialized) (const otc_audio_device *audio_device, void *datos_usuario) |
Si el dispositivo se ha inicializado para el muestreo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valor devuelto : Valor booleano que indica si el dispositivo está inicializado o no.
Véase también : otc_bool
is_capturer_started
| otc_bool(* is_capturer_started) (const otc_audio_device *audio_device, void *datos_usuario) |
Si el dispositivo ha iniciado el muestreo de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha iniciado o no.
Véase también : otc_bool
is_renderer_initialized
| otc_bool(* is_renderer_initialized) (const otc_audio_device *audio_device, void *datos_usuario) |
Si el dispositivo se ha inicializado para la reproducción de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si está inicializado o no.
Véase también : otc_bool
is_renderer_started
| otc_bool(* is_renderer_started) (const otc_audio_device *audio_device, void *datos_usuario) |
Si el dispositivo ha iniciado la reproducción de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha iniciado o no.
Véase también : otc_bool
reservado
| void* reservado |
Un puntero nulo a un área de memoria que contiene recursos reservados utilizados para la implementación interna.
start_capturer
| otc_bool(* start_capturer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al dispositivo de audio que comience a capturar muestras de audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
start_renderer
| otc_bool(* start_renderer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al dispositivo de audio que comience a reproducir el audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
stop_capturer
| otc_bool(* stop_capturer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al capturador de audio del dispositivo de audio que deje de muestrear el audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
stop_renderer
| otc_bool(* stop_renderer) (const otc_audio_device *audio_device, void *datos_usuario) |
Se invoca cuando el SDK solicita al dispositivo de audio que deje de reproducir audio.
Parámetros : | | | | --- | --- | | audio_device | Un puntero a la instancia del dispositivo de audio. | | user_data | Un puntero a los datos de usuario (user_data) que has establecido para el dispositivo de audio. |
Valores devueltos : Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
Véase también : otc_bool
datos_usuario
| void* datos_de_usuario |
Un puntero a los datos que has configurado en relación con el dispositivo de audio.