Le SDK client AOQ prend en charge la lecture audio personnalisée. Le mécanisme de callback de trames audio transmet les données PCM décodées à la couche applicative, vous permettant ainsi d'implémenter votre propre logique de rendu audio.
Présentation
Par défaut, le SDK client AOQ diffuse les données audio distantes reçues via le haut-parleur ou l'écouteur du système. Dans certains cas, le module de lecture audio intégré au SDK peut ne pas répondre à vos besoins. La lecture audio personnalisée s'avère utile lorsque vous devez :
- Diriger les données audio reçues vers un périphérique de lecture spécifique ou un pipeline de traitement audio.
- Post-traiter les données audio reçues, par exemple pour la reconnaissance vocale par IA ou l'application d'effets sonores.
- Contourner des conflits liés aux périphériques de lecture audio.
Prérequis
- Vous avez créé une instance de moteur en appelant
createEngine. - La connexion au serveur est établie (le callback
onConnectionStatusChangea signalé l'étatAoqConnectionStatusConnected).
Mise en œuvre
1. Démarrer la lecture audio en mode externe
Lors de l'appel à startAudioPlayer, définissez isExternal=true pour désactiver le périphérique de rendu audio interne du SDK. La couche applicative assure alors la lecture audio.
Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
isVoipMode | boolean | false | Active ou non le mode VoIP (AEC matériel). Valable sur mobile. |
isDefaultSpeaker | boolean | true | Définit si le haut-parleur est utilisé par défaut. Valable sur mobile. |
isExternal | boolean | false | Indique si le mode de lecture externe est activé. Si vrai, le SDK n'ouvre pas le périphérique de lecture. |
channel | int | 1 | Nombre de canaux |
2. Configurer l'écouteur de callback de trames audio
Appelez setAudioFrameObserver pour enregistrer l'écouteur de callback des données de trames audio. Implémentez la méthode de callback onPlaybackAudioFrame pour recevoir les données PCM de lecture.
3. Activer les callbacks de données de lecture
Appelez enableAudioFrameObserver pour activer les callbacks de trames audio au niveau de la position de lecture. Spécifiez AoqAudioSourcePlayback comme source de données.
Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
sampleRate | int | 48000 | Taux d'échantillonnage audio du callback (Hz) |
channels | int | 1 | Nombre de canaux audio du callback |
mode | AoqAudioObserverMode | AoqAudioObserverModeReadOnly | Mode lecture/écriture |
4. Implémenter le rendu audio personnalisé
Lorsque des données PCM arrivent dans le callback onPlaybackAudioFrame, la couche applicative gère le rendu et la lecture. Les approches courantes incluent :
- Android AudioTrack : Écrire les données PCM sur le périphérique audio système via AudioTrack.
- Reconnaissance vocale par IA : Transmettre les données PCM à un moteur ASR pour la reconnaissance vocale.
- Effets audio : Appliquer des effets sonores aux données PCM avant leur diffusion.
- Stockage sur fichier : Enregistrer les données audio reçues dans un fichier local.
- Le callback
onPlaybackAudioFrames'exécute sur un thread interne du SDK. Le pointeurframe.dataPtrn'est valide que pendant la durée du callback. Pour une utilisation asynchrone des données, copiez-les d'abord. - L'opération
AudioTrack.writeest bloquante. L'écriture directe dans le callback est acceptable car le SDK délivre les callbacks à un rythme contrôlé. - Maintenez le drapeau
mPlayRunningafin d'interrompre le traitement lors de l'arrêt du moteur ou de la lecture.