Installations du plugin : avant les commandes de setup ou de freshness, suivez les règles d'exécution du plugin lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
HyperFrames Audio
Un mixage est un ensemble de relations, pas une pile de processeurs. Deux pistes qui sonnent parfaitement seules peuvent être inécoutables ensemble, et le correctif n'est presque jamais « baisser l'une » — il s'agit de trouver sur quoi elles se battent et de le donner à celle qui en a besoin. Chaque outil ici existe pour exprimer une de ces relations.
Les effets vivent sur l'élément en tant que data-fx-chain, et l'aperçu et le rendu utilisent le même graphe Web Audio — le studio dans un contexte live, le moteur dans un contexte hors-ligne à l'intérieur du navigateur qu'il pilote déjà. Il n'y a qu'une seule implémentation de chaque effet, donc ce que vous entendez en défilant est ce qui est écrit. Vous ne réglez jamais deux fois.
Le timing des clips reste /hyperframes-core : les coupes audio/vidéo et les plages de sources utilisent data-start, data-duration, et data-media-start, et les fondus enchaînés chevauchent les clips sur différentes pistes. Cette compétence gère le fondu entrant/sortant des pistes placées, les enveloppes de fondu enchaîné, le gain de piste/volume de piste, l'automation de volume et d'effets, le ducking/voiceover carve, et la chaîne d'effets. /media-use gère le sourçage, la génération et le prétraitement.
La constante data-playback-rate (0.1..10) est sans danger pour le rendu image et le son préservant la hauteur tonale lorsque les éléments audio/vidéo correspondants utilisent le même timing, le même décalage source et le même taux. Une rampe de vitesse est une piste rate dans data-automation (voir docs/reference/speed-ramps) ; elle l'emporte sur la constante et conserve la hauteur tonale en aperçu et en rendu. HyperFrames ne fournit pas de synchronisation automatique de forme d'onde ou de correction de dérive.
Pour les recettes copiables de coupe/fondu enchaîné/remise à l'échelle, utilisez /hyperframes-core → references/creator-editing-recipes.md.
Trois attributs portent tout, sur l'élément audio/vidéo lui-même — ou, pour les deux premiers, sur un bus <hf-audio-group> (voir « Un bus pour plusieurs pistes ») :
| Attribut | Contient |
|---|---|
data-fx-chain | les effets, dans l'ordre du signal |
data-automation | les enveloppes sur le volume de cette piste ou ses paramètres d'effets |
data-fx-carve | ses propres réglages de carve, afin qu'il puisse être redérivé |
Les familles d'effets livrées sont le gain, l'égaliseur (passe-haut, passe-bas, crête, étagères), le compresseur, le limiteur, le gate, la saturation, le delay, la réverbération, le chorus, le phaser et le bitcrush.
Le JSON exact pour chacun, et les règles qu'une piste doit satisfaire : references/attributes.md.
Chaque effet avec ses paramètres, plages et unités : references/fx-registry.md.
Comment déterminer ce qui ne va pas avec un fichier que vous ne pouvez pas entendre : references/diagnosis.md.
Presets, jobs nommés et profils à un bouton, plus un tableau symptôme-à-correctif : references/presets.md — lisez-le avant de construire une chaîne manuellement, car l'un des presets ou jobs nommés nomme généralement déjà le problème.
Comment tout s'assemble
Deux surfaces d'édition écrivent ces attributs ; deux runtimes les lisent à travers les mêmes constructeurs. Ce milieu partagé est pourquoi l'aperçu prédit le rendu.
flowchart TB
voice["piste voix<br/>fichier média"]
bed["fond musical<br/>fichier média"]
subgraph AUTHOR["Édition — les seules choses qui écrivent les attributs"]
panel["Studio<br/>Contrôle du voiceover carve"]
script["scripts/carve.mjs<br/>détecte la paire"]
analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
panel --> analysis
script --> analysis
end
voice --> analysis
bed --> analysis
subgraph ATTRS["Écrits sur l'élément du fond musical"]
carveAttr["data-fx-carve<br/>sources · strength"]
chainAttr["data-fx-chain<br/>peaking xN + gain, taggés fromCarve"]
autoAttr["data-automation<br/>une piste par paramètre carvé"]
end
analysis --> carveAttr
analysis --> chainAttr
analysis --> autoAttr
subgraph SHARED["Une implémentation, lue par les deux"]
build["audioFxGraph.ts · buildFxChain"]
sched["audioFxAutomation.ts · scheduleChainAutomation"]
end
chainAttr --> build
autoAttr --> sched
build --> preview["Aperçu<br/>AudioContext live<br/>attachElementFxChain"]
sched --> preview
build --> render["Rendu<br/>OfflineAudioContext dans le navigateur headless<br/>applyAudioFxChain"]
sched --> render
preview --> heard["ce que vous entendez en défilant"]
render --> wav["WAV traité<br/>+ chainTailSeconds pour que le mixage laisse passer la queue"]
wav --> mix["moteur · audioMixer<br/>la piste de volume cuite dans le PCM ici, pas dans le graphe"]
mix --> out["le mixage rendu"]
edit["édition de l'attribut en cours de lecture"] -.->|MutationObserver| preview
Les propres réglages du carve ne sont jamais lus à la lecture — la chaîne et les pistes qu'il a produites sont ce qui est joué. data-fx-carve existe pour que la force puisse être modifiée sur un carve existant au lieu d'être devinée à partir des filtres.
À l'intérieur d'un fond musical carvé, le signal passe d'abord par les creux, puis par l'égalisation de niveau, puis par tout ce que vous avez construit vous-même — c'est pourquoi un limiteur que vous ajoutez agit toujours comme le dernier plafond :
flowchart LR
src["fond musical décodé"] --> p1["peaking<br/>400 Hz"]
p1 --> p2["peaking<br/>1 kHz"]
p2 --> p3["peaking<br/>1.6 kHz"]
p3 --> g["gain<br/>égalisation de niveau"]
g --> hand["vos propres effets<br/>p. ex. limiteur"]
hand --> dest["gain de piste, puis sortie"]
l1["piste fx.n1.gain"] -.->|"enveloppe du niveau<br/>de la voix dans cette bande"| p1
l4["piste fx.n4.gain"] -.->|"à quel point le fond musical<br/>baisse globalement"| g
D'abord, déterminer ce qui ne va pas
Le tableau ci-dessous part de « ça sonne brouillon » — ce qui suppose que quelqu'un a déjà écouté et l'a dit. Confronté à un fichier et à l'instruction « corrige ça », vous n'avez pas cette phrase et vous ne pouvez pas écouter, vous devez donc mesurer. Une règle régit tout cela :
Le spectre absolu d'une seule voix inconnue ne peut pas être diagnostiqué. Les formants sont à ±10 dB, les fondamentales vont de 85 à 255 Hz, et les phrases déclinent de 5 à 6 dB à leur fin. Chacune de ces valeurs ressemble à un défaut en soi, et chacune est le locuteur.
Comparez donc, et comparez avec quelque chose dans le même fichier : l'original propre s'il existe, sinon les pauses — tout ce qui est audible dans un silence est additif, et le spectre du silence est celui du canal plutôt que celui de la voix. Comparer avec un spectre moyen publié ou une voix de contrôle synthétisée ne fonctionne pas : deux locuteurs diffèrent plus que la plupart des défauts, et les deux mauvaises réponses dans l'évaluation derrière ce guide proviennent exactement de cela.
Lorsqu'il n'y a pas d'original et pas de silence utilisable, un défaut tonal statique est vraiment sous-déterminé. Dites-le et proposez les lectures qui correspondent, plutôt que d'en choisir une et de construire une chaîne dessus.
Commandes, pièges et recettes pratiques : references/diagnosis.md. Lisez-le avant de diagnostiquer un fichier que personne n'a décrit.
Partir du symptôme
Une fois que vous connaissez la bande et le type, nommez ce qui ne va pas avec l'audio. La plupart des mauvais audios sont un ou deux de ceux-ci, et chacun a une réponse intégrée :
| Ça sonne comme | Utilisez |
|---|---|
| Bourdonnement ou bruit sourd en dessous | rumble-cut, ou un highpass à 80 Hz |
| Brouillon, dans la poitrine | Tame Boominess job (200 Hz) |
| Sourd, derrière du carton | Reduce Mud job (250 Hz) |
| Mots difficiles à distinguer | Add Clarity job (3 kHz), ou carvez le fond musical |
| Dur et fatigant | Soften Harshness job (3.2 kHz) |
| Certains mots beaucoup plus forts que d'autres | Evenness sur un compresseur, ou Even Out Levels |
| Son de pièce entre les phrases | room-gate |
| Voix et musique qui se battent | Voiceover carve — pas un EQ sur l'un ou l'autre |
| Sec, enregistré nulle part | room-tight ou room-natural |
| Juste « amateur » | voice-clean, qui est quatre des ci-dessus dans l'ordre |
Catalogue complet, ce que contient chaque preset, le vocabulaire des bandes, et ce qui est délibérément NON couvert (dé-essing, suppression de bruit, correspondance de tonalité) : references/presets.md.
Soustrayez avant d'ajouter, nivelez après avoir filtré, les relations après le niveau, le caractère et le plafond en dernier. Chaque étape change ce que la suivante entend — un compresseur réglé avant un passe-haut passe son temps à chasser le bruit sourd.
Utilisez une famille par le problème, pas par le nom
Filtres (highpass, lowpass, peaking, lowshelf, highshelf) décident quelles fréquences une piste est autorisée à occuper. C'est le premier outil pour deux sources qui entrent en collision, car les collisions se produisent dans des bandes : un fond musical et une voix veulent tous deux 1 à 3 kHz, et retirer cela du fond musical coûte bien moins au fond musical que baisser le tout ne coûte au mixage. Un passe-haut sur une voix est le correctif standard pour les bruits sourds ; un passe-bas assombrit ou assourdit délibérément.
Dynamiques (gain, compressor, limiter, gate) décident comment le niveau d'une piste se comporte dans le temps. La compression réduit la distance entre fort et faible afin que les parties faibles puissent remonter. Un limiteur est un plafond — il ne façonne rien, il garantit que rien ne dépasse. Un gate supprime ce qui est en dessous d'un seuil, c'est ainsi que vous faites taire le son ambiant entre les phrases. gain est un simple étage de niveau, et c'est ce qu'une piste d'automation chevauche lorsqu'une piste doit se déplacer pour laisser passer autre chose.
Non linéaires (saturate, bitcrush) modifient la forme de l'onde, ce qui ajoute des harmoniques qui n'étaient pas là. Utilisez-les lorsqu'une piste a besoin de caractère ou de grain plutôt que de correction — et rappelez-vous qu'elles sont génératives : elles rendent une source fine plus dense, pas plus propre.
Temporels (delay, reverb, chorus, phaser) placent une piste dans un espace ou lui donnent de la largeur. Ce sont ceux qui gâchent le plus facilement un mixage, car une queue ou une copie désaccordée occupe le même espace dont une voix a besoin. Utilisez-les sur ce qui doit se trouver derrière autre chose, et gardez la quantité d'effet (wet) plus faible que ce qui sonne bien en isolation.
La chaîne est série : chaque effet traite ce que le précédent a produit. Ainsi, le filtrage correctif va tôt, le caractère au milieu, et un limiteur en dernier où il peut effectivement agir comme un plafond.
Voiceover carve
Le problème qu'il résout. Un fond musical sous une voix rend la voix difficile à suivre. Le réflexe est de baisser tout le fond musical, ce qui fonctionne mais coûte au fond musical toute sa présence — la musique devient molle pendant toute la voix-off. Mais la voix n'a pas besoin de tout le spectre. Elle a besoin des quelques bandes qu'elle occupe réellement. Le carve ne prend que celles-ci, et le fond musical conserve ses graves et ses aigus, il reste donc de la musique pendant que la voix reste intelligible.
C'est une relation, pas un effet. Les réglages vivent sur le fond musical — la piste qui est traitée — et ils nomment les voix à écouter, exactement comme le fait un compresseur sidechain : vous sélectionnez la piste qui devient plus silencieuse et choisissez ce qui la rend plus silencieuse. Ne mettez jamais un carve sur une piste vocale. Une voix carvée contre elle-même est un bug, pas un choix de mixage subtil.
Chaque voix, pas une seule. sources est une liste, car un fond musical passe généralement sous une séquence entière — un narrateur, une réponse d'interview, un deuxième présentateur. Ils sont additionnés sur la propre horloge du fond musical avant que quoi que ce soit ne soit mesuré (mixCarveSources), donc une analyse couvre tous : les bandes proviennent de toute la parole présente, et les enveloppes montent partout où une partie de celle-ci se produit. Les voix qui ne jouent jamais pendant que le fond musical passe sont laissées de côté ; elles ne peuvent pas le masquer.
Un carve contre plus d'un id de clip est faux. Regroupez les clips et carvez contre le groupe. C'est un invariant, pas un conseil. Nommer les clips un par un doit être exhaustivement correct et ne reste correct que jusqu'à la prochaine édition — un quatrième clip de narration ajouté plus tard joue en dehors de la conscience du carve, et le fond musical ne réussit pas à baisser silencieusement en dessous. Nommer le groupe à la place résout l'appartenance au moment de l'analyse, donc un clip ajouté au groupe plus tard est couvert sans toucher à sources du tout :
<!-- regroupez la narration, puis carvez le fond musical contre le groupe -->
<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
<audio id="vo-outro" data-audio-group="voiceover" …></audio>
<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>
Une liste sources nommant deux ids de clips simples ou plus au lieu d'un groupe est attrapée par la règle de lint audio_carve_ungrouped_sources — cela fonctionne toujours, mais c'est la version qui pourrit silencieusement lorsqu'un clip est ajouté.
Gardez le groupe de carve comme un groupe vocal : pas de fond musical, pas de SFX, pas de musique. Un id de groupe dans sources résout à chaque membre actuel lors de chaque analyse, donc le groupe que vous nommez est le groupe que vous obtenez plus tard — pas les pistes qui ont été mesurées lorsqu'il a été écrit. Deux façons dont cela fait mal :
- Le fond musical dans son propre groupe source. Il est donné à lui-même comme une voix et carvé contre son propre contenu — la règle « ne jamais carver une piste contre elle-même » arrive une ré-analyse plus tard.
- Un clip SFX ou musical dans le groupe vocal. Il entre dans la sidechain lors de la prochaine analyse et le fond musical commence à baisser sous un whoosh, même si l'exécution qui a écrit l'attribut ne l'a jamais mesuré.
Les deux sont invisibles au moment où le carve est écrit : l'analyse additionne les voix qu'elle a détectées et ne passe jamais par la résolution de groupe, donc la première passe est vraiment correcte et seule la suivante est erronée. Donnez donc à chaque rôle son propre groupe — music pour le fond musical, voiceover pour la narration, sfx pour les hits — et gardez le groupe nommé dans sources ne contenant que des voix.
carve.mjs refuse d'écrire la forme de groupe lorsqu'il voit l'un ou l'autre cas, enregistre les ids de clips et dit sur stderr quel membre l'a bloqué. La règle audio_carve_ungrouped_sources pointe alors vers l'arrangement.
…