MagnetismHeroes/docs/audio-requests.md

# 효과음·음악 범위 결정

2026-10-06 사용자는 “효과음·배경음악 없이 진행하겠습니다. T7을 마무리하고 T8을 진행하세요.”라고 결정했다. **첫 버전에는 효과음과 배경음악을 포함하지 않는다.** 아래 요청표는 이전 후보 목록이며 현재 파일 전달 요청이나 완료 조건이 아니다. 한국어 숫자·안내 음성 44개는 유지한다. 효과음·음악의 실제 재생·믹싱 청취·음악 3회 반복 인수는 범위에서 제외하며 통과했다고 기록하지 않는다.

## 이전 선택 요청 이력

효과음과 음악은 사용자가 선택한다. 아래는 선택·편집을 위한 요청 목록이며 아직 채택한 최종 음원은 없다. 같은 파일을 여러 행동에서 재사용할 수 있다. 음성은 별도로 로컬 Qwen3-TTS에서 제작한다.

| ID | 용도·느낌 | 권장 길이 | 반복 |
|---|---|---|---|
| sfx_pickup | 자석 친구를 집을 때 말랑한 반응 | 0.1~0.3초 | 없음 |
| sfx_count | 숫자 음성을 가리지 않는 작은 톡 | 0.1~0.2초 | 없음 |
| sfx_ui | 버튼의 조용한 클릭 | 0.1~0.2초 | 없음 |
| sfx_success | 짧고 따뜻한 축하 | 1~2초 | 없음 |
| sfx_merge | 자석이 붙는 착 소리 | 0.2~0.5초 | 없음 |
| sfx_split_select | 구 선택·해제의 작은 반응 | 0.1~0.2초 | 없음 |
| sfx_split | 연결이 풀리는 톡 소리 | 0.2~0.5초 | 없음 |
| sfx_encourage | 다시 시도하도록 돕는 부드러운 반응 | 0.2~0.5초 | 없음 |
| sfx_spawn_return | 자유 놀이에서 꺼내기·반납 | 0.2~0.4초 | 없음 |
| sfx_hint | 도움 대상에 주의를 끄는 소리 | 0.2~0.5초 | 없음 |
| music_play | 가사·긴장감 없이 장난감 놀이에 어울리는 음악 | 60~120초 | 자연스럽게 반복 |
| music_menu | 같은 음악의 조용한 편집본도 가능 | 30~60초 | 자연스럽게 반복 |

첫 퍼즐은 pickup/count/ui/success를 먼저 연결한다. 다른 효과음과 음악은 기능 확장 때 연결한다. 선택을 기다리는 동안 임시 소리·무음으로 기능을 검사하며 최종 음원 완료로 기록하지 않는다.

파일 또는 후보의 출처 링크와 사용 조건을 함께 받는다. 선택한 원본은 SourceAssets/Audio에 보관하고 편집본만 Unity에 연결한다. 초기 전달 형식은 음성·효과음 WAV PCM16 mono 44.1kHz, 음악 WAV PCM16 stereo 44.1kHz다. 원본이 다른 형식이어도 사용할 수 있다. 승인 없는 구매는 수행하지 않는다.

T7 현재 연결 상태: 기존 Voice/SFX/Music Mixer group과 AudioSource, 입력 반응 hooks는 유지한다. 실제 SFX/BGM 자산은 채택하지 않고 GameApp의 관련 14개 clip 참조는 모두 null이다. 합성 test-only AudioClip은 lifecycle 회귀에만 사용하며 runtime 대체 음원으로 채택하지 않았다. 승인된 한국어 음성은 재생한다. 효과음·음악 파일 선정은 대기 중인 작업이 아니다.