otc_audio_device_callbacks
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.
Propiedades
| Nombre | Tipo | Descripción |
|---|---|---|
user_data |
void * | Un puntero a los datos que has configurado en relación con el dispositivo de audio. |
reserved |
void * | Un puntero nulo a un área de memoria que contiene recursos reservados utilizados para la implementación interna. |
Devoluciones de llamada
| Nombre | Descripción |
|---|---|
init(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice. |
destroy(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita que se elimine el dispositivo de audio. |
init_capturer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al capturador de audio que inicialice el dispositivo de audio. |
destroy_capturer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK ha terminado de capturar audio y es el momento de eliminar el capturador de audio del dispositivo de audio. |
start_capturer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al dispositivo de audio que comience a capturar muestras de audio. |
stop_capturer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al capturador de audio del dispositivo de audio que deje de muestrear el audio. |
is_capturer_initialized(audio_device, user_data) → {otc_bool} |
Si el dispositivo se ha inicializado para el muestreo de audio. |
is_capturer_started(audio_device, user_data) → {otc_bool} |
Si el dispositivo ha iniciado el muestreo de audio. |
get_estimated_capture_delay(audio_device, user_data) → {int} |
Se invoca cuando el SDK solicita el retraso estimado de captura del dispositivo de audio, en milisegundos. |
get_capture_settings(audio_device, user_data, settings) → {otc_bool} |
Se invoca cuando el SDK solicita la configuración de captura de audio utilizada por el dispositivo de audio. |
init_renderer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice para la reproducción de audio. |
destroy_renderer(audio_device, user_data) → {otc_bool} |
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. |
start_renderer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al dispositivo de audio que comience a reproducir el audio. |
stop_renderer(audio_device, user_data) → {otc_bool} |
Se invoca cuando el SDK solicita al dispositivo de audio que deje de reproducir audio. |
is_renderer_initialized(audio_device, user_data) → {otc_bool} |
Si el dispositivo se ha inicializado para la reproducción de audio. |
is_renderer_started(audio_device, user_data) → {otc_bool} |
Si el dispositivo ha iniciado la reproducción de audio. |
get_estimated_render_delay(audio_device, user_data) → {int} |
Se invoca cuando el SDK solicita el retraso estimado de reproducción del dispositivo de audio, en milisegundos. |
get_render_settings(audio_device, user_data, settings) → {otc_bool} |
Se invoca cuando el SDK solicita la configuración de reproducción de audio que utiliza el dispositivo. |
init(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
destroy(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita que se elimine el dispositivo de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
init_capturer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al capturador de audio que inicialice el dispositivo de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
destroy_capturer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
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:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
start_capturer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al dispositivo de audio que comience a capturar muestras de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
stop_capturer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al capturador de audio del dispositivo de audio que deje de muestrear el audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
is_capturer_initialized(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Si el dispositivo se ha inicializado para el muestreo de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si el dispositivo está inicializado o no.
is_capturer_started(dispositivo_de_audio, datos_del_usuario) → {otc_bool}
Si el dispositivo ha iniciado el muestreo de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si está en marcha o no.
get_estimated_capture_delay(dispositivo_de_audio, datos_de_usuario) → {int}
Se invoca cuando el SDK solicita el retraso estimado de captura del dispositivo de audio, en milisegundos.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Devoluciones:
El retraso estimado en la captura, en milisegundos.
get_capture_settings(dispositivo_de_audio, datos_de_usuario, configuración) → {otc_bool}
Se invoca cuando el SDK solicita la configuración de captura de audio utilizada por el dispositivo de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
settings |
struct otc_audio_device_settings * | Un puntero a una estructura que contiene los ajustes. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
init_renderer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al dispositivo de audio que se inicialice para la reproducción de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
destroy_renderer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
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:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
start_renderer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al dispositivo de audio que comience a reproducir el audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
stop_renderer(dispositivo_de_audio, datos_de_usuario) → {otc_bool}
Se invoca cuando el SDK solicita al dispositivo de audio que deje de reproducir audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.
is_renderer_initialized(audio_device, user_data) → {otc_bool}
Si el dispositivo se ha inicializado para la reproducción de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si está inicializado o no.
is_renderer_started(audio_device, user_data) → {otc_bool}
Si el dispositivo ha iniciado la reproducción de audio.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si está en marcha o no.
get_estimated_render_delay(dispositivo_de_audio, datos_de_usuario) → {int}
Se invoca cuando el SDK solicita el retraso estimado de reproducción del dispositivo de audio, en milisegundos.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
Devoluciones:
El retraso estimado en la representación, en milisegundos.
get_render_settings(dispositivo_de_audio, datos_de_usuario, configuración) → {otc_bool}
Se invoca cuando el SDK solicita la configuración de reproducción de audio que utiliza el dispositivo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
audio_device |
const otc_audio_device * | Un puntero a la instancia del dispositivo de audio. |
user_data |
void * | Un puntero al `user_data` que has configurado para el dispositivo de audio. |
settings |
struct otc_audio_device_settings * | Un puntero a una estructura que contiene los ajustes. |
Véase: : - otc_bool
Devoluciones:
Valor booleano que indica si se ha producido un error o si la operación se ha realizado correctamente.