HyperFrames Audio
믹스는 프로세서의 스택이 아니라 관계의 집합입니다. 각각 따로는 완벽하게 들리던 두 트랙이 함께 재생되면 듣기 어려워질 수 있으며, 이때 해결책은 '하나를 줄이는 것'이 거의 아닙니다. 중요한 것은 두 트랙이 무엇을 두고 싸우는지 찾아내어, 그것이 필요한 쪽에 할당하는 것입니다. 여기의 모든 도구는 그러한 관계 중 하나를 표현하기 위해 존재합니다.
효과는 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 | 캐브 자체의 설정으로, 재파생 가능 |
제공되는 효과군은 게인, EQ(하이패스, 로우패스, 피킹, 셸브), 컴프레서, 리미터, 게이트, 새추레이트, 딜레이, 리버브, 코러스, 페이저, 비트크러시입니다.
각 효과의 정확한 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 감소합니다. 이 모든 것은 그 자체로 결함으로 읽히지만, 실제로는 화자의 특성입니다.
따라서 비교하십시오. 같은 파일 내의 무언가와 비교하십시오: 깨끗한 원본이 있다면 그것과, 그렇지 않으면 일시 정지 구간과 비교하십시오 — 갭에서 들리는 것은 부가적인 것이며, 갭의 스펙트럼은 채널이지 음성이 아닙니다. 공개된 평균 스펙트럼이나 합성된 제어 음성과 비교하는 것은 작동하지 않습니다: 두 화자는 대부분의 결함보다 더 많이 다르며, 이 지침의 평가에서 두 가지 잘못된 답변 모두 정확히 그 원인에서 비롯되었습니다.
원본도 사용 가능한 무음도 없는 경우, 정적 음색 결함은 실제로 결정 불가능합니다. 그렇게 말하고 적합한 판독값을 제시하십시오. 하나를 선택하고 그 위에 체인을 구축하지 마십시오.
명령, 함정 및 작업 레시피: references/diagnosis.md. 아무도 설명하지 않은 파일을 진단하기 전에 읽으십시오.
증상부터 시작하십시오
일단 대역과 종류를 알면, 오디오의 문제가 무엇인지 이름을 붙이십시오. 대부분의 나쁜 오디오는 이 중 한두 가지이며, 각각에 대해 제공된 답변이 있습니다:
| 들리는 느낌 | 사용할 것 |
|---|---|
| 아래에서 윙윙거리거나 쿵쿵거림 | rumble-cut 또는 80 Hz의 highpass |
| 웅웅거리거나, 가슴이 무거운 느낌 | 웅웅거림 길들이기 작업 (200 Hz) |
| 먹먹하고, 판지 뒤에 있는 듯함 | 먹먹함 줄이기 작업 (250 Hz) |
| 말이 잘 들리지 않음 | 명료도 추가 작업 (3 kHz) 또는 배경 캐브 |
| 거칠고 피곤함 | 거칠음 부드럽게 작업 (3.2 kHz) |
| 어떤 단어가 다른 단어보다 훨씬 큼 | 컴프레서로 균일함 또는 레벨 균일화 |
| 문장 사이에 방음 | room-gate |
| 음성과 음악이 충돌함 | 보이스오버 캐브 — 둘 중 하나에 EQ 아님 |
| 건조하고, 어디서 녹음한 듯함 | 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>
그룹 대신 두 개 이상의 일반 클립 ID를 나열하는 sources 목록은 audio_carve_ungrouped_sources 린트 규칙에 의해 포착됩니다. 여전히 작동하지만, 클립이 추가될 때 조용히 손상되는 버전입니다.
캐브 그룹을 음성 그룹으로 유지하십시오: 배경, 효과음, 음악이 없어야 합니다. sources의 그룹 ID는 매 분석 시점의 모든 현재 멤버로 해석되므로, 지정한 그룹은 나중에 얻는 그룹입니다 — 작성 당시 측정된 트랙이 아닙니다. 두 가지로 문제가 발생합니다:
- 배경이 자신의 소스 그룹에 있는 경우. 자신에게 전달되어 자체 콘텐츠에 대해 캐브됩니다 — "트랙을 자신에게 절대 캐브하지 마라" 규칙이 재분석 시점에 적용됩니다.
- 효과음 또는 음악 클립이 음성 그룹에 있는 경우. 다음 분석 시 사이드체인에 들어가며, 배경이 '휙' 소리 아래에서 덕킹을 시작합니다. 속성을 작성한 실행에서 이를 측정하지 않았음에도 말입니다.
둘 다 캐브가 작성되는 순간에는 보이지 않습니다: 분석은 감지된 음성을 합산하고 그룹 해석을 통해 왕복하지 않으므로, 첫 번째 패스는 진정으로 정확하고 다음 패스만 잘못됩니다. 따라서 각 역할에 자체 그룹을 지정하십시오 — 배경용 music, 내레이션용 voiceover, 히트용 sfx — 그리고 sources에 지정된 그룹에는 음성만 포함되도록 유지하십시오.
carve.mjs는 두 경우 중 하나를 볼 때 그룹 형식 작성을 거부하고, 클립 ID를 기록하며, 어떤 멤버가 차단했는지 stderr에 표시합니다. 그런 다음 audio_carve_ungrouped_sources 규칙이 측정된 것보다 더 넓은 캐브를 조용히 유지하는 CLI 대신 배열을 가리킵니다.
이 실행에서 제외된 음성은 이러한 경우 중 하나가 아니며 ...
...(번역을 위해 잘림)