AudioReactive
입력 장치(마이크/루프백)의 소리를 분석해 영상을 움직이기 위한 값을 만들어내는 노드입니다. Audio Level과 Bass / Mid / Treble은 동일한 오디오 스트림을 공유하는 4개의 레벨 트래커이며, 대역은 각각 LowPass / BandPass / HighPass 필터 차이입니다. 노드 위의 드롭다운에서 입력 장치와, Audio Level 쪽에 적용할 필터(기본값은 Bypass)를 선택합니다.
파라미터
- Dynamic Range — 정규화 창 폭(dB). 0~40으로 클램프, 기본값 20
- Fall Speed — 레벨이 떨어지는 방식. 0~1로 클램프, 기본값 0.5
- Auto Gain — 기본값 켬. 켜져 있을 때 Gain은 사용되지 않습니다
- Gain — Auto Gain이 꺼져 있을 때만 유효한 선형 배율(기본값 0.5). 내부적으로 dB로 변환되며, 1.0이 ±0dB, 2.0이 +6dB, 0.5가 -6dB입니다
- Onset Sensitivity — 기본값 1. 클수록 발생하기 어려워집니다(임계값이 올라가는 방향)
Onset와 Hit의 차이
- Onset — 스펙트럴 플럭스(512빈)가 최근 43프레임의 평균 × (1 + Sensitivity) + 0.01을 초과하면 발생합니다. 음색 변화 기반의 자동 검출로, 불응기 0.1초로 연타를 억제합니다
- Hit —
Audio Level이 임계값(노드 위 미터에서 직접 드래그로 설정, 기본값 0.6)을 위쪽으로 넘어선 순간에만 발생하는 결정론적 트리거입니다. 0.05의 히스테리시스가 있어, 한 번 아래로 내려갈 때까지 다시 발생하지 않습니다
노드 UI의 미터는, 초록이 Level・빨강이 임계값 초과분・흰색 틱이 피크 홀드, 오른쪽 끝의 LED가 Onset의 발생입니다. 접혀 있는 “Tune”을 열면 원시 입력 dB축 위에 Auto Gain의 정규화 창이 겹쳐 표시되어, Dynamic Range가 어디를 움직이는지 확인할 수 있습니다.
저장된 장치 ID를 찾을 수 없거나 선택되지 않은 경우, 목록의 첫 번째 장치가 선택됩니다.
입력 포트
| Port ID | 타입 |
|---|---|
Dynamic Range | float |
Fall Speed | float |
Auto Gain | bool |
Gain | float |
Onset Sensitivity | float |
출력 포트
| Port ID | 타입 |
|---|---|
Audio Level | float |
Bass | float |
Mid | float |
Treble | float |
Onset | trigger |
Hit | trigger |
스크립트에서 설정할 수 있는 멤버
| 경로 | 타입 |
|---|---|
dynamicRangeInput | float |
fallSpeedInput | float |
autoGainInput | bool |
gainInput | float |
sensitivityInput | float |
dynamicRange | float |
fallSpeed | float |
autoGain | bool |
gain | float |
currentDeviceID | string |
currentAudioLevel | float |
peakLevel | float |
Synapse Apps (스크립팅)
await synapse.modules.create({ type: "AudioReactive" }) 
