AudioCue - Editor e player de AudioClip

AudioCue é uma ferramenta para criar, editar e reproduzir assets de áudio com múltiplas variantes em projetos Unity. Ele combina um editor visual de waveform com um sistema de runtime com pooling, componentes prontos para uso e uma API pública.

Agrupe vários AudioClips em um único asset AudioCue, configure como as variantes são selecionadas e controle a reprodução em um só lugar. Cada variante pode ter seu próprio intervalo, peso, fade-in e fade-out.

Recursos principais#

• Assets AudioCue com múltiplas variantes
• Modos Random No Repeat, Weighted Random e Sequential
• Editor visual de waveform
• Configurações independentes de trim e fade para cada variante
• Prévia de áudio direta no Editor
• Exportação WAV com fade e EQ incorporados opcionalmente
• Equalizador não destrutivo de três bandas
• Áudio espacial, curvas de rolloff personalizadas e roteamento AudioMixerGroup
• AudioManager com pooling, limites de vozes e cooldown de reativação
• Overflow controlado e roubo de vozes baseado em prioridade
• AudioHandle com suporte a pause, resume, stop e acompanhamento de estado
• Reprodução global, posicional e seguindo um Transform
• Componentes AudioCuePlayer, AudioCueTrigger e AudioCueMouseTrigger
• API pública com os métodos Play, PlayAt e PlayAttached

Authoring e exportação#

O editor integrado permite definir o intervalo de reprodução diretamente na waveform, configurar fades, ouvir o resultado e exportar o trecho selecionado para um novo arquivo WAV. Os AudioClips originais não são modificados.

O equalizador funciona de forma não destrutiva durante a reprodução e a prévia. Fade e EQ podem ser incorporados opcionalmente ao arquivo WAV exportado.

Runtime#

O AudioManager usa um pool de AudioSource e oferece suporte a limites de vozes simultâneas, cooldowns, vozes temporárias controladas e roubo de vozes baseado em prioridade.

O AudioHandle fornece controle seguro sobre a reprodução ativa, incluindo pause, resume, stop, estado e motivo de término.

Requisitos e compatibilidade#

• Requer o Editor 6000.0.81f1 ou mais recente
• O pacote Input System é exigido pelo assembly de runtime
• O runtime e as ferramentas do editor são independentes do pipeline de renderização
• A cena de demonstração incluída usa o pacote UI e URP 17.0.4

Atualização do Audio Clip Toolkit 1.0#

AudioCue 2.0 é uma atualização importante e incompatível com versões anteriores. Assets, componentes, prefabs e referências serializadas da versão 1.0 não são migrados automaticamente.

Antes de importar a versão 2.0, remova a pasta antiga Assets/AudioClipToolkit, recrie os assets AudioClipData como AudioCue e reconecte os componentes e eventos necessários.

Documentação#

O pacote inclui instruções de instalação, guia de início rápido, guia de authoring do AudioCue, documentação da API, instruções de migração e solução de problemas.

O pacote inclui sons de terceiros sob as licenças CC0 e Pixabay Content License. Os detalhes estão em ThirdParty/ThirdPartyNotices.txt.