Périphérique audio. En savoir plus...

#include <stdlib.h> #include "config.h" #include "base.h"
Structures de données
struct otc_audio_device_settings
struct otc_audio_device_callbacks
Définitions de types
typedef struct otc_audio_device otc_audio_device
Fonctions
size_t otc_audio_device_read_render_data (int16_t *buffer, size_t nombre_d'échantillons)
otc_status otc_audio_device_write_capture_data (const int16_t *buffer, size_t nombre_d'échantillons)
otc_status otc_set_audio_device (struct const otc_audio_device_callbacks *rappels)
otc_status otc_audio_device_restart_input ()
otc_status otc_audio_device_restart_output ()

Description détaillée

Périphérique audio.

Ce fichier contient la définition de type d'un périphérique audio, ainsi que les structures et les fonctions associées.

Utilisez un périphérique audio pour définir un capteur audio personnalisé pour tous les éditeurs et un rendu audio personnalisé pour tous les éditeurs et abonnés. Si vous n'utilisez pas de périphérique audio personnalisé, l'application utilisera le périphérique audio par défaut, à savoir le microphone et le haut-parleur du système.

Un périphérique audio personnalisé est utilisé pour tous les émetteurs et abonnés de toutes les sessions auxquelles le client se connecte. Une fois le périphérique audio configuré, il s'applique de manière globale. Les paramètres de capture et de restitution du périphérique audio configuré sont utilisés pour la restitution et la capture audio de tous les participants à la session. Il n'est pas possible de configurer un périphérique audio pour un émetteur ou un abonné en particulier.

Instancier un otc_audio_device_callbacks structure, en définissant des fonctions de rappel pour les événements liés au périphérique audio. Appelez ensuite la fonction otc_set_audio_device(const struct otc_audio_device_callbacks callbacks) pour associer ces fonctions de rappel au périphérique audio à utiliser. Vous devez appeler cette fonction avant de vous connecter à une session. De plus, il s’agit d’une opération globale qui doit persister pendant toute la durée de vie d’une application.

Appeler le otc_audio_device_read_render_data fonction permettant de récupérer des échantillons audio non traités.

Appeler le otc_audio_device_write_capture_data fonction permettant de créer des extraits audio qui seront intégrés aux flux que vous publiez.

Documentation sur `typedef`

otc_audio_device

Définition du type de périphérique audio.

Documentation des fonctions

otc_audio_device_read_render_data()
size_t otc_audio_device_read_render_data ( int16_t * tampon,
size_t nombre_d'échantillons
)

Récupère les échantillons audio non traités de la session. Ces échantillons sont issus du mixage des flux de la session à laquelle vous êtes abonné.

Paramètres : | | | | --- | --- | | buffer | Le tampon contenant les données audio. | | number_of_samples | Le nombre d'échantillons demandés. |

Retourne : Le nombre d'échantillons copiés depuis le tampon audio.

otc_audio_device_restart_input()
otc_status otc_audio_device_restart_input ( )

Redémarre le périphérique d'entrée audio. Cette méthode doit être appelée chaque fois qu'un changement de périphérique d'entrée se produit au niveau du périphérique audio personnalisé, afin de permettre au SDK d'effectuer les corrections nécessaires pour le nouveau périphérique. Cela déclenchera également les actions suivantes : otc_audio_device_callbacks méthodes, dans l'ordre :

  • stop_capturer

  • init_capturer (uniquement si is_capturer_initialized renvoie « false »)

  • start_capturer (uniquement si is_capturer_started renvoie « false »)

    Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.

otc_audio_device_restart_output()
otc_status otc_audio_device_restart_output ( )

Redémarre le périphérique de sortie audio. Cette méthode doit être appelée chaque fois qu'un changement de périphérique de sortie survient au niveau du périphérique audio personnalisé, afin de permettre au SDK d'effectuer les corrections nécessaires pour le nouveau périphérique. Cela déclenchera également les actions suivantes : otc_audio_device_callbacks méthodes, dans l'ordre :

  • stop_renderer

  • init_renderer (uniquement si is_renderer_initialized renvoie « false »)

  • start_renderer (uniquement si is_renderer_started renvoie « false »)

    Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.

otc_audio_device_write_capture_data()
otc_status otc_audio_device_write_capture_data ( const int16_t * tampon,
size_t nombre_d'échantillons
)

Transmet les données audio provenant du périphérique audio afin de les diffuser vers une session. Ces données audio sont utilisées par les flux que vous publiez vers la session.

Paramètres : | | | | --- | --- | | buffer | Le tampon contenant les données audio. | | number_of_samples | Le nombre d'échantillons disponibles pour la copie. |

Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.

otc_set_audio_device()
otc_status otc_set_audio_device ( const struct otc_audio_device_callbacks * rappels )

Définit le périphérique audio à utiliser. Vous devez appeler cette fonction avant de vous connecter à une session. De plus, il s'agit d'une opération globale qui doit rester active pendant toute la durée de vie d'une session.

Paramètres : | | | | --- | --- | | callbacks | Pointeur vers une structure de fonction de rappel du périphérique audio. |

Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.