Instalación de plugins: Antes de los comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando esta habilidad esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización a continuación.
HyperFrames Audio
Una mezcla es un conjunto de relaciones, no una pila de procesadores. Dos pistas que cada una suenan bien por separado pueden ser insoportables juntas, y la solución casi nunca es "bajar una" — se trata de encontrar por qué están peleando y dárselo a la que lo necesita. Cada herramienta aquí existe para expresar una de esas relaciones.
Los efectos viven en el elemento como data-fx-chain, y la vista previa y el renderizado ejecutan el mismo gráfico de Web Audio: el estudio en un contexto en vivo, el motor en uno offline dentro del navegador que ya lo impulsa. Hay una única implementación de cada efecto, por lo que lo que escuchas mientras navegas es lo que se escribe. Nunca ajustas dos veces.
El temporizado de clips sigue siendo /hyperframes-core: los recortes de audio/video y los rangos de origen usan data-start, data-duration y data-media-start, y los encadenados superponen clips en diferentes pistas. Esta habilidad posee los fundidos de entrada/salida de pista colocada, envolventes de encadenado, ganancia/volumen de pista, automatización de volumen y efectos, ducking/vaciado de locución y la cadena de efectos. /media-use posee la obtención, generación y preprocesamiento.
La constante data-playback-rate (0.1..10) es segura para renderizado de imagen y sonido con tono preservado cuando los elementos de audio/video coincidentes usan el mismo temporizado, desplazamiento de origen y velocidad. Un cambio de velocidad es un carril rate en data-automation (ver docs/reference/speed-ramps); prevalece sobre la constante y mantiene el tono en la vista previa y el renderizado. HyperFrames no proporciona sincronización automática de formas de onda ni corrección de deriva.
Para recetas copiables de corte/encadenado/remezcla, usa /hyperframes-core → references/creator-editing-recipes.md.
Tres atributos lo llevan todo, en el propio elemento de audio/video o, para los dos primeros, en un bus <hf-audio-group> (ver "Un bus para muchas pistas"):
| Atributo | Contiene |
|---|---|
data-fx-chain | los efectos, en orden de señal |
data-automation | envolventes en el volumen de esta pista o sus parámetros de efecto |
data-fx-carve | la configuración del vaciado en sí, para que pueda ser rededucida |
Las familias de efectos integradas son ganancia, EQ (paso alto, paso bajo, pico, estantes), compresor, limitador, puerta, saturación, delay, reverberación, chorus, flanger y bitcrush.
JSON exacto para cada uno, y las reglas que debe cumplir un carril: references/attributes.md.
Cada efecto con sus parámetros, rangos y unidades: references/fx-registry.md.
Cómo determinar qué está mal en un archivo que no puedes escuchar:
references/diagnosis.md.
Presets, trabajos con nombre y perfiles de un solo mando, más una tabla de síntoma a solución:
references/presets.md — léelo antes de construir una cadena manualmente, porque uno de los presets o trabajos con nombre normalmente ya nombra el problema.
Cómo encaja
Dos superficies de autoría escriben esos atributos; dos entornos de ejecución los leen a través de los mismos constructores. Ese núcleo compartido es por lo que la vista previa predice el renderizado.
flowchart TB
voice["pista de voz<br/>archivo multimedia"]
bed["fondo musical<br/>archivo multimedia"]
subgraph AUTHOR["Autoría — las únicas cosas que escriben atributos"]
panel["Estudio<br/>Control de vaciado de locución"]
script["scripts/carve.mjs<br/>detecta el par"]
analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
panel --> analysis
script --> analysis
end
voice --> analysis
bed --> analysis
subgraph ATTRS["Escritos en el elemento del fondo musical"]
carveAttr["data-fx-carve<br/>fuentes · intensidad"]
chainAttr["data-fx-chain<br/>pico xN + ganancia, etiquetado fromCarve"]
autoAttr["data-automation<br/>un carril por parámetro vaciado"]
end
analysis --> carveAttr
analysis --> chainAttr
analysis --> autoAttr
subgraph SHARED["Una implementación, leída por ambos"]
build["audioFxGraph.ts · buildFxChain"]
sched["audioFxAutomation.ts · scheduleChainAutomation"]
end
chainAttr --> build
autoAttr --> sched
build --> preview["Vista previa<br/>AudioContext en vivo<br/>attachElementFxChain"]
sched --> preview
build --> render["Renderizado<br/>OfflineAudioContext en el navegador sin cabeza<br/>applyAudioFxChain"]
sched --> render
preview --> heard["lo que escuchas mientras navegas"]
render --> wav["WAV procesado<br/>+ chainTailSeconds para que la mezcla permita pasar la cola"]
wav --> mix["motor · audioMixer<br/>el carril de volumen se hornea en el PCM aquí, no en el gráfico"]
mix --> out["la mezcla renderizada"]
edit["editar el atributo durante la reproducción"] -.->|MutationObserver| preview
La configuración del vaciado nunca se lee en la reproducción; la cadena y los carriles que produjo son lo que se reproduce. data-fx-carve existe para que la intensidad se pueda cambiar en un vaciado existente en lugar de adivinarla a partir de los filtros.
Dentro de un fondo musical vaciado, la señal pasa primero por las caídas, luego por el ajuste de nivel, luego por cualquier cosa que hayas construido tú mismo, por lo que un limitador que agregues sigue actuando como el último techo:
flowchart LR
src["fondo musical decodificado"] --> p1["pico<br/>400 Hz"]
p1 --> p2["pico<br/>1 kHz"]
p2 --> p3["pico<br/>1.6 kHz"]
p3 --> g["ganancia<br/>ajuste de nivel"]
g --> hand["tus propios efectos<br/>p. ej. limitador"]
hand --> dest["ganancia de pista, luego salida"]
l1["carril fx.n1.gain"] -.->|"envolvente del nivel<br/>de la voz en esa banda"| p1
l4["carril fx.n4.gain"] -.->|"cuánto se<br/>atenúa el fondo musical"| g
Primero, determina qué está mal
La tabla a continuación parte de "suena retumbante" — lo que presupone que alguien ya escuchó y lo dijo. Si te dan un archivo y "arréglalo", no tienes esa frase y no puedes escuchar, así que tienes que medir. Una regla lo gobierna todo:
El espectro absoluto de una sola voz desconocida no se puede diagnosticar. Los formantes son ±10 dB, los fundamentales van de 85 a 255 Hz y las oraciones disminuyen de 5 a 6 dB al finalizar. Cada uno de estos se lee como un defecto por sí mismo, y todos son el hablante.
Así que compara, y compara contra algo dentro del mismo archivo: el original limpio si existe, si no, las pausas — lo que sea audible en un silencio es aditivo, y el espectro del silencio es el canal, no la voz. Comparar contra un espectro promedio publicado o una voz de control sintetizada no funciona: dos hablantes difieren más que la mayoría de los defectos, y ambas respuestas incorrectas en la evaluación detrás de esta guía provinieron exactamente de eso.
Cuando no hay original ni silencio utilizable, un defecto tonal estático está realmente subdeterminado. Dilo y ofrece las lecturas que encajen, en lugar de elegir una y construir una cadena sobre ella.
Comandos, trampas y recetas probadas: references/diagnosis.md. LÉELO antes de diagnosticar un archivo que nadie ha descrito.
Empieza por el síntoma
Una vez que conoces la banda y el tipo, nombra qué está mal con el audio. La mayoría del audio malo es uno o dos de estos, y cada uno tiene una respuesta incorporada:
| Suena como | Recurre a |
|---|---|
| Zumbido o golpeteo debajo | rumble-cut, o un highpass a 80 Hz |
| Retumbante, pectoral | Tame Boominess job (200 Hz) |
| Apagado, detrás de cartón | Reduce Mud job (250 Hz) |
| Palabras difíciles de entender | Add Clarity job (3 kHz), o vacía el fondo |
| áspero y cansino | Soften Harshness job (3.2 kHz) |
| Algunas palabras mucho más fuertes que otras | Evenness en un compresor, o Even Out Levels |
| Sonido de sala entre frases | room-gate |
| Voz y música compitiendo | Vaciado de locución — no un EQ en ninguna |
| Seco, grabado en ninguna parte | room-tight o room-natural |
| Simplemente "amateur" | voice-clean, que son cuatro de los anteriores en orden |
Catálogo completo, lo que contiene cada preset, el vocabulario de bandas y lo que deliberadamente NO se cubre (de-essing, eliminación de ruido, coincidencia de tono): references/presets.md.
Resta antes de sumar, nivela después de filtrar, relaciones después del nivel, carácter y techo al final. Cada paso cambia lo que el siguiente escucha: un compresor configurado antes de un paso alto pasa su tiempo persiguiendo retumbos.
Recurre a una familia por el problema, no por el nombre
Filtros (highpass, lowpass, peaking, lowshelf, highshelf) deciden qué frecuencias puede ocupar una pista. Esta es la primera herramienta para dos fuentes que chocan, porque las colisiones ocurren en bandas: un fondo musical y una voz quieren ambos 1–3 kHz, y quitarle eso al fondo musical le cuesta mucho menos que bajar todo el volumen a la mezcla. Un paso alto en una voz es la solución estándar para el retumbo; un paso bajo oscurece o apaga deliberadamente.
Dinámicas (gain, compressor, limiter, gate) deciden cómo se comporta el nivel de una pista a lo largo del tiempo. La compresión reduce la distancia entre lo fuerte y lo suave para que las partes suaves puedan subir. Un limitador es un techo — no da forma a nada, garantiza que nada pase. Una puerta elimina lo que está por debajo de un umbral, que es como se silencia el sonido de sala entre frases. gain es una etapa de nivel plano, y es lo que recorre un carril de automatización cuando una pista tiene que apartarse.
No lineales (saturate, bitcrush) cambian la forma de la onda, lo que añade armónicos que no estaban allí. Recurre a ello cuando una pista necesita carácter o granulosidad en lugar de corrección — y recuerda que es generativo: hace que una fuente delgada sea más densa, no más limpia.
Tiempo (delay, reverb, chorus, phaser) sitúa una pista en un espacio o le da anchura. Estos son los que más fácilmente arruinan una mezcla, porque una cola o una copia desafinada ocupa el mismo espacio que necesita una voz. Úsalos en lo que debería estar detrás de otra cosa, y mantén la cantidad húmeda más baja de lo que suena bien en aislamiento.
La cadena es serial: cada efecto procesa lo que produjo el anterior. Así que el filtrado correctivo va temprano, el carácter en el medio y un limitador al final donde realmente pueda actuar como techo.
Vaciado de locución
El problema que resuelve. Un fondo musical debajo de una voz hace que la voz sea difícil de seguir. El reflejo es atenuar todo el fondo musical, lo que funciona pero le cuesta al fondo toda su presencia — la música se vuelve débil durante toda la locución. Pero la voz no necesita todo el espectro. Necesita las pocas bandas que realmente ocupa. El vaciado toma solo esas, y el fondo musical conserva sus graves y sus agudos, por lo que sigue siendo música mientras la voz sigue siendo inteligible.
Es una relación, no un efecto. La configuración vive en el fondo musical — la pista que se procesa — y nombra las voces a las que escuchar, exactamente como lo hace un compresor de cadena lateral: seleccionas la pista que se vuelve más silenciosa y eliges qué la hace más silenciosa. Nunca pongas un vaciado en una pista de voz. Una voz vaciada contra sí misma es un error, no una elección sutil de mezcla.
Cada voz, no una de ellas. sources es una lista, porque un fondo musical normalmente se ejecuta bajo una secuencia completa — un narrador, una respuesta de entrevista, un segundo presentador. Se suman en el propio reloj del fondo musical antes de que se mida nada (mixCarveSources), por lo que un análisis cubre todas: las bandas provienen de todo el habla que hay, y las envolventes se elevan dondequiera que ocurra algo. Las voces que nunca suenan mientras el fondo musical lo hace se dejan fuera; no pueden enmascararlo.
Un vaciado contra más de un id de clip está mal. Agrupa los clips y vacía contra el grupo. Esto es un invariante, no un consejo. Nombrar clips uno por uno tiene que ser exhaustivamente correcto y solo sigue siendo correcto hasta la próxima edición — un cuarto clip de narración añadido más tarde reproduce fuera del conocimiento del vaciado, y el fondo musical no logra atenuarse silenciosamente debajo de él. Nombrar el grupo en su lugar resuelve la membresía en el momento del análisis, por lo que un clip añadido al grupo más tarde está cubierto sin tocar sources en absoluto:
<!-- agrupa la narración, luego vacía el fondo musical contra el grupo -->
<audio id="vo-intro" data-audio-group="locución" …></audio>
<audio id="vo-middle" data-audio-group="locución" …></audio>
<audio id="vo-outro" data-audio-group="locución" …></audio>
<audio id="music" data-fx-carve='{"enabled":true,"sources":["locución"],"strength":0.8}' …></audio>
Una lista sources que nombra dos o más ids de clips simples en lugar de un grupo es detectada por la regla de lint audio_carve_ungrouped_sources — todavía funciona, pero es la versión que se pudre silenciosamente cuando se añade un clip.
Mantén el grupo de vaciado como un grupo de voz: sin fondo musical, sin SFX, sin música. Un id de grupo en sources se resuelve a cada miembro actual en cada análisis, por lo que el grupo que nombras es el grupo que obtienes más tarde, no las pistas que se midieron cuando se escribió. Dos formas en que esto muerde:
- El fondo musical en su propio grupo de origen. Se entrega a sí mismo como una voz y se vacía contra su propio contenido — la regla de "nunca vacíes una pista contra sí misma" llega un reanálisis después.
- Un clip de SFX o música en el grupo de voz. Entra en la cadena lateral en el próximo análisis y el fondo musical comienza a atenuarse bajo un silbido, aunque la ejecución que escribió el atributo nunca lo midió.
Ambos son invisibles en el momento en que se escribe el vaciado: el análisis suma las voces que detectó y nunca vuelve a pasar por la resolución del grupo, por lo que la primera pasada es genuinamente correcta y solo la siguiente es incorrecta. Así que asigna a cada rol su propio grupo — music para el fondo musical, voiceover para la narración, sfx para los golpes — y mantén el grupo nombrado en sources sin nada más que voces.
carve.mjs se niega a escribir la forma de grupo cuando ve cualquiera de los dos casos, registra los ids de los clips y dice en stderr qué miembro lo bloqueó. La regla audio_carve_ungrouped_sources luego apunta al arreglo...