AudioLink é um sistema que analisa e processa áudio interno em diversos fluxos de dados altamente reativos e expõe os dados a Scripts e Shaders.
Os dados de amplitude de áudio por frequência são primeiro lidos brevemente no Udon usando GetOutputData do Unity. Em seguida, ele é enviado à GPU para processamento de sinal e armazenado em buffer em CustomRenderTexture. Em seguida, o CustomRenderTexture é transmitido globalmente (chamado _AudioTexture
), que pode ser captado por shaders no mundo e em todos os avatares.
Adicionada a capacidade de ajustar como o controlador AudioLink é sincronizado. Você pode sincronizar todas as partes, nada ou tudo, exceto os controles de ganho e potência. (fundamental)
Adicionado suporte para fontes de áudio mono duplas, para casos em que você deseja fornecer os canais esquerdo e direito de fontes separadas. (fundamental)
Adicionado um script utilitário para direcionar formas de mesclagem com AudioLink - AudioReactiveBlendshapes. Basta adicionar o script a um GameObject que tenha um SkinnedMeshRenderer para usar. (fundamental)
Adicionado suporte rudimentar para usar AudioLink com o destino de construção WebGL. (fundale, colina)
Reduziu um pouco o volume padrão do avatar pré-fabricado do AudioLink. (pema)
Reduz um pouco o tráfego de rede incorrido pela sincronização do estado do AudioLink. (Happyrobot33)
ThemeColorController.customThemeColors
foi descontinuado porque o comportamento mudou. Use ThemeColorController.SetCustomThemeColors
e ThemeColorController.GetCustomThemeColors
. Esta é uma alteração significativa (pequena).
Corrigido um bug em que a alternância de cores do tema do acorde de cores no controlador não era sincronizada corretamente. (pema)
Antes de atualizar seu projeto, FAÇA UM BACKUP ! A versão mais recente do AudioLink muda muitas coisas - é melhor prevenir do que remediar.
Anote qual AudioSource você está usando para alimentar o AudioLink, esta referência pode ser perdida durante a atualização.
Se você nunca usou o VRChat Creator Companion (VCC) com seu projeto, siga as etapas abaixo. Caso contrário, pule para a etapa 4:
Baixe e instale o VRChat Creator Companion, abra-o.
Utilize a opção “Adicionar” na aba “Projetos” e siga os passos mostrados para adicionar seu projeto ao VCC.
Abra a aba Projetos, selecione seu projeto, pressione o botão “Migrar” e siga os passos mostrados.
Abra a guia Projetos e selecione seu projeto.
No lado direito, encontre o pacote AudioLink e adicione-o. Se não aparecer, certifique-se de ter o botão "Curado" ativado no menu suspenso no canto superior direito.
Em um navegador de arquivos, sem o Unity aberto , navegue até a pasta Assets do seu projeto e exclua a pasta "AudioLink" e o arquivo "AudioLink.meta".
Abra o projeto no Unity.
O atualizador de shader AudioLink pode solicitar que você atualize shaders antigos. Você deve fazer isso se o seu projeto usar algum shader personalizado habilitado para AudioLink.
Se você estava usando ativos da cena de exemplo do AudioLink, você terá que importá-los, pois eles não são importados por padrão. Para fazer isso, use "AudioLink -> Abrir cena de exemplo do AudioLink" no menu superior do editor.
Se você estava usando componentes AudioReactiveObject ou AudioReactiveLight, pode ser necessário reativar manualmente os "Dados de áudio" nas configurações "experimentais" do AudioLink. Este recurso agora é considerado experimental até que o VRChat talvez nos forneça uma leitura assíncrona nativa.
Em cenas contendo versões antigas do AudioLink:
Exclua os pré-fabricados AudioLink e AudioLinkController da cena.
Adicione novamente AudioLink e AudioLinkController à cena arrastando os pré-fabricados da pasta Packages/com.llealloo.audiolink/Runtime.
Clique no botão "Vincular todos os objetos reativos ao som a este AudioLink" no painel do inspetor do AudioLink.
Arraste o AudioSource que você estava usando anteriormente para o parâmetro da fonte de áudio AudioLink.
NOTA: Se você usou AudioLinkInput anteriormente, você pode continuar fazendo isso, porém agora em 0.2.5+ o AudioLink é muito mais inteligente em relação às entradas. Tente arrastá-lo direto para o parâmetro AudioLink/fonte de áudio!
Em um navegador de arquivos, exclua a pasta “Assets/AudioLink” e o arquivo “AudioLink.meta”.
Siga as etapas de "Configuração inicial" para projetos de avatar descritas abaixo.
Quer testar um avatar? Consulte a seção "Para teste de avatar VRC". Caso contrário, consulte a seção "Para mundos VRC e outros casos de uso" após a instalação.
Baixe e instale o VRChat Creator Companion (VCC), abra-o.
Adicione seu projeto ao VCC:
Caso queira criar um novo projeto, utilize a opção “Novo” na aba “Projetos” e siga os passos ali indicados.
Caso queira utilizar um projeto existente, utilize a opção “Adicionar” na aba “Projetos” e siga os passos ali indicados.
Abra a guia Projetos e selecione seu projeto. Se você nunca usou o VCC com o projeto, use o botão “Migrar” para atualizá-lo.
No lado direito, encontre o pacote AudioLink e adicione-o. Se não aparecer, certifique-se de ter o botão "Curado" ativado no menu suspenso no canto superior direito.
Neste ponto, a instalação está concluída. Para abrir seu projeto, você pode usar o botão "Abrir Projeto" no VCC.
Para instalação em Linux e macOS, e para usuários de Windows que preferem a linha de comando, recomendamos usar vrc-get
. Isso ocorre porque ele é de código aberto e, no momento em que este artigo foi escrito, vpm
tinha bugs não resolvidos que podem impedi-lo de funcionar em alguns sistemas.
Instale vrc-get
Abra um console e cd /path/to/your/project
Execute vrc-get i audiolink
Instale o vpm e siga as instruções de configuração
Execute vpm add package com.llealloo.audiolink -p /path/to/your/unity/project
Baixe e importe a versão mais recente do UnityPackage AudioLink em https://github.com/llealloo/vrc-udon-audio-link/releases.
Use o item de menu "Ferramentas/AudioLink/Adicionar AudioLink Prefab à cena". Deve funcionar imediatamente.
Após a instalação, para usar o AudioLink:
Se você quiser ver a cena de exemplo, use o botão "AudioLink/Open AudioLink Sample Scene" no menu superior do editor ou use o item de menu "Tools/AudioLink/Add AudioLink Prefab to Scene".
Em AudioLinkAvatar/AudioLinkInput, adicione uma faixa de música ao AudioClip no AudioSource.
Entre no modo de jogo para testar seu avatar.
Clique no botão "Vincular todos os objetos reativos ao som..." no AudioLink MonoBehaviour para vincular tudo.
Silent Cel Shading Shader da Silent
Mochies Unity Shaders por Mochie
Fire Lite da Rollthered
Iluminação de palco VR da AcChosen
Poiyomi Shader por Poiyomi
orels1 AudioLink Shader por orels1
Coisas VRC por _pi_
ShaderForge-AudioLink por lethanan
Adaptador AudioLink-USharpVideo da Blabz
ProTV por ArchiTechAnon
Fosfenólico pela magia matemática, programação conceptual, depuração, ajuda de design e apoio emocional!!!
cnlohr pela ajuda com o novo espectrograma DFT e por ajudar a portar o AudioLink para código 100% shader
lox9973 para funcionalidade de autocorrelação e ajuda matemática inspiradora e tangencial no processamento de sinal
Texelsaur para o AudioLinkMiniPlayer e suporte!
Pema pela ajuda no fortalecimento da base de código e inspiração!
3 por se juntar à equipe AudioLink, ajudando a manter a base de código e sendo fundamental no lançamento da versão 0.3.0.
Merlin por fazer o UdonSharp e oferecer muitas dicas ao longo do caminho. Obrigado Merlim!
Orels1 por toda a grande ajuda com MaterialPropertyBlocks e shaders e o script de configuração automática para testes locais AV3 fáceis
Xiexe pela ajuda no desenvolvimento e teste
Thryrallo pela ajuda na configuração da funcionalidade de teste AV3 local
CyanLaser para fazer CyanEmu
Lyuma por ajudar de várias maneiras e ser super gentil!
ACIIL para a verificação de textura nomeada em AudioLink.cginc
fuopy por ser incrível e refletir ótimas vibrações neste projeto
Coronel Cthulu por ter iniciado a ideia de tornar os dados de áudio visíveis para os avatares
jackiepi pela magia matemática, apoio emocional e inspiração
Barry e OM3 por atiçarem meu fogo!
Lâmpada para o incrível exemplo de música e inspiração. Siga-os!! https://soundcloud.com/lampdx
Shelter, Loner, Rizumu e todas as outras comunidades de dança no VRChat por fazerem isso
rrazgriz por criar e implementar o suporte yt-dlp para testes de editor
LucHeart e DomNomNom por manterem os forks CVR do AudioLink e nos deixarem adotar seu trabalho
Rollthered por nos fornecer músicas para fins de demonstração.
fundale para descobrir o suporte WebGL
todos os outros colaboradores e nossa comunidade por sua ajuda e apoio