Clarify voice candidate output and intended runtime path

2026-10-07 03:20:33 +09:00
parent 075f2a0cab
commit 6a4701f052
2 changed files with 4 additions and 0 deletions
@@ -74,6 +74,8 @@ profile은 `schemaVersion:1`, `modelId`, `modelRevision`, `language`, `speaker`,

 prepare는 유효 manifest를 받아 44.1kHz mono PCM16의 `edited/<runId>/`와 selection JSON, target의 WAV를 만든다. 선택을 생략하면 필수 ID를 대상으로 한다. 기본 target은 게임의 Voice 폴더다. 기존 runtime 파일과 바이트가 다르면 기존 파일을 보존하며 오류 종료 1을 낸다. 숫자 발화 원본이 2초를 초과하거나 편집으로 clipping이 생기는 경우도 오류다. 후보 검사 성공은 종료 0이며 selection은 `draft/not_listened`다. 자동으로 사용자 승인이나 active-adoption을 갱신하지 않는다.

+별도 `--target`을 사용한 후보의 실제 출력 위치는 그 target 폴더다. selection의 `runtimeFile`은 예정된 게임 canonical 경로를 기록하므로 현재 채택 파일이나 실제 후보 위치의 증거로 사용하지 않는다. 실제 채택은 active-adoption의 승인 상태와 해당 파일 해시로 확인한다.
+
 ## 모델 내보내기

 Blender의 `--background --python tools/models/build_playgrounds.py`는 저장소 루트에서 실행한다. 입력은 스크립트의 모델 정의이며 `SourceAssets/Models/PlaygroundProps.blend`와 Presentation/Models의 13개 FBX를 재작성한다. 사용자 인수를 받는 범용 모델 CLI가 아니다. Blender 실행·내보내기 오류는 비정상 종료하며 자동 성공 출력은 Unity의 방향·재질·콜라이더 검수를 의미하지 않는다.