Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando esta habilidade estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
HyperFrames Áudio
Uma mixagem é um conjunto de relacionamentos, não uma pilha de processadores. Duas faixas que soam bem isoladamente podem ser insuportáveis juntas, e a correção quase nunca é "diminuir uma" — é descobrir pelo que elas estão competindo e dar isso a quem precisar. Cada ferramenta aqui existe para expressar um desses relacionamentos.
Os efeitos residem no elemento como data-fx-chain, e a prévia e a renderização executam o mesmo grafo de Web Audio — o estúdio em um contexto ao vivo, o motor em um contexto offline dentro do navegador que ele já controla. Há uma única implementação de cada efeito, então o que você ouve durante a prévia é o que é gravado. Você nunca ajusta duas vezes.
A temporização de clipes permanece /hyperframes-core: cortes de áudio/vídeo e intervalos de origem usam data-start, data-duration e data-media-start, e crossfades sobrepõem clipes em faixas diferentes. Esta habilidade controla fade-in/fade-out de faixa colocada, envelopes de crossfade, ganho de faixa/volume de faixa, automação de volume e efeito, ducking/carving de narração e a cadeia de efeitos. /media-use controla sourcing, geração e pré-processamento.
A constante data-playback-rate (0.1..10) é segura para renderização de imagem e som com preservação de tom quando elementos de áudio/vídeo correspondentes usam a mesma temporização, deslocamento de origem e taxa. Uma rampa de velocidade é uma faixa rate em data-automation (veja docs/reference/speed-ramps); ela substitui a constante e mantém o tom na prévia e na renderização. O HyperFrames não fornece sincronização automática de forma de onda ou correção de deriva.
Para receitas copiáveis de corte/crossfade/re-temporização, use /hyperframes-core → references/creator-editing-recipes.md.
Três atributos carregam tudo, no próprio elemento de áudio/vídeo — ou, para os dois primeiros, em um barramento <hf-audio-group> (veja "Um barramento para muitas faixas"):
| Atributo | Contém |
|---|---|
data-fx-chain | os efeitos, em ordem de sinal |
data-automation | envelopes no volume desta faixa ou em seus parâmetros de efeito |
data-fx-carve | as próprias configurações do carve, para que possa ser re-derivado |
As famílias de efeitos fornecidas são gain, EQ (highpass, lowpass, peaking, shelves), compressor, limiter, gate, saturate, delay, reverb, chorus, phaser e bitcrush.
JSON exato para cada um, e as regras que uma faixa deve satisfazer: references/attributes.md.
Cada efeito com seus parâmetros, faixas e unidades: references/fx-registry.md.
Como descobrir o que há de errado com um arquivo que você não pode ouvir:
references/diagnosis.md.
Presets, trabalhos nomeados e perfis de um botão, além de uma tabela de sintoma para correção:
references/presets.md — leia isso antes de construir uma cadeia manualmente, porque um dos presets ou trabalhos nomeados geralmente já nomeia o problema.
Como tudo se encaixa
Duas superfícies de autoria escrevem esses atributos; dois tempos de execução os leem através dos mesmos builders. Esse meio compartilhado é por que a prévia prevê a renderização.
flowchart TB
voz["faixa de narração<br/>arquivo de mídia"]
fundo["fundo musical<br/>arquivo de mídia"]
subgraph AUTORIA["Autoria — as únicas coisas que escrevem atributos"]
painel["Estúdio<br/>Controle de carving de narração"]
script["scripts/carve.mjs<br/>detecta o par"]
analise["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
painel --> analise
script --> analise
end
voz --> analise
fundo --> analise
subgraph ATRIBUTOS["Escrito no elemento de fundo"]
atributoCarve["data-fx-carve<br/>fontes · força"]
atributoCadeia["data-fx-chain<br/>peaking xN + gain, marcado fromCarve"]
atributoAutomacao["data-automation<br/>uma faixa por parâmetro esculpido"]
end
analise --> atributoCarve
analise --> atributoCadeia
analise --> atributoAutomacao
subgraph COMPARTILHADO["Uma implementação, lida por ambos"]
construir["audioFxGraph.ts · buildFxChain"]
agendar["audioFxAutomation.ts · scheduleChainAutomation"]
end
atributoCadeia --> construir
atributoAutomacao --> agendar
construir --> previsualizacao["Prévia<br/>AudioContext ao vivo<br/>attachElementFxChain"]
agendar --> previsualizacao
construir --> renderizacao["Renderização<br/>OfflineAudioContext no navegador headless<br/>applyAudioFxChain"]
agendar --> renderizacao
previsualizacao --> ouvido["o que você ouve durante a prévia"]
renderizacao --> wav["WAV processado<br/>+ chainTailSeconds para que a mixagem deixe a cauda passar"]
wav --> mixagem["motor · audioMixer<br/>faixa de volume incorporada no PCM aqui, não no grafo"]
mixagem --> saida["a mixagem renderizada"]
edicao["editando o atributo durante a reprodução"] -.->|MutationObserver| previsualizacao
As configurações do carve nunca são lidas durante a reprodução — a cadeia e as faixas que ele produziu são o que toca. data-fx-carve existe para que a força possa ser alterada em um carve existente, em vez de ser adivinhada de volta a partir dos filtros.
Dentro de um fundo esculpido, o sinal passa primeiro pelos dips, depois pelo ajuste de nível, depois por tudo que você mesmo construiu — é por isso que um limitador que você adiciona ainda atua como o último teto:
flowchart LR
src["fundo decodificado"] --> p1["peaking<br/>400 Hz"]
p1 --> p2["peaking<br/>1 kHz"]
p2 --> p3["peaking<br/>1.6 kHz"]
p3 --> g["gain<br/>ajuste de nível"]
g --> mao["seus próprios efeitos<br/>ex.: limitador"]
mao --> destino["ganho de faixa, depois saída"]
l1["faixa fx.n1.gain"] -.->|"envelope do nível<br/>da voz nessa banda"| p1
l4["faixa fx.n4.gain"] -.->|"o quanto o fundo<br/>abaixa no geral"| g
Primeiro, descubra o que está errado
A tabela abaixo parte de "soa encorpado" — o que pressupõe que alguém já ouviu e disse isso. Com um arquivo e "conserta isso", você não tem essa frase e não pode ouvir, então você precisa medir. Uma regra rege tudo:
O espectro absoluto de uma única voz desconhecida não pode ser diagnosticado. Formantes são ±10 dB, fundamentais variam de 85–255 Hz, e frases caem 5–6 dB conforme terminam. Cada um desses é lido como um defeito por si só, e cada um deles é o falante.
Portanto, compare, e compare com algo dentro do mesmo arquivo: o original limpo se existir, caso contrário as pausas — tudo o que é audível em um intervalo é aditivo, e o espectro do intervalo é o canal, e não a voz. Comparar com um espectro médio publicado ou uma voz de controle sintetizada não funciona: dois falantes diferem mais do que a maioria dos defeitos, e ambas as respostas erradas na avaliação por trás desta orientação vieram exatamente disso.
Quando não há original e nenhum silêncio utilizável, um defeito tonal estático é genuinamente subdeterminado. Diga isso e ofereça as leituras que se encaixam, em vez de escolher uma e construir uma cadeia nela.
Comandos, armadilhas e receitas testadas: references/diagnosis.md. Leia isso antes de diagnosticar um arquivo que ninguém descreveu.
Comece pelo sintoma
Depois de saber a banda e o tipo, nomeie o que está errado com o áudio. A maioria dos áudios ruins é um ou dois destes, e cada um tem uma resposta fornecida:
| Parece | Use |
|---|---|
| Zum ou pancada por baixo | rumble-cut, ou um highpass em 80 Hz |
| Encorpado, peitoral | Tame Boominess job (200 Hz) |
| Abafado, atrás de papelão | Reduce Mud job (250 Hz) |
| Palavras difíceis de entender | Add Clarity job (3 kHz), ou esculpa o fundo |
| Áspero e cansativo | Soften Harshness job (3.2 kHz) |
| Algumas palavras muito mais altas que outras | Evenness em um compressor, ou Even Out Levels |
| Tom de sala entre frases | room-gate |
| Voz e música competindo | Voiceover carve — não um EQ em nenhum dos dois |
| Seco, gravado em lugar nenhum | room-tight ou room-natural |
| Apenas "amador" | voice-clean, que são quatro dos acima em ordem |
Catálogo completo, o que cada preset contém, o vocabulário de bandas e o que é deliberadamente NÃO coberto (de-essing, remoção de ruído, correspondência de tom): references/presets.md.
Subtraia antes de adicionar, nivele depois de filtrar, relacionamentos depois do nível, caráter e teto por último. Cada passo muda o que o próximo ouve — um compressor ajustado antes de um high-pass gasta seu tempo perseguindo ruídos graves.
Use uma família pelo problema, não pelo nome
Filtros (highpass, lowpass, peaking, lowshelf, highshelf) decidem quais frequências uma faixa pode ocupar. Esta é a primeira ferramenta para duas fontes colidindo, porque colisões acontecem em bandas: um fundo e uma voz querem ambos 1–3 kHz, e tirar isso do fundo custa muito menos ao fundo do que abaixar tudo custa à mixagem. Um high-pass em uma voz é a correção padrão para ruídos graves; um low-pass escurece ou abafa deliberadamente.
Dinâmica (gain, compressor, limiter, gate) decide como o nível de uma faixa se comporta ao longo do tempo. Compressão estreita a distância entre alto e baixo para que as partes baixas possam subir. Um limitador é um teto — ele não molda nada, garante que nada passe. Um gate remove o que está abaixo de um limite, que é como você silencia o tom de sala entre frases. gain é um estágio de nível simples, e é o que uma faixa de automação monta quando uma faixa precisa sair do caminho.
Não linear (saturate, bitcrush) muda a forma da onda, o que adiciona harmônicos que não estavam lá. Use quando uma faixa precisar de caráter ou aspereza, em vez de correção — e lembre-se de que é generativo: torna uma fonte fina mais densa, não mais limpa.
Tempo (delay, reverb, chorus, phaser) coloca uma faixa em um espaço ou dá largura a ela. Estes são os que mais facilmente estragam uma mixagem, porque uma cauda ou uma cópia desafinada ocupa o mesmo espaço que uma voz precisa. Use-os na coisa que deve ficar atrás de algo, e mantenha a quantidade de efeito menor do que parece correto no isolamento.
A cadeia é serial: cada efeito processa o que o anterior produziu. Portanto, a filtragem corretiva vai no início, o caráter no meio e um limitador por último, onde ele pode realmente atuar como um teto.
Carving de narração
O problema que resolve. Um fundo musical sob uma narração torna a voz difícil de seguir. O reflexo é abaixar todo o fundo, o que funciona e custa ao fundo toda a sua presença — a música fica sem vida por toda a narração. Mas a voz não precisa de todo o espectro. Ela precisa das poucas bandas que realmente ocupa. O carving tira apenas essas, e o fundo mantém sua extremidade grave e seu topo, então ainda é música enquanto a voz ainda é inteligível.
É um relacionamento, não um efeito. As configurações residem no fundo — a faixa que é processada — e elas nomeiam as vozes para ouvir, exatamente como um compressor sidechain faz: você seleciona a faixa que fica mais baixa e escolhe o que a torna mais baixa. Nunca coloque um carve em uma faixa de narração. Uma voz esculpida contra si mesma é um bug, não uma escolha sutil de mixagem.
Cada voz, não apenas uma delas. sources é uma lista, porque um fundo geralmente toca sob uma sequência inteira — um narrador, uma resposta de entrevista, um segundo apresentador. Eles são somados no próprio clock do fundo antes que qualquer coisa seja medida (mixCarveSources), então uma análise cobre todos eles: as bandas vêm de toda a fala que existe, e os envelopes sobem sempre que qualquer uma delas está acontecendo. Vozes que nunca tocam enquanto o fundo toca são deixadas de fora; elas não podem mascará-lo.
Um carve contra mais de um id de clipe está errado. Agrupe os clipes e esculpa contra o grupo. Isso é um invariante, não uma dica. Nomear clipes um por um tem que ser exaustivamente correto e permanece correto apenas até a próxima edição — um quarto clipe de narração adicionado depois toca fora da consciência do carve, e o fundo falha em abaixar sob ele silenciosamente. Nomear o grupo em vez disso resolve a associação no momento da análise, então um clipe adicionado ao grupo mais tarde é coberto sem tocar em sources:
<!-- agrupe a narração, depois esculpa o fundo contra o grupo -->
<audio id="vo-intro" data-audio-group="vozover" …></audio>
<audio id="vo-meio" data-audio-group="vozover" …></audio>
<audio id="vo-saida" data-audio-group="vozover" …></audio>
<audio id="musica" data-fx-carve='{"enabled":true,"sources":["vozover"],"strength":0.8}' …></audio>
Uma lista sources nomeando dois ou mais ids de clipe simples em vez de um grupo é capturada pela regra de lint audio_carve_ungrouped_sources — ainda funciona, mas é a versão que silenciosamente apodrece quando um clipe é adicionado.
Mantenha o grupo de carve como um grupo de narração: sem fundo, sem SFX, sem música. Um id de grupo em sources resolve para cada membro atual em cada análise, então o grupo que você nomeia é o grupo que você obtém depois — não as faixas que foram medidas quando foi escrito. Duas maneiras como isso morde:
- O fundo em seu próprio grupo de origem. Ele é entregue a si mesmo como uma voz e esculpido contra seu próprio conteúdo — a regra "nunca esculpa uma faixa contra si mesma" chega uma re-análise depois.
- Um clipe de SFX ou música no grupo de narração. Ele entra no sidechain na próxima análise e o fundo começa a abaixar sob um assobio, mesmo que a execução que escreveu o atributo nunca o tenha medido.
Ambos são invisíveis no momento em que o carve é escrito: a análise soma as vozes que detectou e nunca percorre a resolução de grupo, então a primeira passagem é genuinamente correta e apenas a próxima está errada. Portanto, dê a cada função seu próprio grupo — musica para o fundo, vozover para a narração, sfx para os hits — e mantenha o grupo nomeado em sources contendo apenas vozes.
carve.mjs se recusa a escrever a forma de grupo quando vê qualquer um dos casos, registra ids de clipe e diz em stderr qual membro o bloqueou. A regra audio_carve_ungrouped_sources então aponta para o arranjo...