Clarify voice candidate output and intended runtime path
This commit is contained in:
@@ -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을 갱신하지 않는다.
|
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의 방향·재질·콜라이더 검수를 의미하지 않는다.
|
Blender의 `--background --python tools/models/build_playgrounds.py`는 저장소 루트에서 실행한다. 입력은 스크립트의 모델 정의이며 `SourceAssets/Models/PlaygroundProps.blend`와 Presentation/Models의 13개 FBX를 재작성한다. 사용자 인수를 받는 범용 모델 CLI가 아니다. Blender 실행·내보내기 오류는 비정상 종료하며 자동 성공 출력은 Unity의 방향·재질·콜라이더 검수를 의미하지 않는다.
|
||||||
|
|||||||
@@ -56,4 +56,6 @@ conda run --no-capture-output -n qwen3-tts python tools/audio/generate_voice.py
|
|||||||
|
|
||||||
출력된 manifest 경로를 파일 검사에 전달하고 새 후보는 `artifacts` 아래 별도 target으로 내보낸다. 기존 runtime와 바이트가 다른 후보의 기본 경로 내보내기는 거부된다. 청취·형식 검수와 사용자 채택 전에는 승인본 교체나 재생성 완료 처리를 하지 않는다. 생성 원본은 실제 sample rate로, 게임 파일은 현재 44.1kHz mono PCM16으로 보존한다. GPU가 없으면 CPU·온라인 서비스로 자동 전환하지 않는다.
|
출력된 manifest 경로를 파일 검사에 전달하고 새 후보는 `artifacts` 아래 별도 target으로 내보낸다. 기존 runtime와 바이트가 다른 후보의 기본 경로 내보내기는 거부된다. 청취·형식 검수와 사용자 채택 전에는 승인본 교체나 재생성 완료 처리를 하지 않는다. 생성 원본은 실제 sample rate로, 게임 파일은 현재 44.1kHz mono PCM16으로 보존한다. GPU가 없으면 CPU·온라인 서비스로 자동 전환하지 않는다.
|
||||||
|
|
||||||
|
후보를 들을 때는 지정한 `--target`의 실제 WAV를 연다. selection의 `runtimeFile`은 게임에 채택할 예정 경로이며 별도 target의 출력 위치를 뜻하지 않는다. 채택 확인은 active-adoption과 정확한 승인 SHA로 수행한다.
|
||||||
|
|
||||||
얼굴 후보는 투명 PNG와 프롬프트·채택 해시를 남기고 숫자·한국어는 TMP로 유지한다. 실제 Unity 구 표면과 Android 화면에서 가장자리·표정·계수 표시를 확인한다. 모델·얼굴·음성·글꼴 교체 때는 해당 파일의 출처·조건·필요 고지가 APK에 유지되는지도 확인한다.
|
얼굴 후보는 투명 PNG와 프롬프트·채택 해시를 남기고 숫자·한국어는 TMP로 유지한다. 실제 Unity 구 표면과 Android 화면에서 가장자리·표정·계수 표시를 확인한다. 모델·얼굴·음성·글꼴 교체 때는 해당 파일의 출처·조건·필요 고지가 APK에 유지되는지도 확인한다.
|
||||||
|
|||||||
Reference in New Issue
Block a user