
Partager:
Oleksii est Developer Advocate chez Vonage, auteur et conteur. Il s'intéresse à l'IA/ML, aux communications unifiées, aux technologies de l'éducation, aux technologies cloud et à l'open source.
Diffuser un flux audio pendant un appel téléphonique avec Python et Vonage
Temps de lecture : 13 minutes
Cet article a été mis à jour en août 2026
Il existe de nombreuses raisons pour lesquelles vous pourriez vouloir diffuser un flux audio au cours d'un appel. Un cas d'utilisation courant est celui où les développeurs souhaitent mettre l'appelant en attente afin de l'aider à se détendre ; vous pouvez alors diffuser de la musique qui lui permettra de réduire son niveau de stress.
Voici quelques exemples de scénarios :
Diffusion d'une musique d'attente pour les appelants
Conférence téléphonique : diffusez de la musique pendant la conférence téléphonique jusqu’à ce que le quorum soit atteint
Message préenregistré : utile lorsque Vonage ne prend pas en charge votre langue dans son moteur de synthèse vocale
Messagerie vocale : lorsque vous appelez et laissez un message, celui-ci peut être écouté lors d'un appel ultérieur
Vous trouverez ci-dessous comment mettre en œuvre les scénarios 1 et 2. Les autres scénarios sont abordés dans d'autres articles de blog.
Il existe également deux méthodes pour diffuser un flux audio lors d'un appel :
Utilisation d'un objet de contrôle d'appel (NCCO)
Utilisation de la Voice API
Vous utiliserez la méthode 1 pour le scénario 1 et la méthode 2 pour le scénario 2.
Comment diffuser du son en direct lors d'un appel avec Vonage
Les objets de contrôle d'appel (NCCO) constituent un moyen pratique de contrôler un appel entrant. Les NCCOs consistent en une configuration JSON qui décrit comment gérer l'appel. Il existe un guide de référence détaillé sur les NCCO où sont décrites les nombreuses actions qui peuvent être effectuées. Une seule action nous intéresse dans nos scénarios, stream. Il existe en fait deux façons d'utiliser l'action stream de deux manières : synchrone et asynchrone. Asynchrone signifie que l'appelant peut interrompre l'audio stream à l'aide du clavier du téléphone. Certaines options d'action de flux sont intéressantes :
Syntaxe | Description |
|---|---|
| Un tableau contenant une seule URL pointant vers un fichier audio au format MP3 ou WAV (16 bits) à diffuser en continu lors de l'appel ou de la conversation. |
| Réglez le niveau audio du flux dans la plage |
| Si cette option est définie sur |
| Nombre de fois où l'enregistrement audio est répété avant la fin de l'appel. La valeur par défaut est 1. Définissez cette valeur sur 0 pour une lecture en boucle infinie. |
Consultez la documentation pour en savoir plus sur les options de Stream.
Voici un exemple de code permettant de lire un fichier audio au cours d'un appel à l'aide du SDK Python de Vonage en définissant un answer webhook :
@app.route("/webhooks/answer", methods=["POST"])
def answer_call():
"""
Answer a call to your Vonage virtual number by playing music
"""
ncco: list[NccoAction] = [
Stream(streamUrl=[STREAM_URL]),
]
return [action.model_dump(by_alias=True, exclude_none=True) for action in ncco]Les formats de fichiers audio pris en charge sont MP3 et WAV 16 bits.
Nous avons déjà développé une application Vonage de base permettant de recevoir un appel et de diffuser de la musique pendant celui-ci, selon deux scénarios. Avec cette application de base, vous devez ajouter vos identifiants au .env fichier, puis de la déployer à l’aide de GitHub Codespaces. Un Codespace est un environnement de développement hébergé dans le cloud GitHub. Les GitHub Codespaces sont personnalisables pour chaque projet, et les utilisateurs peuvent choisir le système d’exploitation Linux à utiliser, rediriger les ports couramment utilisés, définir des variables d’environnement, etc. Vous pouvez également modifier l’ application de départ et faire des essais.
Conditions préalables
Python 3.x
Créer un Account API Vonage
Créer une nouvelle application Vonage
Pour créer une application, allez à la page Créer une application sur le tableau de bord de Vonage, et définissez un nom pour votre application.
Si vous avez l'intention d'utiliser une API qui utilise des Webhooks, vous aurez besoin d'une clé privée. Cliquez sur "Générer une clé publique et privée", votre téléchargement devrait démarrer automatiquement. Conservez-la en lieu sûr ; cette clé ne peut pas être retéléchargée si elle est perdue. Elle suivra la convention de nommage suivante private_<votre identifiant d'application>.key. Cette clé peut maintenant être utilisée pour authentifier les appels à l'API. Remarque : votre clé ne fonctionnera pas tant que votre application n'aura pas été sauvegardée.
Choisissez les fonctionnalités dont vous avez besoin (par exemple, Voice, Messages, RTC, etc.) et fournissez les webhooks requis (par exemple, URL d'événement, URL de réponse ou URL de message entrant). Ces éléments seront décrits dans le tutoriel.
Pour sauvegarder et déployer, cliquez sur "Générer une nouvelle application" pour finaliser la configuration. Votre application est maintenant prête à être utilisée avec les API de Vonage.
Configuration de votre environnement
Fork ce dépôt. Ouvrez-le dans Codespaces en cliquant sur « Créer un codespace sur la page principale ». Vous pouvez également déployer l'application avec Python et ngrok. Les instructions relatives à cette méthode se trouvent dans le fichier README du dépôt README.
Obtention et configuration de vos secrets
Vous aurez besoin de votre identifiant d'application Vonage et de votre private.key pour que cet exemple d'application fonctionne.
Dans le tableau de bord des développeurs Vonage de votre application, cliquez sur le bouton « Générer une clé publique et une clé privée ». Un fichier sera alors téléchargé. Conservez ce fichier en lieu sûr et ne le communiquez à personne !
Dans votre Codespace, créez un fichier nommé
.envet copiez-collez le contenu de.env.template. Remplacez le paramètre par défautVONAGE_APPLICATION_IDpar votre propre ID d'application.Dans votre Codespace, créez un fichier nommé
private.key. Copiez-collez le contenu du fichier que vous avez téléchargéprivate.keydans ce fichier, puis mettez à jour la valeur du paramètre de remplacementVONAGE_PRIVATE_KEYdans votre.envfichier afin qu’il pointe vers votre fichier de clé privée nouvellement créé.
Dans le terminal Codespace, exécutez les commandes suivantes :
Ensuite, exécutez cette commande :
Copiez-collez les résultats de ces commandes dans l' URL de réponse et URL de l'événement conformément aux champs des paramètres des Applications Vonage.
Copy the generated URLs and paste them into the Answer URL and Event URL fields in your Vonage Application settings.Diffuser un flux audio pendant votre appel à l'aide d'un NCCO
Dans ce scénario, les utilisateurs appelleront un numéro Vonage et de la musique sera diffusée en continu pendant l'appel à l'aide d'un NCCO avec une stream action. Nous utiliserons le scenario-1.py fichier :
from dotenv import load_dotenv
from flask import Flask, request, jsonify
from vonage_voice import NccoAction, Stream
from os import environ as env
# Load environment variables from a .env file:
load_dotenv(".env")
# Load in configuration from environment variables:
STREAM_URL = env["STREAM_URL"]
app = Flask(__name__)
@app.route("/webhooks/answer", methods=["POST"])
def answer_call():
"""
Answer a call to your Vonage virtual number by playing music
"""
ncco: list[NccoAction] = [
Stream(streamUrl=[STREAM_URL]),
]
return [action.model_dump(by_alias=True, exclude_none=True) for action in ncco]
@app.route("/webhooks/event", methods=["POST"])
def events():
return "200"
if __name__ == "__main__":
app.run(host="localhost", port=9000) Essayez-le
Vous pouvez exécuter votre code dans Codespaces en suivant les étapes suivantes.
Installer les dépendances :
Lancez votre application à l'aide de la commande suivante :
Dans le terminal, ouvrez l'onglet Port (onglet). Cliquez sur Private dans la colonne Visibility et remplacez-la par Public.
Change the port visibility to Public so Vonage can reach your local webhook.Dans ce scénario, la succession des événements est la suivante :
Composez votre numéro Vonage
Vonage reçoit l'appel
Un callback est généré sur l'
answerURL du webhook que vous avez spécifiéeVotre application reçoit le rappel et répond avec un NCCO
Une musique est diffusée pendant votre appel
Diffuser un flux audio pendant votre appel à l'aide de la Voice API
Dans ce scénario, vous appelez votre numéro Vonage et vous êtes intégré à une conférence (dans notre cas, la « Soothing Conference »). Vous pouvez ensuite accéder à l' /stream URL pour lancer la diffusion en continu dans la conférence. La musique est alors diffusée dans votre conférence via la Voice API.
Essayez-le
Vous pouvez exécuter votre code dans Codespaces en suivant les étapes suivantes.
Installer les dépendances :
Lancez votre application à l'aide de la commande suivante :
Dans le terminal, ouvrez l'onglet Port (onglet). Cliquez sur Private dans la colonne Visibility et remplacez-la par Public.
Change the port visibility to Public so Vonage can reach your local webhook.Vous êtes désormais prêt à diffuser du contenu audio !
Faites ces choses supplémentaires :
Composez votre numéro Vonage
Exécutez la commande suivante dans la nouvelle fenêtre de terminal
echo "https://${CODESPACE_NAME}-9000.preview.app.github.dev/stream"puis accédez au lien (si vous utilisez un ordinateur local,localhost:9000/stream), et la musique sera diffusée pendant votre conférence
Les actions suivantes se produiront :
Vonage reçoit l'appel
Le callback est généré sur l'
answerURL du webhook que vous avez spécifiéeVotre application reçoit le rappel et répond avec un NCCO
Les participants ont rejoint une conférence téléphonique
Musique diffusée lors de votre conférence
Synthèse
Félicitations ! Vous pouvez utiliser le workflow et les exemples de code fournis pour diffuser du contenu audio associé à un appel et faire jouer de la musique en rapport avec celui-ci lorsque les appelants sont mis en attente.
Autres lectures et ressources
Vous souhaitez en savoir plus, rester en contact ou partager ce que vous êtes en train de créer ?
Continuez à apprendre
Découvrez des cas d'utilisation et des parcours d'apprentissage structurés dans le Centre de formation Vonage
Regardez les tutoriels sur notre chaîne YouTube Vonage Developer
Restez connecté
Abonnez-vous à la newsletter des développeurs Vonage
Suivez-nous sur X pour rester informé
Retrouvez-nous sur LinkedIn
Aidez-nous à améliorer l'expérience des développeurs en remplissant notre formulaire de commentaires « Voice of the Developer »