MagnetismHeroes/docs/audio-requests.md

효과음·음악 선택 요청

효과음과 음악은 사용자가 선택한다. 아래는 선택·편집을 위한 요청 목록이며 아직 채택한 최종 음원은 없다. 같은 파일을 여러 행동에서 재사용할 수 있다. 음성은 별도로 로컬 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에 direct AudioSource를 연결하고 합체/분리/계수/성공/선택/공급/힌트/UI hooks 및 발화 duck, navigation/pause 정리, 현재 theme 재개를 구현했다. 실제 SFX/BGM asset은 사용자의 추후 선택 대기이며 모든 clip=null이다. 합성 test-only AudioClip은 lifecycle 회귀에만 사용하고 runtime 대체 음원으로 채택하지 않았다. 실제 음원 재생·음악 3회 반복 청취/인수는 미실행·미완료다.