プラグインのインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
HyperFrames オーディオ
ミックスとは、一連の関係性であり、プロセッサーの積み重ねではありません。個別に聞けば正しく聞こえる2つのトラックが、一緒になると聴くに堪えなくなることがあります。その修正は、ほとんどの場合「どちらかを下げる」ことではなく、何を奪い合っているのかを見つけ、それを必要とする方に与えることです。ここにあるすべてのツールは、それらの関係性の1つを表現するために存在します。
エフェクトは要素に data-fx-chain として存在し、プレビューとレンダリングは同じ Web Audio グラフを実行します。スタジオはライブコンテキスト、エンジンはそれがすでに駆動しているブラウザ内のオフラインコンテキストで動作します。各エフェクトの実装は1つだけなので、シーク中に聞こえるものがそのまま書き出されます。2度調整する必要はありません。
クリップのタイミングは /hyperframes-core の役割です。オーディオ/ビデオのトリムやソース範囲は data-start、data-duration、data-media-start を使用し、クロスフェードは異なるトラック上のクリップをオーバーラップさせます。このスキルは、配置済みトラックのフェードイン/フェードアウト、クロスフェードエンベロープ、トラックゲイン/トラックボリューム、ボリュームとエフェクトのオートメーション、ダッキング/ボイスオーバーカーブ、エフェクトチェーンを担当します。/media-use は、音源の検索、生成、プリプロセッシングを担当します。
定数 data-playback-rate(0.1..10)は、オーディオ/ビデオ要素が同じタイミング、ソースオフセット、レートを使用する場合、ピクチャーとピッチ保持されたサウンドに対してレンダリングセーフです。スピードランプは、data-automation 内の rate レーンです(docs/reference/speed-ramps を参照)。これは定数よりも優先され、プレビューとレンダリングでピッチを維持します。HyperFrames は、自動的な波形同期やドリフト補正を提供しません。コピー可能なカット/クロスフェード/リタイムレシピについては、/hyperframes-core → references/creator-editing-recipes.md を使用してください。
3つの属性がすべてを保持します。オーディオ/ビデオ要素自体に、または最初の2つについては <hf-audio-group> バス(「複数トラックのための1つのバス」を参照)に適用されます。
| 属性 | 保持するもの |
|---|---|
data-fx-chain | エフェクト(シグナル順) |
data-automation | このトラックのボリュームまたはエフェクトパラメータに対するエンベロープ |
data-fx-carve | カーブ自体の設定(再導出可能にするため) |
出荷済みのエフェクトファミリーは、ゲイン、EQ(ハイパス、ローパス、ピーキング、シェルフ)、コンプレッサー、リミッター、ゲート、サチュレート、ディレイ、リバーブ、コーラス、フェイザー、ビットクラッシュです。
それぞれの正確なJSON、およびレーンが満たすべきルールについては、references/attributes.md を参照してください。すべてのエフェクトとそのパラメータ、範囲、単位については、references/fx-registry.md を参照してください。聞こえないファイルの問題を特定する方法については、references/diagnosis.md を参照してください。
プリセット、名前付きジョブ、ワンノブプロファイル、および症状から修正テーブルについては、references/presets.md を参照してください。 チェーンを手動で構築する前にこれを読んでください。プリセットや名前付きジョブのいずれかが、通常すでに問題を特定しているからです。
仕組みの全体像
2つのオーサリングサーフェスがこれらの属性を書き込み、2つのランタイムが同じビルダーを通じてそれらを読み取ります。この共有された中間層こそが、プレビューがレンダリングを予測できる理由です。
flowchart TB
voice["ボイストラック<br/>メディアファイル"]
bed["音楽トラック<br/>メディアファイル"]
subgraph AUTHOR["オーサリング — 属性を書き込む唯一のもの"]
panel["スタジオ<br/>ボイスオーバーカーブコントロール"]
script["scripts/carve.mjs<br/>ペアを検出"]
analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
panel --> analysis
script --> analysis
end
voice --> analysis
bed --> analysis
subgraph ATTRS["音楽要素に書き込まれる"]
carveAttr["data-fx-carve<br/>ソース · 強度"]
chainAttr["data-fx-chain<br/>ピーキング xN + ゲイン、fromCarve タグ付き"]
autoAttr["data-automation<br/>カーブされたパラメータごとのレーン"]
end
analysis --> carveAttr
analysis --> chainAttr
analysis --> autoAttr
subgraph SHARED["1つの実装、両方で読み取られる"]
build["audioFxGraph.ts · buildFxChain"]
sched["audioFxAutomation.ts · scheduleChainAutomation"]
end
chainAttr --> build
autoAttr --> sched
build --> preview["プレビュー<br/>ライブ AudioContext<br/>attachElementFxChain"]
sched --> preview
build --> render["レンダリング<br/>ヘッドレスブラウザ内の OfflineAudioContext<br/>applyAudioFxChain"]
sched --> render
preview --> heard["シーク中に聞こえるもの"]
render --> wav["処理済み WAV<br/>+ chainTailSeconds によりミックスがテールを通過させる"]
wav --> mix["エンジン · audioMixer<br/>ボリュームレーンはここで PCM にベイクされ、グラフ内では処理されない"]
mix --> out["レンダリングされたミックス"]
edit["再生中の属性編集"] -.->|MutationObserver| preview
カーブ自体の設定は再生時に読み取られることはありません。再生されるのは、それによって生成されたチェーンとレーンです。data-fx-carve は、既存のカーブの強度を変更できるように存在しており、フィルターから逆算して推測する必要はありません。
カーブされた音楽トラック内部では、信号は最初にディップを通過し、次にレベルマッチ、そして自分で構築したもの(追加したリミッターが依然として最後の天井として機能する理由です)を通過します。
flowchart LR
src["デコードされた音楽トラック"] --> p1["ピーキング<br/>400 Hz"]
p1 --> p2["ピーキング<br/>1 kHz"]
p2 --> p3["ピーキング<br/>1.6 kHz"]
p3 --> g["ゲイン<br/>レベルマッチ"]
g --> hand["自身のエフェクト<br/>例: リミッター"]
hand --> dest["トラックゲイン、その後出力"]
l1["レーン fx.n1.gain"] -.->|"その帯域における<br/>音声のレベルのエンベロープ"| p1
l4["レーン fx.n4.gain"] -.->|"音楽トラックが全体的に<br/>どの程度ダッキングするか"| g
まず、問題を特定する
以下の表は「こもっている」というところから始まります。これは、誰かがすでに聴いてそう言ったことを前提としています。「これを修正して」とファイルを渡された場合、あなたにはそのような説明はなく、聴くこともできないため、測定する必要があります。すべてを支配するルールが1つあります。
未知の単一音声の絶対スペクトルは診断できません。 フォルマントは ±10 dB、基本周波数は 85–255 Hz で、文末に向かって 5–6 dB 減衰します。これらすべてが単独では欠陥として読み取られ、それらすべてが話者に起因するものです。
したがって、比較を行い、同じファイル内の何かと比較します。クリーンなオリジナルが存在する場合はそれと、そうでなければポーズ(間)と比較します。ギャップで聞こえるものは付加的なものであり、ギャップのスペクトルは音声ではなくチャンネルのものです。公開された平均スペクトルや合成された制御音声と比較しても機能しません。2人の話者はほとんどの欠陥よりも大きく異なり、このガイダンスの背後にある評価では、両方の誤った回答がまさにそこから生じました。
オリジナルも使用可能な無音もない場合、静的な音色上の欠陥は真に未確定です。その旨を述べ、適合する読み値を提供し、一つを選んでチェーンを構築することは避けてください。
コマンド、落とし穴、実践的なレシピについては、references/diagnosis.md を参照してください。誰も説明していないファイルを診断する前に、これを読んでください。
症状から始める
帯域と種類がわかったら、オーディオの問題に名前を付けます。ほとんどの悪いオーディオは、これらのうちの1つか2つであり、それぞれに出荷済みの回答があります。
| このように聞こえる場合 | 使用するもの |
|---|---|
| ハムやドスンという音が下にある | rumble-cut、または 80 Hz の highpass |
| こもっている、胸に響く | こもりを抑えるジョブ(200 Hz) |
| くぐもった、段ボールの後ろのよう | 濁りを減らすジョブ(250 Hz) |
| 言葉が聞き取りにくい | 明瞭性を追加ジョブ(3 kHz)、または音楽トラックをカーブ |
| 耳障りで疲れる | 耳障りさを和らげるジョブ(3.2 kHz) |
| 単語によって音量が大きく異なる | コンプレッサーで 均一性、またはレベルを均一化 |
| 文の間の部屋のノイズ | room-gate |
| 音声と音楽が競合している | ボイスオーバーカーブ — いずれかへの EQ ではない |
| ドライで、どこにも録音されていないよう | room-tight または room-natural |
| ただ「アマチュアっぽい」 | voice-clean(上記のうち4つを順に含む) |
完全なカタログ、各プリセットの内容、帯域の用語、および意図的にカバーされていないもの(デエッシング、ノイズ除去、トーンマッチ)については、references/presets.md を参照してください。
追加する前に減算し、フィルターの後にレベルを調整し、レベルの後に関係性を、特性と天井を最後に調整します。各ステップは、次に何を聞くかを変えます。ハイパスフィルターの前に設定されたコンプレッサーは、その時間をランブルの追跡に費やします。
名前ではなく問題に応じてファミリーを選ぶ
フィルター(highpass、lowpass、peaking、lowshelf、highshelf)は、トラックが占有を許可される周波数を決定します。これは2つのソースが衝突した場合の最初のツールです。なぜなら、衝突は帯域で発生するからです。音楽トラックと音声の両方が 1~3 kHz を必要とし、その帯域を音楽トランチから奪うことは、ミックス全体の音量を下げるよりもはるかに音楽トラックへの影響が少ないです。音声へのハイパスフィルターは、ランブルの標準的な修正です。ローパスフィルターは、意図的に暗くしたりくぐもらせたりします。
ダイナミクス(gain、compressor、limiter、gate)は、トラックのレベルが時間とともにどのように動作するかを決定します。コンプレッションは、ラウドとクワイエットの間の距離を狭め、静かな部分を上げられるようにします。リミッターは天井です。何も形を変えず、何も通過させないことを保証します。ゲートは、しきい値以下のものを除去します。これが、フレーズ間の部屋のノイズを消す方法です。gain は単純なレベルステージであり、トラックが邪魔にならないように移動する必要がある場合に、オートメーションレーンが使用するものです。
非線形(saturate、bitcrush)は波形の形状を変更し、そこになかった高調波を追加します。トラックが補正ではなく、キャラクターやザラツキを必要とする場合に使用します。そして、それが生成的であることを覚えておいてください。つまり、薄いソースをより密度の高いものにしますが、よりクリーンにするわけではありません。
時間ベース(delay、reverb、chorus、phaser)は、トラックを空間に配置したり、幅を与えたりします。これらはミックスを最も簡単に台無しにするものです。なぜなら、テールやデチューンされたコピーが、音声が必要とする同じ空間を占有するからです。他の何かの後ろに配置されるべきものに使用し、ウェット量を単独で正しく聞こえる量よりも低く保ちます。
チェーンは直列です。各エフェクトは、前のエフェクトが生成したものを処理します。したがって、補正フィルタリングは早い段階で、キャラクターは中間で、リミッターは最後に配置し、実際に天井として機能できるようにします。
ボイスオーバーカーブ
解決する問題。 音声の下の音楽トラックは、音声を聞き取りにくくします。反射的に音楽トラック全体をダッキングすることがありますが、これは機能し、音楽トラックの存在感をすべて犠牲にします。音楽はナレーション全体で元気がなくなります。しかし、音声はスペクトル全体を必要とするわけではありません。音声が実際に占有するいくつかの帯域だけを必要とします。カーブはそれらの帯域のみを取り除き、音楽トラックは低域と高域を維持するため、音楽トラックは依然として音楽でありながら、音声は依然として明瞭です。
それはエフェクトではなく、関係性です。 設定は音楽トラック(処理されるトラック)に存在し、聞くべき音声を指定します。これはサイドチェインコンプレッサーが行うのとまったく同じです。つまり、小さくなるトラックを選択し、それを小さくするものを選択します。音声トラックにカーブを決して置かないでください。 それ自身に対してカーブされた音声は、微妙なミックス選択ではなく、バグです。
すべての音声、1つだけではありません。 sources はリストです。なぜなら、音楽トラックは通常、シーケンス全体(ナレーター、インタビューの回答、2人目のプレゼンター)の下で実行されるからです。これらは、何かが測定される前に音楽トラック自身のクロックに合計されます(mixCarveSources)。したがって、1つの分析がそれらすべてをカバーします。帯域はそこにあるすべての音声から導き出され、エンベロープはそのいずれかが発生している場所で上昇します。音楽トラックと同時に再生されない音声は除外されます。それらは音楽トラックをマスクできません。
複数のクリップIDに対するカーブは誤りです。クリップをグループ化し、グループに対してカーブしてください。 これはヒントではなく、不変条件です。クリップを1つずつ指定するには、完全に正しい必要があり、次の編集までしか正しくありません。後で追加された4つ目のナレーションクリップは、カーブの認識範囲外で再生され、音楽トラックはその下で静かにダッキングできなくなります。代わりにグループを指定すると、分析時にメンバーシップが解決されるため、後でグループに追加されたクリップは sources に触れることなくカバーされます。
<!-- ナレーションをグループ化し、そのグループに対して音楽トラックをカーブ -->
<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>
グループの代わりに2つ以上のプレーンなクリップIDを指定する sources リストは、audio_carve_ungrouped_sources リントルールによってキャッチされます。それでも機能しますが、クリップが追加されると静かに壊れるバージョンです。
カーブグループは音声グループに保ちます。音楽トラック、SFX、音楽は含めません。 sources 内のグループIDは、すべての現在のメンバーをすべての分析時に解決します。したがって、指定したグループは後で取得するグループであり、記述時に測定されたトラックではありません。これが問題を引き起こす2つのケースです。
- 音楽トラックが自身のソースグループ内にある場合。 それは音声として自身に渡され、自身のコンテンツに対してカーブされます。これは「トラックをそれ自身に対してカーブしてはいけない」というルールが、再分析の1回後に到来することを意味します。
- SFX または音楽クリップが音声グループ内にある場合。 それは次の分析でサイドチェインに入り、音楽トラックは「ウーッ」という音の下でダッキングを開始します。これは、その属性を書いた実行がそれを測定したことがないにもかかわらず発生します。
どちらもカーブが記述された瞬間には見えません。分析は検出した音声を合計し、グループ解決を経由して往復しないため、最初のパスは真に正しく、次のパスだけが誤りです。したがって、各ロールに独自のグループを割り当てます。音楽トラックには music、ナレーションには voiceover、ヒットには sfx を使用し、sources で指定されたグループには音声以外のものを保持しないようにします。
carve.mjs はいずれかのケースを検出するとグループ形式の書き込みを拒否し、クリップIDを記録し、どのメンバーがブロックしたかを stderr に出力します。その後、audio_carve_ungrouped_sources ルールが配置を指摘します……