[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBD4WXFHZXPQYYNXY09VWE":3,"skill-same:01M6CBD4WXFHZXPQYYNXY09VWE":50},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":27,"frontMatter":28,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":13,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M6CBD4WXFHZXPQYYNXY09VWE","20-base-audio-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F22-sound-package\u002F20-base-audio-manager\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[23,24],"Audio","20 base audio manager","2026-11-10 10:12:30",false,"# 20-base-audio-manager\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Component\n\n## Purpose\n\nBaseAudioManager는 2D\u002F3D 사운드 재생의 공통 로직을 제공한다.\nSoundManager\u002FVoiceManager는 Play 로직을 직접 구현하지 않고, BaseAudioManager에 위임한다.\n\n**책임 분리 규약:**\n- 테이블은 SOUND\u002FVOICE 분리 (각각 독립 테이블)\n- 공통 로직(볼륨\u002F피치 계산, 3D 설정, 채널 플레이)은 BaseAudioManager가 담당\n\n---\n\n## Hard Rules\n\n### 공통 베이스 원칙\n\n- **공통 베이스 이름은 `BaseAudioManager`**이다.\n- SoundManager\u002FVoiceManager는 Play 로직(볼륨\u002F피치 계산, 3D 설정)을 직접 구현하지 않는다.\n- 볼륨\u002F피치 계산, 3D 파라미터 구성, SoundChannel 재생 위임은 전부 BaseAudioManager가 담당한다.\n\n### IAudioRowBase 기반\n\n- BaseAudioManager는 **IAudioRowBase 인터페이스**를 받아 처리한다.\n- ISoundRow와 IVoiceRow 모두 IAudioRowBase를 구현한다.\n- VOICE는 isBundle\u002Fchannel\u002Floop\u002Fvolume_scale\u002Fpitch_* 를 상수로 반환한다.\n\n### 3D 파라미터 SSOT\n\n**3D 파라미터의 SSOT는 IAudioRowBase 필드**이다. 아래 필드를 사용한다:\n\n| 필드명 | 타입 | 설명 | 기본값 |\n|--------|------|------|--------|\n| `is3d` | bool | 3D 여부 | false |\n| `distance_near` | float | 3D near 거리 (= minDistance) | 1.0 |\n| `distance_far` | float | 3D far 거리 (= maxDistance) | 500.0 |\n| `volume_scale` | float | 최종 볼륨 스케일 | 1.0 |\n| `pitch_min` | float | 피치 랜덤 범위 최소 | 1.0 |\n| `pitch_max` | float | 피치 랜덤 범위 최대 | 1.0 |\n| `loop` | bool | 루프 여부 | false |\n| `cooltime` | float | 쿨타임 (초) | 0.0 |\n\n### 3D 설정: Linear Rolloff (Hard Rule)\n\n3D일 때 아래를 강제 적용한다:\n- `AudioSource.rolloffMode = AudioRolloffMode.Linear`\n- `AudioSource.dopplerLevel = 0` (도플러 효과 비활성화)\n- `AudioSource.spatialBlend = 1f`\n- `minDistance = row.distance_near`\n- `maxDistance = row.distance_far`\n\n2D일 때:\n- `AudioSource.spatialBlend = 0f`\n\n**3D 적용 조건 (Hard Rule):**\n- `effective3d = row.is3d && position.HasValue`\n- position이 있어도 row.is3d가 false면 2D로 재생됨\n\n### Play 파라미터 적용 규칙\n\n1. **볼륨**: `finalVolume = externalVolume * row.volume_scale`\n2. **피치**:\n   - pitchOverride != 0이면 사용\n   - 아니면 `pitch_min \u003C pitch_max`이면 `Random.Range(pitch_min, pitch_max)`\n   - 아니면 `pitch_min` (또는 1.0)\n3. **3D 판정**: `effective3d = row.is3d && position.HasValue`\n4. **3D 거리**: `minDistance = row.distance_near`, `maxDistance = row.distance_far`\n\n### VOICE 기본값\u002Fweight 분리 규약 (Hard Rule)\n\n- **VOICE는 기본값 상수로 처리된다:**\n  - `isBundle = true`\n  - `channel = SoundChannelType.Voice`\n  - `loop = false`\n- **weight는 SOUND 전용**이며 BaseAudioManager 공통 규약에는 포함하지 않는다.\n- BaseAudioManager는 weight 기반 랜덤 선택을 수행하지 않는다 (SoundManager 책임).\n\n---\n\n## API\n\n### ComputePlayParams (static)\n\n```csharp\n\u002F\u002F\u002F \u003Csummary>\n\u002F\u002F\u002F 볼륨\u002F피치\u002F3D 파라미터를 계산한다.\n\u002F\u002F\u002F \u003C\u002Fsummary>\npublic static void ComputePlayParams(\n    IAudioRowBase row,\n    float externalVolume,\n    float pitchOverride,\n    Vector3? position,\n    out float finalVolume,\n    out float finalPitch,\n    out bool effective3d\n)\n```\n\n### TryPlay (static)\n\n```csharp\n\u002F\u002F\u002F \u003Csummary>\n\u002F\u002F\u002F SoundChannel에 재생 요청을 위임한다.\n\u002F\u002F\u002F \u003C\u002Fsummary>\npublic static bool TryPlay(\n    SoundChannel channel,\n    SoundRuntimeId runtimeId,\n    string logicalId,        \u002F\u002F Sound: soundId, Voice: voiceId\n    int rowId,               \u002F\u002F Sound: row_id, Voice: voice_id 해시\n    IAudioRowBase row,\n    AudioClip clip,\n    float externalVolume,\n    float pitchOverride,     \u002F\u002F 0이면 row 기반\n    int groupId,\n    Vector3? position        \u002F\u002F null이면 2D\n)\n```\n\n- ComputePlayParams()로 볼륨\u002F피치\u002F3D 계산\n- SoundChannel.PlayWithRuntimeId()에 모든 파라미터 전달\n\n---\n\n## Architecture\n\n```\n[SoundManager]  [VoiceManager]\n      |               |\n      v               v\n+----------------------------------+\n|        BaseAudioManager          |\n| - ComputePlayParams(row, ...)    |\n| - TryPlay(channel, row, ...)     |\n+----------------------------------+\n           |\n           v\n    [SoundChannel]\n           |\n           v\n     [SoundPlay]\n        - Linear rolloff\n        - doppler = 0\n```\n\n---\n\n## Implementation Notes\n\n### BaseAudioManager 구현 방식\n\nBaseAudioManager는 **internal static class**로 구현한다:\n- SoundManager\u002FVoiceManager 내부에서만 호출\n- 외부 API로 노출하지 않음\n- 상속\u002F오버라이드 불필요\n\n### SoundPlay 3D 설정\n\nSoundPlay.Play() 호출 시 3D 설정:\n```csharp\nif (is3d && position.HasValue)\n{\n    _audioSource.spatialBlend = 1f;\n    _audioSource.rolloffMode = AudioRolloffMode.Linear;\n    _audioSource.dopplerLevel = 0f;\n    _audioSource.minDistance = distanceNear;\n    _audioSource.maxDistance = distanceFar;\n    transform.position = position.Value;\n}\n```\n\n### AudioAssetNameUtil\n\n에셋 경로 처리를 위한 유틸리티:\n- `ExtractAssetName(path)`: 경로에서 파일명 추출 (확장자 제외)\n- `RemoveExtension(path)`: Resources 경로에서 확장자만 제거\n\n---\n\n## See Also\n\n- `skills\u002Fdevian-unity\u002F22-sound-package\u002F16-sound-tables\u002FSKILL.md` — TB_SOUND 테이블 컬럼 규약\n- `skills\u002Fdevian-unity\u002F22-sound-package\u002F17-sound-manager\u002FSKILL.md` — SoundManager 규약\n- `skills\u002Fdevian-unity\u002F22-sound-package\u002F18-voice-table-resolve\u002FSKILL.md` — VoiceManager 규약\n- `skills\u002Fdevian-unity\u002F22-sound-package\u002F19-sound-domain\u002FSKILL.md` — Sound 도메인 설계\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F22-sound-package\u002F20-base-audio-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add devwinsoft\u002Fdevian --skill 20-base-audio-manager",{"tool":42,"command":43},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 20-base-audio-manager",{"tool":45,"command":46},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 20-base-audio-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F22-sound-package\u002F20-base-audio-manager\u002FSKILL.md",true,[],[51,57,65,73,82,89],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":25},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[53],{"skillNo":58,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":25},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[63,64],"archive","90 project archive",{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":25},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[71,72],"management","30 env management",{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":25},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[79,80,81],"push","page","19 page push send",{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":25},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[80,88],"18 page savedata",{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":25},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[80,95],"17 page deobfuscate"]