AudioCue - Éditeur et lecteur AudioClip

AudioCue est un outil permettant de créer, modifier et lire des ressources audio à variantes multiples dans les projets Unity. Il associe un éditeur visuel de forme d'onde à un système runtime avec pool, des composants prêts à l'emploi et une API publique.

Regroupez plusieurs AudioClips dans une seule ressource AudioCue, configurez le mode de sélection des variantes et contrôlez la lecture depuis un seul endroit. Chaque variante peut avoir sa propre plage, son poids, son fade-in et son fade-out.

Fonctionnalités principales#

• Ressources AudioCue à variantes multiples
• Modes Random No Repeat, Weighted Random et Sequential
• Éditeur visuel de forme d'onde
• Réglages de trim et de fade indépendants pour chaque variante
• Préécoute audio directe dans l'Editor
• Export WAV avec fade et EQ éventuellement intégrés
• Égaliseur trois bandes non destructif
• Audio spatial, courbes de rolloff personnalisées et routage AudioMixerGroup
• AudioManager avec pool, limites de voix et cooldown de redéclenchement
• Overflow contrôlé et vol de voix basé sur la priorité
• AudioHandle avec prise en charge de pause, resume, stop et suivi d'état
• Lecture globale, positionnelle et suivant un Transform
• Composants AudioCuePlayer, AudioCueTrigger et AudioCueMouseTrigger
• API publique avec les méthodes Play, PlayAt et PlayAttached

Authoring et export#

L'éditeur intégré vous permet de définir la plage de lecture directement sur la forme d'onde, de configurer les fades, de préécouter le résultat et d'exporter la section sélectionnée vers un nouveau fichier WAV. Les AudioClips d'origine ne sont pas modifiés.

L'égaliseur fonctionne de manière non destructive pendant la lecture et la préécoute. Le fade et l'EQ peuvent facultativement être intégrés au fichier WAV exporté.

Runtime#

AudioManager utilise un pool d'AudioSource et prend en charge les limites de voix simultanées, les cooldowns, les voix temporaires contrôlées et le vol de voix basé sur la priorité.

AudioHandle permet de contrôler en toute sécurité la lecture active, notamment pause, resume, stop, l'état et la raison de fin.

Exigences et compatibilité#

• Nécessite Editor 6000.0.81f1 ou une version ultérieure
• Le package Input System est requis par l'assembly runtime
• Le runtime et les outils d'édition sont indépendants du pipeline de rendu
• La scène de démonstration incluse utilise le package UI et URP 17.0.4

Mise à jour depuis Audio Clip Toolkit 1.0#

AudioCue 2.0 est une mise à jour majeure non rétrocompatible. Les ressources, composants, prefabs et références sérialisées de la version 1.0 ne sont pas migrés automatiquement.

Avant d'importer la version 2.0, supprimez l'ancien dossier Assets/AudioClipToolkit, recréez les ressources AudioClipData en tant que ressources AudioCue et reconnectez les composants et événements nécessaires.

Documentation#

Le package comprend des instructions d'installation, un guide de démarrage rapide, un guide d'authoring AudioCue, la documentation de l'API, des instructions de migration et une aide au dépannage.

Le package contient des sons tiers sous licences CC0 et Pixabay Content License. Les détails se trouvent dans ThirdParty/ThirdPartyNotices.txt.