外掛安裝: 在執行設定或刷新命令之前,當此技能屬於 HyperFrames 外掛時,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。
HyperFrames 音訊
混音是一組關係,而不是處理器的堆疊。單獨聽起來都對的兩條音軌,放在一起可能無法入耳,而解決方法幾乎從來不是「把其中一個調小聲」——而是要找出它們在爭奪什麼,然後把它交給需要的那個。這裡的每一個工具都是為了表達其中一種關係而存在。
效果存在於元素上的 data-fx-chain 屬性中,預覽和渲染執行相同的 Web Audio 圖形——在即時上下文中是工作室,在離線上下文中則是它已驅動的瀏覽器內的引擎。每個效果只有一種實作,因此你在拖曳時間軸時聽到的,就是最終會寫入的內容。你永遠不必調整兩次。
剪輯時間仍屬於 /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。
三個屬性承載所有資訊,直接放在音訊/視訊元素上——或者,對於前兩個屬性,也可以放在一個 <hf-audio-group> 匯流排上(參見「一個匯流排控制多條音軌」):
| 屬性 | 承載內容 |
|---|---|
data-fx-chain | 效果,依訊號順序排列 |
data-automation | 此音軌音量或其效果參數上的包絡 |
data-fx-carve | 雕刻本身的設定,以便可以重新推導 |
內建的效果系列有:增益、等化器(高通、低通、峰值、高低架)、壓縮器、限制器、噪音閘、飽和、延遲、殘響、合唱、移相器和位元壓縮。
每個效果的確切 JSON 格式,以及通道必須滿足的規則:references/attributes.md。
每個效果及其參數、範圍和單位:references/fx-registry.md。
如何處理一個你無法聽到的檔案並找出問題所在:references/diagnosis.md。
預設、命名任務和單旋鈕設定檔,以及症狀對照表:references/presets.md —— 在手工建立效果鏈之前請先閱讀,因為其中一個預設或命名任務通常已經指出了問題。
各部件如何協同工作
兩種編寫界面寫入這些屬性;兩種執行環境透過相同的建構器讀取它們。正是這個共享的中間層確保預測即渲染。
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["同一套實作,兩邊都讀取"]
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
首先,找出問題所在
下面的表格從「聽起來轟鳴」開始——這預設已經有人聽過並指出了問題。如果交給你的是一個檔案並要求「修好它」,你沒有這樣的描述,也無法聽到,所以你必須進行測量。一條規則貫穿所有情況:
無法診斷單一未知聲音的絕對頻譜。 共振峰有 ±10 dB,基頻範圍在 85–255 Hz,句子在結尾時會衰減 5–6 dB。這些單獨看起來都像是缺陷,而它們每一個都是說話者本身的特徵。
所以要比較,而且要與同一個檔案內部的東西進行比較:如果存在的話,比較乾淨的原始檔,否則比較靜音段落——任何在間隙中可聽到的聲音都是疊加進去的,而間隙的頻譜代表的是通道而非語音。與發表的平均頻譜或合成的對照語音進行比較是行不通的:兩個說話者之間的差異比大部分缺陷都大,而這份指南背後的評估中兩個錯誤答案正是來自這種比較。
當沒有原始檔也沒有可用的靜音時,靜態的 tonal 缺陷確實是無法確定的。請說明情況並提供符合條件的讀數,而不是選擇一個讀數並據此建立效果鏈。
命令、陷阱和實用配方:references/diagnosis.md。在診斷一個無人描述過的檔案之前,請先閱讀此文件。
從症狀開始
一旦你知道了頻段和類型,就可以說出音訊的問題。大多數糟糕的音訊都屬於以下一兩種情況,每種都有內建的解決方案:
| 聽起來像 | 請使用 |
|---|---|
| 底下有嗡嗡聲或低頻噪聲 | rumble-cut,或 80 Hz 的 highpass |
| 轟鳴、聲音厚重 | Tame Boominess 任務(200 Hz) |
| 悶塞、像隔著紙板 | Reduce Mud 任務(250 Hz) |
| 難以聽清字詞 | Add Clarity 任務(3 kHz),或雕刻襯底 |
| 刺耳、令人疲勞 | Soften Harshness 任務(3.2 kHz) |
| 某些字詞比其他大聲很多 | 對壓縮器使用 Evenness,或 Even Out Levels |
| 句子之間的房間噪音 | room-gate |
| 語音和音樂衝突 | 旁白雕刻 — 不是對兩者使用等化器 |
| 聽起來很乾、沒有空間感 | room-tight 或 room-natural |
| 就是感覺「業餘」 | voice-clean,它按順序組合了上述四種效果 |
完整目錄、每個預設包含的內容、頻段詞彙,以及刻意不涵蓋的內容(去噝聲、降噪、音色匹配):references/presets.md。
在增加之前先衰減,在濾波之後再做電平匹配,在電平匹配之後再處理關係,最後處理特性和保護上限。每個步驟都會改變下一步聽到的內容——在高通濾波器之前設定的壓縮器,會把精力浪費在處理隆隆聲上。
根據問題選擇效果系列,而非名稱
濾波器(highpass、lowpass、peaking、lowshelf、highshelf)決定一條音軌被允許佔據哪些頻率。這是處理兩個來源衝突時的首選工具,因為衝突發生在頻段上:襯底和語音都想佔據 1–3 kHz,而從襯底中移除這個頻段,對襯底的破壞遠小於把整個音軌調小對混音的破壞。對語音使用高通濾波器是處理隆隆聲的標準方法;低通濾波器則用於刻意讓聲音變暗或模糊。
動態效果(gain、compressor、limiter、gate)決定音軌電平隨時間變化的方式。壓縮縮小了響亮和安靜之間的差距,讓安靜的部分得以提升。限制器是一個保護上限——它不塑造任何東西,只保證沒有訊號能超過它。噪音閘會移除低於門檻的訊號,這就是你如何靜音句子之間的房間噪音。gain 是一個簡單的電平級,當音軌需要讓路時,自動化通道可以操作它。
非線性效果(saturate、bitcrush)改變波形的形狀,從而增加原本不存在的諧波。當音軌需要個性或質感而非修正時使用它——並記住它是有創造性的:它能使單薄的來源變得更豐滿,而不是更乾淨。
時間效果(delay、reverb、chorus、phaser)將音軌置於一個空間中或賦予它寬度。這些是最容易搞砸混音的效果,因為殘響的尾音或失諧的複製品會佔據語音所需的相同空間。將它們用於那些應該處於_後面_的元素,並將濕聲比例保持在比單獨聽起來更低的水平。
效果鏈是串聯的:每個效果處理前一個效果產生的結果。因此,修正性濾波要放在前面,個性效果在中間,限制器最後,這樣它才能真正起到保護上限的作用。
旁白雕刻
它解決的問題。 語音下方的音樂襯底會讓語音難以聽清。本能反應是讓整個襯底閃避,這有效,但代價是襯底失去了所有存在感——音樂在整個旁白期間都顯得很軟弱。但語音並不需要整個頻譜。它只需要它實際佔據的那幾個頻段。雕刻只移除那些頻段,讓襯底保留其低頻和高頻,因此在語音仍然清晰可辨的同時,音樂依然是音樂。
這是一種關係,而非一種效果。 設定存在於_襯底_上——也就是被處理的音軌——它們指定要監聽的語音,就像側鏈壓縮器一樣:你選擇會變小聲的音軌,並指定什麼讓它變小聲。絕對不要將雕刻放在語音音軌上。 語音對抗自身的雕刻是一個錯誤,而非微妙的混音選擇。
所有語音,而非其中一個。 sources 是一個列表,因為一個襯底通常會貫穿整個片段——一個旁白、一個訪談回答、第二位主持人。它們在測量任何東西之前,會先疊加在襯底自己的時鐘上(mixCarveSources),因此一次分析就能涵蓋所有語音:頻段來自所有存在的語音,而包絡則在任何語音發生的地方升起。那些在襯底播放時從不播放的語音則被排除在外;它們無法遮蔽它。
針對多於一個剪輯 ID 的雕刻是錯誤的。請將剪輯分組,然後對組進行雕刻。 這是一個不變量,而非建議。逐一命名剪輯必須完全正確,並且只在下一次編輯前保持正確——後續新增的第四個旁白剪輯將在雕刻的感知範圍外播放,導致襯底無法在它下方靜音地閃避。改為命名組,則可以在分析時解析成員資格,因此稍後加入組的剪輯無需修改 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>
一個 sources 列表如果命名了兩個或以上的純剪輯 ID 而非一個組,會被 audio_carve_ungrouped_sources 檢查規則捕捉到——它仍然有效,但這是在新增剪輯時會悄然失效的版本。
讓雕刻組保持為語音組:不要包含襯底、SFX 或音樂。 sources 中的組 ID 會在_每次_分析時解析為所有_當前_成員,因此你命名的組就是你之後會得到的組——而不是在撰寫雕刻時被測量的那些音軌。有兩種情況會造成問題:
- 襯底處於自己的來源組中。 它把自己當作語音來處理,並針對自己的內容進行雕刻——「絕不雕刻音軌自身」的規則會在下次重新分析時體現。
- 一個 SFX 或音樂剪輯在語音組中。 它在下次分析時進入側鏈,襯底開始對一個嗖聲進行閃避,儘管當初撰寫屬性的那次執行從未測量過它。
這兩種情況在雕刻撰寫的當下都是不可見的:分析將它檢測到的語音相加,並且不會透過組解析進行往返,因此第一次傳遞是真正正確的,只有下一次才是錯誤的。所以,為每個角色指定自己的組——music 給襯底,voiceover 給旁白,sfx 給效果音——並確保 sources 中命名的組只包含語音。
當 carve.mjs 看到上述任一情況時,它會拒絕寫入組形式,改為記錄剪輯 ID,並在 stderr 上輸出是哪個成員阻止了它。然後 audio_carve_ungrouped_sources 規則會指向這個安排。