Plugin-Installationen: Befolgen Sie vor Setup- oder Frische-Befehlen die Plugin-Installationsregeln, wenn sich diese Fähigkeit innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die untenstehenden Update-Hinweise.
Was macht HyperFrames Audio?
Ein Mix ist eine Menge von Beziehungen, kein Stapel von Prozessoren. Zwei Spuren, die für sich genommen gut klingen, können zusammen unhörbar sein, und die Lösung ist fast nie, eine leiser zu machen – es geht darum, herauszufinden, worüber sie sich streiten, und es derjenigen zu geben, die es braucht. Jedes Werkzeug hier dient dazu, eine dieser Beziehungen auszudrücken.
Effekte leben auf dem Element als data-fx-chain, und Vorschau und Rendering verwenden denselben Web-Audio-Graphen – das Studio in einem Live-Kontext, die Engine in einem Offline-Kontext im Browser, den sie bereits steuert. Es gibt eine Implementierung jedes Effekts, sodass das, was Sie beim Scrubbing hören, auch geschrieben wird. Sie stimmen nie zweimal ab.
Clip-Timing bleibt /hyperframes-core: Audio-/Videotrimmings und Quellbereiche verwenden data-start, data-duration und data-media-start, und Überblendungen überlappen Clips auf verschiedenen Spuren. Diese Fähigkeit verwaltet Ein-/Ausblendungen von platzierten Spuren, Überblendungshüllkurven, Spurlautstärke/-pegel, Lautstärke- und Effektautomatisierung, Ducking/Voiceover-Carve und die Effektkette. /media-use verwaltet Beschaffung, Generierung und Vorverarbeitung.
Konstantes data-playback-rate (0.1..10) ist render-sicher für Bild und tonhöhenerhaltenen Sound, wenn übereinstimmende Audio-/Videoelemente dieselbe Zeitsteuerung, Quellversatz und Rate verwenden. Ein Speed-Ramp ist eine rate-Spur in data-automation (siehe docs/reference/speed-ramps); es überschreibt die Konstante und behält die Tonhöhe in Vorschau und Rendering bei. HyperFrames bietet keine automatische Wellenformsynchronisation oder Driftkorrektur. Für kopierbare Schnitt-/Überblendungs-/Zeitraffer-Rezepte verwenden Sie /hyperframes-core → references/creator-editing-recipes.md.
Drei Attribute tragen alles, auf dem Audio-/Videoelement selbst – oder, für die ersten beiden, auf einem <hf-audio-group>-Bus (siehe „Ein Bus für viele Spuren“):
| Attribut | Enthält |
|---|---|
data-fx-chain | die Effekte, in Signalreihenfolge |
data-automation | Hüllkurven auf der Lautstärke dieser Spur oder ihren Effektparametern |
data-fx-carve | die eigenen Einstellungen des Carves, damit es neu abgeleitet werden kann |
Die mitgelieferten Effektfamilien sind Verstärkung, EQ (Hochpass, Tiefpass, Peak, Regale), Kompressor, Limiter, Gate, Sättigung, Delay, Hall, Chorus, Phaser und Bitcrush.
Exakte JSON für jede und die Regeln, die eine Spur erfüllen muss: references/attributes.md.
Jeder Effekt mit seinen Parametern, Bereichen und Einheiten: references/fx-registry.md.
Wie man herausfindet, was mit einer Datei falsch ist, die man nicht hören kann:
references/diagnosis.md.
Voreinstellungen, benannte Jobs und Ein-Knopf-Profile, plus eine Tabelle von Symptom zur Lösung: references/presets.md – lesen Sie das, bevor Sie eine Kette von Hand bauen, denn eine der Voreinstellungen oder benannten Jobs nennt das Problem normalerweise bereits.
Wie es zusammenhängt
Zwei Authoring-Oberflächen schreiben diese Attribute; zwei Laufzeiten lesen sie durch dieselben Builder. Diese gemeinsame Mitte ist der Grund, warum die Vorschau das Rendering vorhersagt.
flowchart TB
voice["Sprachspur<br/>Mediendatei"]
bed["Musikbett<br/>Mediendatei"]
subgraph AUTHOR["Authoring – die einzigen Dinge, die Attribute schreiben"]
panel["Studio<br/>Voiceover-Carve-Steuerung"]
script["scripts/carve.mjs<br/>erkennt das Paar"]
analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
panel --> analysis
script --> analysis
end
voice --> analysis
bed --> analysis
subgraph ATTRS["Geschrieben auf das Bettelement"]
carveAttr["data-fx-carve<br/>quellen · stärke"]
chainAttr["data-fx-chain<br/>peaking xN + gain, getaggt fromCarve"]
autoAttr["data-automation<br/>eine Spur pro geschnitztem Parameter"]
end
analysis --> carveAttr
analysis --> chainAttr
analysis --> autoAttr
subgraph SHARED["Eine Implementierung, von beiden gelesen"]
build["audioFxGraph.ts · buildFxChain"]
sched["audioFxAutomation.ts · scheduleChainAutomation"]
end
chainAttr --> build
autoAttr --> sched
build --> preview["Vorschau<br/>Live AudioContext<br/>attachElementFxChain"]
sched --> preview
build --> render["Rendering<br/>OfflineAudioContext im kopflosen Browser<br/>applyAudioFxChain"]
sched --> render
preview --> heard["was Sie beim Scrubbing hören"]
render --> wav["verarbeitetes WAV<br/>+ chainTailSeconds, damit der Mix den Nachhall durchlässt"]
wav --> mix["Engine · audioMixer<br/>Lautstärkespur in das PCM hier eingebacken, nicht im Graph"]
mix --> out["der gerenderte Mix"]
edit["Bearbeiten des Attributs während der Wiedergabe"] -.->|MutationObserver| preview
Die eigenen Einstellungen des Carves werden nie zur Wiedergabe gelesen – die Kette und die Spuren, die es erzeugt hat, werden abgespielt. data-fx-carve existiert, damit die Stärke an einem vorhandenen Carve geändert werden kann, anstatt sie aus den Filtern zurückraten zu müssen.
Innerhalb eines geschnitzten Betts läuft das Signal zuerst durch die Dips, dann durch den Pegelabgleich, dann durch alles, was Sie selbst gebaut haben – weshalb ein von Ihnen hinzugefügter Limiter immer noch als letzte Decke fungiert:
flowchart LR
src["dekodiertes Bett"] --> p1["peaking<br/>400 Hz"]
p1 --> p2["peaking<br/>1 kHz"]
p2 --> p3["peaking<br/>1.6 kHz"]
p3 --> g["gain<br/>Pegelabgleich"]
g --> hand["eigene Effekte<br/>z. B. Limiter"]
hand --> dest["Spurlautstärke, dann raus"]
l1["lane fx.n1.gain"] -.->|"Hüllkurve des Sprachpegels<br/>in diesem Band"| p1
l4["lane fx.n4.gain"] -.->|"wie weit das Bett<br/>insgesamt duckt"| g
Zuerst herausfinden, was falsch ist
Die folgende Tabelle beginnt mit „es klingt dröhnend“ – was voraussetzt, dass bereits jemand zugehört und das gesagt hat. Wenn Sie eine Datei und „beheben Sie das“ bekommen, haben Sie diesen Satz nicht und können nicht zuhören, also müssen Sie messen. Eine Regel regiert alles:
Das absolute Spektrum einer einzelnen unbekannten Stimme kann nicht diagnostiziert werden. Formanten sind ±10 dB, Grundfrequenzen laufen 85–255 Hz, und Sätze fallen um 5–6 dB ab, wenn sie enden. Jeder einzelne davon erscheint als Defekt für sich, und jeder einzelne ist der Sprecher.
Vergleichen Sie also, und vergleichen Sie mit etwas innerhalb derselben Datei: dem sauberen Original, falls vorhanden, ansonsten den Pausen – was immer in einer Lücke hörbar ist, ist additiv, und das Spektrum der Lücke ist der Kanal und nicht die Stimme. Der Vergleich mit einem veröffentlichten Durchschnittsspektrum oder einer synthetisierten Kontrollstimme funktioniert nicht: Zwei Sprecher unterscheiden sich mehr als die meisten Defekte, und beide falschen Antworten in der Evaluierung hinter dieser Anleitung stammen genau daher.
Wenn es kein Original und keine brauchbare Stille gibt, ist ein statischer tonaler Defekt wirklich unterbestimmt. Sagen Sie das und bieten Sie die Messwerte an, die passen, anstatt einen auszuwählen und eine Kette darauf zu bauen.
Befehle, Fallstricke und erprobte Rezepte: references/diagnosis.md. Lesen Sie es, bevor Sie eine Datei diagnostizieren, die niemand beschrieben hat.
Vom Symptom ausgehen
Sobald Sie das Band und die Art kennen, benennen Sie, was mit dem Audio falsch ist. Die meisten schlechten Audios sind ein oder zwei davon, und jedes hat eine mitgelieferte Antwort:
| Es klingt wie | Greifen Sie zu |
|---|---|
| Brummen oder dumpfes Geräusch darunter | rumble-cut, oder einen highpass bei 80 Hz |
| Dröhnend, voll | Tame Boominess Job (200 Hz) |
| Gedämpft, hinter Pappe | Reduce Mud Job (250 Hz) |
| Wörter schwer zu verstehen | Add Clarity Job (3 kHz), oder Carve des Betts |
| Schrill und ermüdend | Soften Harshness Job (3.2 kHz) |
| Manche Wörter viel lauter als andere | Evenness an einem Kompressor, oder Even Out Levels |
| Raumton zwischen Sätzen | room-gate |
| Stimme und Musik kämpfen | Voiceover-Carve – kein EQ auf einem von beiden |
| Trocken, nirgendwo aufgenommen | room-tight oder room-natural |
| Einfach „amateurhaft“ | voice-clean, was vier der obigen in Reihenfolge ist |
Vollständiger Katalog, was jede Voreinstellung enthält, das Bandvokabular und was bewusst NICHT abgedeckt wird (De-Essing, Rauschentfernung, Tonanpassung): references/presets.md.
Subtrahieren Sie, bevor Sie hinzufügen, pegeln Sie nach dem Filtern, Beziehungen nach dem Pegel, Charakter und Decke zuletzt. Jeder Schritt ändert, was der nächste hört – ein Kompressor, der vor einem Hochpass eingestellt wird, verbringt seine Zeit damit, Brummen zu jagen.
Greifen Sie nach einer Familie je nach Problem, nicht nach dem Namen
Filter (highpass, lowpass, peaking, lowshelf, highshelf) entscheiden, welche Frequenzen eine Spur belegen darf. Dies ist das erste Werkzeug für zwei kollidierende Quellen, weil Kollisionen in Bändern stattfinden: Ein Bett und eine Stimme wollen beide 1–3 kHz, und das dem Bett zu nehmen, kostet das Bett weit weniger, als das Ganze leiser zu machen, kostet den Mix. Ein Hochpass auf einer Stimme ist die Standardlösung für Brummen; ein Tiefpass verdunkelt oder dämpft bewusst.
Dynamik (gain, compressor, limiter, gate) entscheidet, wie sich der Pegel einer Spur im Laufe der Zeit verhält. Kompression verringert den Abstand zwischen laut und leise, sodass die leisen Teile angehoben werden können. Ein Limiter ist eine Decke – er formt nichts, er stellt sicher, dass nichts darüber hinausgeht. Ein Gate entfernt, was unter einem Schwellwert liegt, so schalten Sie den Raumton zwischen Phrasen aus. gain ist eine einfache Pegelstufe, und darauf reitet eine Automatisierungsspur, wenn eine Spur Platz machen muss.
Nichtlinear (saturate, bitcrush) ändert die Wellenform, was Harmonische hinzufügt, die nicht da waren. Greifen Sie danach, wenn eine Spur Charakter oder Körnung statt Korrektur braucht – und denken Sie daran, es ist generativ: Es macht eine dünne Quelle dichter, nicht sauberer.
Zeit (delay, reverb, chorus, phaser) platziert eine Spur in einem Raum oder gibt ihr Breite. Diese sind diejenigen, die am leichtesten einen Mix ruinieren, weil ein Nachhall oder eine verstimmte Kopie denselben Raum belegt, den eine Stimme braucht. Verwenden Sie sie auf dem, was hinter etwas anderem sitzen soll, und halten Sie den Nassanteil niedriger, als es in Isolation richtig klingt.
Die Kette ist seriell: Jeder Effekt verarbeitet das, was der vorherige erzeugt hat. Also korrigierendes Filtern früh, Charakter in der Mitte und einen Limiter zuletzt, wo er tatsächlich als Decke wirken kann.
Voiceover-Carve
Das Problem, das es löst. Ein Musikbett unter einer Stimme macht die Stimme schwer verständlich. Der Reflex ist, das ganze Bett zu ducken, was funktioniert, aber dem Bett seine gesamte Präsenz kostet – die Musik wird für die gesamte Sprachaufnahme schlaff. Aber die Stimme braucht nicht das gesamte Spektrum. Sie braucht die wenigen Bänder, die sie tatsächlich belegt. Carve nimmt nur diese, und das Bett behält seine Tiefen und Höhen, also ist es immer noch Musik, während die Stimme immer noch verständlich ist.
Es ist eine Beziehung, kein Effekt. Die Einstellungen leben auf dem Bett – der Spur, die verarbeitet wird – und sie benennen die Stimmen, auf die gehört werden soll, genau wie ein Sidechain-Kompressor: Sie wählen die Spur aus, die leiser wird, und wählen aus, was sie leiser macht. Setzen Sie niemals einen Carve auf eine Sprachspur. Eine Stimme, die gegen sich selbst geschnitzt wird, ist ein Fehler, keine subtile Mix-Entscheidung.
Jede Stimme, nicht eine davon. sources ist eine Liste, weil ein Bett normalerweise unter einer ganzen Sequenz läuft – ein Erzähler, eine Interviewantwort, ein zweiter Moderator. Sie werden auf die eigene Uhr des Betts summiert, bevor etwas gemessen wird (mixCarveSources), sodass eine Analyse alle abdeckt: Die Bänder stammen von der gesamten vorhandenen Sprache, und die Hüllkurven steigen, wo immer etwas davon passiert. Stimmen, die nie spielen, während das Bett läuft, werden weggelassen; sie können es nicht maskieren.
Ein Carve gegen mehr als eine Clip-ID ist falsch. Gruppieren Sie die Clips und schnitzen Sie gegen die Gruppe. Dies ist eine Invariante, kein Tipp. Das Benennen von Clips einzeln muss erschöpfend richtig sein und bleibt nur bis zum nächsten Schnitt richtig – ein vierter Erzählclip, der später hinzugefügt wird, spielt außerhalb der Wahrnehmung des Carves, und das Bett duckt nicht leise darunter. Stattdessen die Gruppe zu benennen, löst die Mitgliedschaft zum Analysezeitpunkt auf, sodass ein später zur Gruppe hinzugefügter Clip abgedeckt ist, ohne sources zu berühren:
<!-- die Erzählung gruppieren, dann das Bett gegen die Gruppe schnitzen -->
<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>
Eine sources-Liste, die zwei oder mehr einfache Clip-IDs anstelle einer Gruppe benennt, wird von der audio_carve_ungrouped_sources-Lint-Regel abgefangen – sie funktioniert trotzdem, aber es ist die Version, die stillschweigend verrottet, wenn ein Clip hinzugefügt wird.
Halten Sie die Carve-Gruppe eine Sprachgruppe: kein Bett, kein SFX, keine Musik. Eine Gruppen-ID in sources wird bei jeder Analyse zu jedem aktuellen Mitglied aufgelöst, sodass die Gruppe, die Sie benennen, die Gruppe ist, die Sie später bekommen – nicht die Spuren, die gemessen wurden, als sie geschrieben wurde. Zwei Arten, wie das beißt:
- Das Bett in seiner eigenen Quellgruppe. Es wird sich selbst als Stimme übergeben und gegen seinen eigenen Inhalt geschnitzt – die „niemals eine Spur gegen sich selbst schnitzen“-Regel, die eine Neuanalyse später eintrifft.
- Ein SFX- oder Musikclip in der Sprachgruppe. Es tritt bei der nächsten Analyse in die Sidechain ein, und das Bett beginnt, unter einem Whoosh zu ducken, obwohl der Lauf, der das Attribut geschrieben hat, es nie gemessen hat.
Beide sind im Moment unsichtbar, in dem der Carve geschrieben wird: Die Analyse summiert die erkannten Stimmen und geht nie durch die Gruppenauflösung zurück, also ist der erste Durchgang wirklich korrekt und nur der nächste ist falsch. Geben Sie also jeder Rolle ihre eigene Gruppe – music für das Bett, voiceover für die Erzählung, sfx für die Effekte – und halten Sie die Gruppe, die in sources benannt ist, nur mit Stimmen.
carve.mjs weigert sich, die Gruppenform zu schreiben, wenn es einen der beiden Fälle sieht, zeichnet Clip-IDs auf und sagt auf stderr, welches Mitglied es blockiert hat. Die audio_carve_ungrouped_sources-Regel zeigt dann auf das Arrang
…
[gekürzt zur Übersetzung]