AudioCue - AudioClip-Editor & Player

AudioCue to narzędzie do tworzenia, edytowania i odtwarzania wielowariantowych zasobów audio w projektach Unity. Łączy wizualny edytor waveformu z pulowanym systemem runtime, gotowymi komponentami oraz publicznym API.

Grupuj wiele AudioClipów w jednym zasobie AudioCue, konfiguruj sposób wyboru wariantów i kontroluj odtwarzanie z jednego miejsca. Każdy wariant może mieć własny zakres, wagę, fade-in i fade-out.

Najważniejsze funkcje#

• Wielowariantowe zasoby AudioCue
• Tryby Random No Repeat, Weighted Random i Sequential
• Wizualny edytor waveformu
• Niezależne ustawienia trim i fade dla każdego wariantu
• Bezpośredni podgląd dźwięku w Editorze
• Eksport WAV z opcjonalnie wypalonym fade i EQ
• Niedestrukcyjny, trzypasmowy equalizer
• Spatial audio, niestandardowe krzywe rolloff i routing AudioMixerGroup
• Pulowany AudioManager z limitami głosów i retrigger cooldown
• Kontrolowany overflow i priority-based voice stealing
• AudioHandle z obsługą pause, resume, stop oraz śledzeniem stanu
• Odtwarzanie globalne, pozycyjne i podążające za Transform
• Komponenty AudioCuePlayer, AudioCueTrigger i AudioCueMouseTrigger
• Publiczne API z metodami Play, PlayAt i PlayAttached

Authoring i eksport#

Wbudowany edytor pozwala ustawić zakres odtwarzania bezpośrednio na waveformie, skonfigurować fade, odsłuchać rezultat oraz wyeksportować wybrany fragment do nowego pliku WAV. Oryginalne AudioClipy nie są modyfikowane.

Equalizer działa niedestrukcyjnie podczas odtwarzania i podglądu. Fade oraz korekcję można opcjonalnie zapisać w eksportowanym pliku WAV.

Runtime#

AudioManager wykorzystuje pulę AudioSource i obsługuje limity jednoczesnych głosów, cooldowny, kontrolowane głosy tymczasowe oraz priority-based voice stealing.

AudioHandle zapewnia bezpieczną kontrolę nad aktywnym odtwarzaniem, w tym pause, resume, stop, stan oraz powód zakończenia.

Wymagania i zgodność#

• Wymaga Editora 6000.0.81f1 lub nowszego
• Pakiet Input System jest wymagany przez assembly runtime
• Runtime i narzędzia edytorowe są niezależne od pipeline’u renderującego
• Dołączona scena demonstracyjna wykorzystuje pakiet UI oraz URP 17.0.4

Aktualizacja z Audio Clip Toolkit 1.0#

AudioCue 2.0 jest dużą, niekompatybilną wstecznie aktualizacją. Zasoby, komponenty, prefaby oraz serializowane referencje z wersji 1.0 nie są migrowane automatycznie.

Przed importem wersji 2.0 należy usunąć stary folder Assets/AudioClipToolkit, odtworzyć zasoby AudioClipData jako AudioCue i ponownie połączyć wymagane komponenty oraz eventy.

Dokumentacja#

Pakiet zawiera instrukcję instalacji, quick start, przewodnik po authoringu AudioCue, dokumentację API, instrukcję migracji oraz rozwiązywanie problemów.

Pakiet zawiera zewnętrzne dźwięki na licencjach CC0 i Pixabay Content License. Szczegóły znajdują się w pliku ThirdParty/ThirdPartyNotices.txt.