19-sound-domain

Status: ACTIVE AppliesTo: v10 Type: Architecture

Purpose

Sound 도메인은 사운드/음성 관련 기능(테이블, 매니저, 레지스트리)을 단일 책임 영역으로 묶어 관리한다. 이 스킬은 Sound 도메인의 **최종 구조(SSOT)**를 정의한다.

Hard Rules

Sound 도메인이 SSOT (Single Source of Truth)

•Sound 기능의 SSOT는 Sound 도메인이다.
•Sound/Voice 테이블, 레지스트리, 매니저를 **같은 도메인/같은 DLL(asmdef)**로 묶는다.
•다른 도메인(Game 등)은 Sound 도메인에 의존할 수 있으나, Sound → Game 참조는 금지.

의존성 방향 (Dependency Rule)

code

[Game Domain] ──depends──► [Sound Domain] ──depends──► [Foundation]

•Game 도메인 → Sound 도메인: 허용
•Sound 도메인 → Game 도메인: 금지
•Sound 도메인 → Foundation: 허용

최종 구조 (Target Structure)

테이블 소유

테이블	테이블 키	소유 도메인	네임스페이스 (목표)
TB_SOUND	`SOUND`	Sound 도메인	`Devian.Domain.Sound`
TB_VOICE	`VOICE`	Sound 도메인	`Devian.Domain.Sound`

•테이블 키(SOUND, VOICE)는 기존과 동일하게 유지
•Generated 클래스의 네임스페이스 목표: Devian.Domain.Sound

매니저 배치

클래스	소유 도메인	네임스페이스
`SoundManager`	Sound 도메인	`Devian` (루트 유지)
`VoiceManager`	Sound 도메인	`Devian` (루트 유지)

•매니저는 Sound 도메인 DLL에 포함
•네임스페이스는 기존 정책 유지 (Devian 루트)
•호환성을 위해 namespace 변경은 선택적

레지스트리 배치

클래스	소유 도메인	네임스페이스 (목표)
`SoundVoiceTableRegistry`	Sound 도메인	`Devian.Domain.Sound`

데이터 파일 위치

파일	현재 위치	목표 위치
`SoundTable.xlsx`	`input/Domains/Game/tables/`	`input/Domains/Sound/tables/`

Note: Phase 1에서는 파일 이동 금지. Phase 2에서 이동.

레지스트리 정책 (Critical)

SoundVoiceTableRegistry 책임

SoundVoiceTableRegistry는 Sound 도메인에 존재하며, 다음을 수행한다:

csharp

[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
private static void _register()
{
    // 1. SoundManager 델리게이트 연결 (v10: key_bundle 기반)
    SoundManager.Instance.GetSoundRowsBySoundId = _getSoundRowsBySoundId;
    SoundManager.Instance.GetSoundRowsByBundleKey = _getSoundRowsByBundleKey;

    // 2. VoiceManager 델리게이트 연결 (v10: key_bundle 기반)
    VoiceManager.Instance.GetVoiceRow = _getVoiceRow;
    VoiceManager.Instance.GetAllVoiceRows = _getAllVoiceRows;
    VoiceManager.Instance.GetVoiceRowsByBundleKey = _getVoiceRowsByBundleKey;

    // NOTE: TbLoader 등록은 DomainTableRegistry (Generated)가 담당.
    // TB_SOUND._AfterLoad() / TB_VOICE._AfterLoad()가 호출되어
    // _OnAfterLoad()에서 어댑터 캐시 클리어 + 번들 인덱스 빌드가 자동 수행됨.
}

Adapter 패턴 (필수)

•Generated 클래스(PascalCase) → ISoundRow/IVoiceRow 인터페이스(snake_case) 변환
•SoundRowAdapter, VoiceRowAdapter로 변환
•Adapter 인스턴스는 캐시하여 중복 생성 방지

_OnAfterLoad 구현 (Sound 전용)

TB_SOUND, TB_VOICE는 _OnAfterLoad()에서 다음을 수행한다:

•BuildBundleIndices() — sound_id/key_bundle 인덱스 빌드 (key_group 제거됨)
•SoundVoiceTableRegistry.ClearSoundAdapterCache() / ClearVoiceAdapterCache() — 어댑터 캐시 초기화

Note: AfterLoad hook 계약 자체는 42-tablegen-implementation 스킬이 SSOT.

Phase 계획

Phase 1 - 설계 확정 (완료)

• Sound 도메인 설계 스킬 작성 (이 문서)
• 기존 스킬(16/17/18) 정합성 업데이트
• 샘플 코드 작성 (컴파일 유지)

Phase 2 - 도메인 이관 (빌드 검증 PASS 후 완료)

Note: Phase 2 완료 = 빌드 PASS + Generated 파일 생성 확인. 빌드가 통과하지 않으면 Phase 2는 미완료.

Phase 3 - 정리

• Game 도메인에서 Sound 참조 제거 확인
• 불필요한 중복 코드 정리
• 문서 최종 업데이트

목표 DLL/asmdef 구조

code

com.devian.domain.sound/
├── Runtime/
│   ├── Devian.Domain.Sound.asmdef
│   ├── Generated/
│   │   ├── Sound.g.cs                 # TB_SOUND, TB_VOICE (Devian.Domain.Sound)
│   │   └── DomainTableRegistry.g.cs   # TbLoader 등록 + _AfterLoad 호출
│   ├── Tables/
│   │   ├── TB_SOUND.cs                # partial 확장 + _OnAfterLoad
│   │   ├── TB_VOICE.cs                # partial 확장 + _OnAfterLoad
│   │   └── SoundVoiceTableRegistry.cs # Manager 델리게이트 연결
│   └── Sound/
│       ├── SoundManager.cs            # namespace Devian
│       ├── VoiceManager.cs            # namespace Devian
│       ├── SoundChannel.cs
│       ├── SoundPlay.cs
│       └── SoundTypes.cs
└── Editor/
    └── Devian.Domain.Sound.Editor.asmdef

asmdef 의존성

code

com.devian.domain.sound
└── com.devian.foundation

com.devian.domain.game
├── com.devian.foundation
└── com.devian.domain.sound  ← Game은 Sound에 의존 가능

사용 흐름 (Phase 2 완료 후)

Note: TableManager 시그니처는 14-table-manager 스킬이 SSOT. v10 변경: key_group 제거, key_bundle 단위 로드/언로드.

csharp

// 1) TB 로드
yield return TableManager.Instance.LoadTablesAsync("table-ndjson", TableFormat.Json);

// 2) String 로드 (자막/로컬라이징)
yield return TableManager.Instance.LoadStringsAsync(
    "string-pb64",
    TableFormat.Pb64,
    SystemLanguage.Korean
);

// 3) Voice Resolve (언어별 캐시 생성)
VoiceManager.Instance.ResolveForLanguage(SystemLanguage.Korean);

// 4) 사운드 로드 (Voice 제외, key_bundle 기반)
yield return SoundManager.Instance.LoadByBundleKeyAsync("sound_common");

// 5) Voice 로드 (key_bundle 기반)
yield return VoiceManager.Instance.LoadByBundleKeyAsync(
    "voice_greet",
    SystemLanguage.Korean,
    SystemLanguage.English
);

// 6) 재생
var sfxId = SoundManager.Instance.PlaySound("sfx_click");
var voiceId = VoiceManager.Instance.PlayVoice("hello");

// 7) 제어
SoundManager.Instance.StopSound(sfxId);
VoiceManager.Instance.StopVoice(voiceId);

// 8) 언로드 (key_bundle 기반)
SoundManager.Instance.UnloadByBundleKey("sound_common");
VoiceManager.Instance.UnloadByBundleKey("voice_greet");

// 9) 언어 변경 시
VoiceManager.Instance.UnloadAllVoiceBundles();
VoiceManager.Instance.ResolveForLanguage(SystemLanguage.English);
// 필요한 bundle들 다시 로드...

Verification (Phase 2 Done Definition)

Phase 2는 아래가 모두 참이어야 DONE이다:

•framework-cs/upm/com.devian.domain.sound/Runtime/Generated/가 존재하고, DomainTableRegistry.g.cs가 존재한다.
•framework-cs/upm/com.devian.domain.game/Runtime/Generated/에 TB_SOUND*, TB_VOICE* 생성물이 더 이상 존재하지 않는다.
•repo 전체에서 RegisterTbLoader("SOUND"), RegisterTbLoader("VOICE") 호출은 Generated DomainTableRegistry에만 존재한다.
•input/build.sh {buildInputJson} (예: input/build.sh input/input_common.json)가 성공한다. (npm ci 포함)

Non-goals

•테이블 컬럼 규약 → 16-sound-tables 스킬
•채널/풀/쿨타임/runtime_id 규약 → 17-sound-manager 스킬
•Voice Resolve 정책 → 18-voice-table-resolve 스킬

19 Sound Domain

19-sound-domain

Purpose

Hard Rules

Sound 도메인이 SSOT (Single Source of Truth)

의존성 방향 (Dependency Rule)

최종 구조 (Target Structure)

테이블 소유

매니저 배치

레지스트리 배치

데이터 파일 위치

레지스트리 정책 (Critical)

SoundVoiceTableRegistry 책임

Adapter 패턴 (필수)

_OnAfterLoad 구현 (Sound 전용)

Phase 계획

Phase 1 - 설계 확정 (완료)

Phase 2 - 도메인 이관 (빌드 검증 PASS 후 완료)

Phase 3 - 정리

목표 DLL/asmdef 구조

asmdef 의존성

사용 흐름 (Phase 2 완료 후)

Verification (Phase 2 Done Definition)

Non-goals

See Also