Description
Joue de l'audio dans le navigateur lorsque l'exécution atteint ce nœud. L'audio peut être fourni via une entrée audio (type AUDIO) ou en spécifiant un chemin de fichier dans l'entrée chaîne audio_path (utilisée lorsque l'entrée audio n'est pas connectée). Le nœud offre trois modes de lecture : always (joue à chaque exécution), on_empty_queue (joue seulement lorsque la file d'attente se termine) et on_change (joue seulement lorsque le contenu audio change). Un paramètre de durée limite la longueur de lecture ; réglez-le à 0.0 pour jouer l'intégralité du fichier audio.
Entrées
| Nom | Type | Requis | Défaut | Description |
|---|---|---|---|---|
any_input | ANYTYPE | Non | — | Une entrée passe-partout générique. Permet d'insérer ce nœud dans un flux de travail sans casser les connexions existantes. |
audio | AUDIO | Non | — | Données audio provenant d'un autre nœud (par exemple, une sortie de décodage VAE). Lorsqu'elles sont connectées, c'est la source audio qui sera jouée. |
audio_path | STRING | Oui | "" | Chemin de fichier vers un fichier audio. Utilisé uniquement lorsque l'entrée audio n'est pas connectée. Laissez vide si vous utilisez l'entrée audio. |
mode | COMBO | Oui | "always" | Mode de déclenchement de la lecture. Options : "always" – joue à chaque exécution ; "on_empty_queue" – joue seulement lorsque la file d'attente se termine ; "on_change" – joue seulement lorsque le contenu audio (de l'entrée audio ou du audio_path) change. |
volume | FLOAT | Oui | 0.5 | Volume de lecture, de 0.0 (silencieux) à 1.0 (volume maximum). Taille de pas 0.01. |
duration | FLOAT | Oui | 5.0 | Durée en secondes à jouer. Réglez à 0.0 pour jouer l'intégralité de l'audio. Plage : 0.0 à 300.0, pas 0.1. |
Sorties
| Type | Description |
|---|---|
| ANYTYPE | Transmet la valeur de l'entrée any_input inchangée, assurant la continuité du flux de travail. Si any_input n'est pas connectée, la sortie sera None. |
Notes d'utilisation
- Priorité de la source audio : Lorsque l'entrée
audioest connectée, elle a priorité suraudio_path. Si les deux sont fournies, l'entréeaudioest utilisée. - Comportement du mode :
always– adapté pour les tests ou la lecture continue.on_empty_queue– utile pour jouer un son de notification après qu'un lot de générations se termine.on_change– joue seulement lorsque les données audio réelles (ou le chemin du fichier, siaudio_pathest utilisé) diffèrent de l'exécution précédente. Cela évite la lecture répétée lorsque le nœud est exécuté plusieurs fois avec le même audio.
- Durée : Une valeur de
0.0joue l'intégralité du clip audio. Sinon, la lecture est interrompue après le nombre de secondes spécifié (jusqu'à 300 secondes maximum). - Volume : Le volume est un gain linéaire appliqué à l'audio. Les valeurs supérieures à
1.0ne sont pas autorisées ; pour l'amplification, prétraitez l'audio ailleurs. - Sortie : Le passage direct de
any_inputvous permet d'enchaîner ce nœud sans affecter le flux de données (par exemple, connectez-le en parallèle à un nœud dont vous souhaitez surveiller la sortie audiblement). - Environnement du navigateur : L'audio est joué via le système audio du navigateur. Assurez-vous que votre navigateur a la lecture audio activée et que les politiques de lecture automatique sont satisfaites (le nœud peut nécessiter un geste utilisateur lors de la première exécution).
Commentaires
Connectez-vous avec GitHub pour rejoindre la discussion.