Installations de plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'installation des plugins lorsque cette compétence se trouve à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Audio HyperFrames
Un mix est un ensemble de relations, pas une pile de processeurs. Deux pistes qui sonnent bien séparément peuvent être inécoutables ensemble, et la solution 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 la prévisualisation et le rendu utilisent le même graphe Web Audio — le studio dans un contexte live, le moteur dans un contexte hors ligne dans le 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éplaçant la tête de lecture est ce qui est écrit. Vous ne réglez jamais deux fois.
Le timing des clips reste du ressort de /hyperframes-core : les coupes audio/vidéo et les plages sources utilisent data-start, data-duration et data-media-start, et les fondus enchaînés superposent les clips sur différentes pistes. Cette compétence gère les fondus d'entrée/sortie des pistes placées, les enveloppes de fondu enchainé, le gain/volume des pistes, l'automatisation du volume et des effets, le ducking/la sculpture de la voie off, et la chaîne d'effets. /media-use gère la source, la génération et le prétraitement.
La constante data-playback-rate (0.1..10) est sûre pour le rendu de l'image et du 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. Un rampe de vitesse est une voie rate dans data-automation (voir docs/reference/speed-ramps) ; elle l'emporte sur la constante et préserve le pitch dans la prévisualisation et le rendu. HyperFrames ne fournit pas de synchronisation automatique des formes d'onde ou de correction de dérive. Pour des recettes copiables de coupe/fondu enchaîné/recalage temporel, 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'effet |
data-fx-carve | les propres réglages de la sculpture, pour pouvoir être redérivée |
Les familles d'effets fournies sont le gain, l'égaliseur (passe-haut, passe-bas, pic, shelving), le compresseur, le limiteur, le gate, la saturation, le delay, la reverb, le chorus, le phaser et le bitcrush.
JSON exact pour chacun, et les règles qu'une voie doit satisfaire : references/attributes.md.
Chaque effet avec ses paramètres, plages et unités : references/fx-registry.md.
Comment déterminer ce qui cloche dans un fichier que vous ne pouvez pas entendre :
references/diagnosis.md.
Presets, travaux nommés et profils à un bouton, plus un tableau symptôme-solution :
references/presets.md — lisez-le avant de construire une chaîne à la main, car un des presets ou travaux nommés nomme généralement déjà le problème.
Comment tout s'assemble
Deux surfaces d'édition écrivent ces attributs ; deux environnements d'exécution les lisent via les mêmes constructeurs. Ce moyen partagé est la raison pour laquelle la prévisualisation prédit le rendu.
flowchart TB
voice["piste voix<br/>fichier média"]
bed["piste musique de fond<br/>fichier média"]
subgraph AUTHOR["Édition — les seules choses qui écrivent les attributs"]
panel["Studio<br/>Contrôle de sculpture de voie off"]
script["scripts/carve.mjs<br/>détecte la paire"]
analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
panel --> analysis
script --> analysis
end
voix --> analysis
bed --> analysis
subgraph ATTRS["Écrit sur l'élément de la musique de fond"]
carveAttr["data-fx-carve<br/>sources · strength"]
chainAttr["data-fx-chain<br/>pic xN + gain, tagué fromCarve"]
autoAttr["data-automation<br/>une voie par paramètre sculpté"]
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["Prévisualisation<br/>AudioContext live<br/>attachElementFxChain"]
sched --> preview
build --> render["Rendu<br/>OfflineAudioContext dans le navigateur sans tête<br/>applyAudioFxChain"]
sched --> render
preview --> entendu["ce que vous entendez en déplaçant la tête de lecture"]
render --> wav["WAV traité<br/>+ chainTailSeconds pour que le mix laisse passer la queue"]
wav --> mix["moteur · audioMixer<br/>voie de volume cuite dans le PCM ici, pas dans le graphe"]
mix --> out["le mix rendu"]
edit["modification de l'attribut en pleine lecture"] -.->|MutationObserver| preview
Les propres réglages de la sculpture ne sont jamais lus à la lecture — la chaîne et les voies qu'elle a produites sont ce qui est joué. data-fx-carve existe pour que la force puisse être modifiée sur une sculpture existante au lieu d'être déduite des filtres.
À l'intérieur d'une musique de fond sculptée, le signal traverse d'abord les creux, puis l'ajustement de niveau, puis tout ce que vous avez construit vous-même — c'est pourquoi un limiteur que vous ajoutez agit toujours comme le plafond final :
flowchart LR
src["musique de fond décodée"] --> p1["pic<br/>400 Hz"]
p1 --> p2["pic<br/>1 kHz"]
p2 --> p3["pic<br/>1.6 kHz"]
p3 --> g["gain<br/>ajustement de niveau"]
g --> main["vos propres effets<br/>ex. limiteur"]
main --> dest["gain de piste, puis sortie"]
l1["voie fx.n1.gain"] -.->|"enveloppe du niveau de la voix<br/>dans cette bande"| p1
l4["voie fx.n4.gain"] -.->|"à quel point la musique de fond<br/>s'atténue globalement"| g
D'abord, déterminer ce qui cloche
Le tableau ci-dessous part de "ça sonne sourd" — ce qui suppose que quelqu'un a déjà écouté et l'a dit. Si on vous donne un fichier avec "répare ça", vous n'avez pas cette phrase et vous ne pouvez pas écouter, vous devez donc mesurer. Une règle gouverne tout cela :
Le spectre absolu d'une voix unique 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 en finissant. Chacun de ces éléments apparaît comme un défaut à lui seul, et chacun d'eux est le locuteur.
Donc comparez, et comparez par rapport à 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 de la voix. Comparer à 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 qui a conduit à ces conseils provenaient exactement de cela.
Lorsqu'il n'y a ni original ni silence utilisable, un défaut tonal statique est véritablement 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 éprouvées : references/diagnosis.md. Lisez-le avant de diagnostiquer un fichier que personne n'a décrit.
Partez du symptôme
Une fois que vous connaissez la bande et le type, nommez ce qui cloche dans l'audio. La plupart des mauvais audios sont un ou deux de ceux-ci, et chacun a une réponse fournie :
| Cela ressemble à... | Utilisez |
|---|---|
| Bourdonnement ou cognement en dessous | rumble-cut, ou un highpass à 80 Hz |
| Sourd, dans la poitrine | Apprivoiser la sourdité job (200 Hz) |
| Étouffé, derrière du carton | Réduire la boue job (250 Hz) |
| Les mots difficiles à distinguer | Ajouter de la clarté job (3 kHz), ou sculpter la musique de fond |
| Dur et fatigant | Adoucir la dureté job (3.2 kHz) |
| Certains mots beaucoup plus forts que d'autres | Uniformité sur un compresseur, ou Niveler les niveaux |
| Résonance de la pièce entre les phrases | room-gate |
| La voix et la musique se battent | Sculpture de voie off — pas un EQ sur l'une 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 n'est délibérément PAS couvert (dé-essing, suppression de bruit, correspondance tonale) :
references/presets.md.
Soustrayez avant d'ajouter, nivelez après avoir filtré, relations après le niveau, caractère et plafond en dernier. Chaque étape change ce que la suivante entend — un compresseur réglé avant un passe-haut passe son temps à poursuivre le grondement.
Attaquez-vous à 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 en bandes : une musique de fond et une voix veulent toutes deux 1-3 kHz, et retirer cela à la musique de fond coûte bien moins à la musique de fond que de baisser le tout coûte au mix. Un passe-haut sur une voix est la solution standard pour le grondement ; un passe-bas assombrit ou étouffe 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 le fort et le faible afin que les parties faibles puissent monter. 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 l'on fait taire la résonance de la pièce entre les phrases. gain est une simple étape de niveau, et c'est ce qu'une voie d'automatisation utilise lorsqu'une piste doit se retirer.
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 que c'est génératif : cela rend 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 peuvent le plus facilement gâcher un mix, car une queue ou une copie désaccordée occupe le même espace qu'une voix a besoin. Utilisez-les sur l'élément qui doit se trouver derrière quelque chose d'autre, et gardez la quantité de traitement plus faible qu'elle ne sonne juste isolément.
La chaîne est en 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.
Sculpture de voie off
Le problème qu'elle résout. Une musique de fond sous une voix rend la voix difficile à suivre. Le réflexe est de réduire le volume de toute la musique de fond, ce qui fonctionne et coûte à la musique de fond 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. La sculpture ne prend que celles-ci, et la musique de fond conserve ses basses et ses aigus, donc c'est toujours de la musique tandis que la voix reste intelligible.
C'est une relation, pas un effet. Les réglages vivent sur la musique de fond — la piste qui est traitée — et ils nomment les voix à écouter, exactement comme un compresseur sidechain : vous sélectionnez la piste qui devient plus silencieuse et choisissez ce qui la rend plus silencieuse. Ne mettez jamais une sculpture sur une piste de voix. Une voix sculptée contre elle-même est un bogue, pas un choix de mix subtil.
Chaque voix, pas une seule. sources est une liste, car une musique de fond passe généralement sous toute une séquence — un narrateur, une réponse d'interview, un second présentateur. Ils sont additionnés sur l'horloge propre de la musique de fond avant que quoi que ce soit ne soit mesuré (mixCarveSources), donc une analyse les couvre tous : les bandes proviennent de tout le discours présent, et les enveloppes montent partout où il se produit. Les voix qui ne jouent jamais pendant que la musique de fond joue sont laissées de côté ; elles ne peuvent pas la masquer.
Une sculpture contre plus d'un identifiant de clip est erronée. Regroupez les clips et sculptez contre le groupe. C'est un invariant, pas un conseil. Nommer les clips un par un doit être exhaustivement juste et ne reste juste que jusqu'à la prochaine édition — un quatrième clip de narration ajouté plus tard joue en dehors de la conscience de la sculpture, et la musique de fond ne parvient pas à s'atténuer 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 du tout à sources :
<!-- regroupez la narration, puis sculptez la musique de fond 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 identifiants de clip simples ou plus au lieu d'un groupe est détectée par la règle de lint audio_carve_ungrouped_sources — cela fonctionne toujours, mais c'est la version qui se détériore silencieusement lorsqu'un clip est ajouté.
Gardez le groupe de sculpture comme un groupe de voix : pas de musique de fond, pas d'effets sonores, pas de musique. Un identifiant de groupe dans sources se résout en chaque membre actuel à 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 mord :
- La musique de fond dans son propre groupe source. Elle est donnée à elle-même comme une voix et sculptée contre son propre contenu — la règle "ne jamais sculpter une piste contre elle-même" arrive une réanalyse plus tard.
- Un clip d'effets sonores ou de musique dans le groupe de voix. Il entre dans la sidechain lors de la prochaine analyse et la musique de fond commence à s'atténuer sous un bruit de glissement, même si l'exécution qui a écrit l'attribut ne l'a jamais mesuré.
Les deux sont invisibles au moment où la sculpture est écrite : l'analyse additionne les voix qu'elle a détectées et ne passe jamais par la résolution de groupe, donc le premier passage est vraiment correct et seul le suivant est erroné. Donnez donc à chaque rôle son propre groupe — music pour la musique de fond, voiceover pour la narration, sfx pour les bruitages — et gardez le groupe nommé dans sources ne contenant rien d'autre que des voix.
carve.mjs refuse d'écrire la forme de groupe lorsqu'il voit l'un ou l'autre cas, enregistre les identifiants de clip, et indique sur stderr quel membre l'a bloqué. La règle audio_carve_ungrouped_sources pointe alors vers l'arrangement...