플러그인 설치: 셋업 또는 freshness 명령 전에, 이 스킬이 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 레인입니다(see 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/>sources · strength"]
chainAttr["data-fx-chain<br/>peaking xN + gain, 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["peaking<br/>400 Hz"]
p1 --> p2["peaking<br/>1 kHz"]
p2 --> p3["peaking<br/>1.6 kHz"]
p3 --> g["gain<br/>레벨 매치"]
g --> hand["자체 효과<br/>예: limiter"]
hand --> dest["트랙 게인, 그 다음 출력"]
l1["lane fx.n1.gain"] -.->|"해당 대역의<br/>음성 레벨 엔벨롭"| p1
l4["lane fx.n4.gain"] -.->|"베드가 전반적으로<br/>덕킹하는 정도"| g
먼저, 무엇이 잘못되었는지 파악하세요
아래 표는 "움직이는 소리가 난다"에서 시작합니다. — 누군가가 이미 듣고 그렇게 말했다고 가정합니다. "이거 고쳐"라는 파일을 받으면 그런 문장도 없고 들을 수도 없으므로, 측정해야 합니다. 하나의 규칙이 모든 것을 지배합니다:
알 수 없는 단일 음성의 절대 스펙트럼은 진단할 수 없습니다. 포먼트(formant)는 ±10 dB, 기본 주파수는 85–255 Hz이며, 문장은 끝날 때 5–6 dB 감소합니다. 각각은 단독으로는 결함으로 읽히며, 그 모든 것은 화자의 특성입니다.
따라서 비교하세요. 그리고 동일한 파일 내부의 무언가와 비교하세요: 가능하다면 원본 클린 버전, 그렇지 않으면 일시 정지 구간 — 갭에서 들리는 것은 추가적인 것이며, 갭의 스펙트럼은 채널이지 음성이 아닙니다. 게시된 평균 스펙트럼이나 합성된 제어 음성과 비교하는 것은 효과가 없습니다: 두 화자는 대부분의 결함보다 더 많이 다르며, 이 지침 뒤에 있는 평가에서 두 가지 잘못된 답변 모두 정확히 그로 인해 발생했습니다.
원본도 사용 가능한 무음도 없을 때, 정적 음조 결함은 진정으로 미결정입니다. 그렇게 말하고 맞는 판독값을 제시하되, 하나를 선택하여 체인을 구축하지 마세요.
명령, 함정 및 작업 레시피: 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 |
| 음성과 음악이 싸움 | 음성우선 carve — 둘 중 하나에 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)은 트랙을 공간에 배치하거나 너비를 제공합니다. 이는 믹스를 가장 쉽게 망칠 수 있는 것들입니다. 테일이나 디튠된 복사본이 음성이 필요한 동일한 공간을 차지하기 때문입니다. 다른 것 뒤에 있어야 하는 것에 사용하고, 단독으로 들을 때 괜찮게 들리는 양보다 낮은 양으로 유지하세요.
체인은 직렬입니다: 각 효과는 이전 효과가 생성한 것을 처리합니다. 따라서 보정 필터는 초기에, 특성은 중간에, 리미터는 마지막에 실제로 천장 역할을 할 수 있도록 배치하세요.
음성 우선(carve)
해결하는 문제. 음악 베드는 음성을 알아듣기 어렵게 만듭니다. 반사적으로 베드 전체를 덕킹하는 것은 작동하고 베드의 모든 존재감을 희생합니다. — 음악은 전체 음성 구간 동안 약해집니다. 그러나 음성은 전체 스펙트럼이 필요하지 않습니다. 실제로 차지하는 몇 개의 대역만 필요합니다. 음성우선은 그 대역만 취하고, 베드는 저역과 고역을 유지하므로 음성이 여전히 알아들을 수 있는 동안 음악은 여전히 음악으로 남습니다.
효과가 아닌 관계입니다. 설정은 처리되는 트랙인 _베드_에 있으며, 청취할 음성을 — 사이드체인 컴프레서와 똑같이 — 이름을 지정합니다: 작아지는 트랙을 선택하고 무엇이 작게 만드는지 선택합니다. 절대 음성 트랙에 음성우선을 넣지 마세요. 자기 자신에 대해 조각된 음성은 버그이지 미묘한 믹스 선택이 아닙니다.
모든 음성, 그중 하나가 아닙니다. 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 린트 규칙에 의해 잡힙니다. — 여전히 작동하지만, 클립이 추가될 때 조용히 썩는 버전입니다.
음성우선 그룹은 음성 그룹으로 유지하세요: 베드 없음, SFX 없음, 음악 없음. sources의 그룹 ID는 매 분석 시 모든 현재 멤버로 해결되므로, 명명한 그룹은 나중에 얻게 될 그룹입니다. — 작성될 때 측정된 트랙이 아닙니다. 이것이 문제가 되는 두 가지 방법:
- 자체 소스 그룹의 베드. 자신에게 음성으로 전달되고 자체 콘텐츠에 대해 조각됩니다. — "트랙을 자기 자신에 대해 절대 조각하지 마라" 규칙이 재분석 시점에 적용됩니다.
- 음성 그룹의 SFX 또는 음악 클립. 다음 분석에서 사이드체인에 진입하고 베드는 후윙 소리 아래에서 덕킹을 시작합니다. 속성을 작성한 실행이 그것을 측정하지 않았음에도 불구하고.
둘 다 음성우선이 작성되는 순간에는 보이지 않습니다: 분석은 감지된 음성을 합산하고 그룹 해석을 통해 왕복하지 않으므로 첫 번째 패스는 진정으로 정확하고 다음 패스만 잘못됩니다. 따라서 각 역할에 자체 그룹을 지정하세요. — 베드에는 music, 나레이션에는 voiceover, 히트에는 sfx — 그리고 sources에 명명된 그룹에는 음성만 포함되도록 유지하세요.
carve.mjs는 두 경우를 모두 볼 때 그룹 형식을 쓰기를 거부하고, 클립 ID를 기록하며, stderr에 어떤 멤버가 차단했는지 말합니다. audio_carve_ungrouped_sources 규칙은 그런 다음 정렬을 가리킵니다.