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.