# 원작 음악과 SFX 연결

사용자가 기존 프로젝트에 정리해 둔 `rockman-research/assets/audio/mm3/runtime-validated/`의 6개 Ogg와 manifest를 **읽기 전용으로 복사**했습니다. 원본 게임 코드를 가져오거나 음원을 새로 작곡하지 않았습니다. 사용자 지시로 이 음원 자료를 확인한 예외이며 공통 엔진 snapshot은 그대로입니다.

| 장면 | 실제 원작 파일 / cue |
|---|---|
| 타이틀, 처음 사용자 입력 이후 | title.ogg |
| 일반 스테이지 | snake.ogg |
| 보스 활성화 | boss.ogg |
| 일시 정지 메뉴 | select.ogg |
| 격파 직후 | effects.ogg의 clear, 3.478초 |
| 클리어 징글 이후 | weapon.ogg |
| 발사 / 적 사격 | buster / shot |
| 명중 / 반사 / 폭발 | hit / reflect / explosion |
| 피격 / 사망 | hurt / death |
| 슬라이드 / 착지 | slide / land |
| 체크포인트 / 재시작 | refill / teleport |
| 보스 파동 / 방어 예고 | stomp 또는 spark / reflect |

원작 manifest에는 별도 이름의 jump cue가 없습니다. 점프 이륙에는 land를 낮은 볼륨·1.35배 피치로 사용한 **변형**을 적용합니다. 보스의 새 3D 패턴에 기존 원작 SFX를 연결한 것이며 원작의 특정 보스 패턴을 완전히 재현했다는 의미는 아닙니다. 나머지 24개 cue 전체도 sprite에 보존합니다.

`app/game-audio.js`가 compressed Ogg를 로컬 fetch하고 native WebAudio로 재생합니다. 음악은 manifest의 loopStart/loopEnd를 `AudioBufferSourceNode`에 적용합니다. 초반 intro를 재생한 뒤 본 루프로 돌아가며, 일시 정지 전 음악 위치를 기억합니다. 클리어 징글 동안 BGM을 멈추고 이어서 무기 획득 곡으로 전환합니다.

한 AudioContext를 엔진 Mixer와 공유하고 음악·SFX 볼륨을 분리합니다. 전체 음소거는 M, 개별 볼륨은 타이틀의 설정입니다. 브라우저 자동재생 정책 때문에 첫 사용자 입력 전에는 소리가 나지 않습니다. 숨겨진 탭/VR 포커스 상실에서는 마스터를 끕니다. 효과음은 발사·충돌 이벤트를 큐에 넣고 렌더 프레임에서 native voice를 생성하므로 고정 물리 스텝에서 오디오 노드를 만들지 않습니다.

음악 PCM 캐시는 현재 곡과 다음 곡 2개로 제한합니다. 원작 효과음은 하나의 sprite buffer를 공유하며 최대 동시 효과음 22개로 제한합니다. 별도의 음악 합성 DSP·SoundFont·NSF 에뮬레이터가 매 프레임 돌지 않으므로 Quest의 GPU 렌더 비용은 늘지 않습니다. 실제 오디오 CPU·발열은 실기기 확인 대상입니다.

`assets/audio/provenance.json`은 복사한 파일의 SHA-256·크기, 기존 출처와 변환 정보를 담습니다. Cloudflare ZIP에 이 Ogg/manifest를 모두 포함합니다. 배포 후 제작 PC나 별도 미디어 서버가 필요하지 않습니다.
