69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# External workstation installation
|
|
|
|
## Supported environment
|
|
|
|
- Windows 10/11 x64
|
|
- Unity 6000.0 or newer
|
|
- Git 2.14 or newer available on `PATH`
|
|
- Git LFS installed before Unity resolves the package
|
|
|
|
The bundled `CWCameraWorker` contains Python 3.12.13 and its inference
|
|
dependencies. Do not install Python on an artist workstation for this package.
|
|
The worker is an onedir build: `CWCameraWorker.exe` and its `_internal` folder
|
|
must remain together.
|
|
|
|
## Install from Git
|
|
|
|
In Unity Package Manager, choose **Add package from git URL** and enter:
|
|
|
|
```text
|
|
https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.19
|
|
```
|
|
|
|
The initial package download is large because the frozen Windows worker is
|
|
stored with Git LFS. If Git LFS was missing during the first resolve, install
|
|
it, remove the package lock entry, and add the package again.
|
|
|
|
## Reference data
|
|
|
|
Version 0.1.19 includes a compact, read-only `RuntimeData~` bundle with the
|
|
263 prepared reference songs, cut policy, and ranker model. An artist
|
|
workstation does not need a separate `CW-AI` checkout or Python installation.
|
|
If a newer access-controlled library is available, it remains an optional
|
|
override:
|
|
|
|
1. Put `CW-AI` next to the Unity project directory.
|
|
2. Set the `CWAI_ROOT` environment variable to its absolute path before
|
|
launching Unity.
|
|
3. Open `Tools > Streamingle > AI 카메라 생성`, expand `고급 · 진단`, and
|
|
choose the `참조 데이터 루트` manually.
|
|
|
|
A valid data root contains all of the following:
|
|
|
|
```text
|
|
CW-AI/
|
|
DatasetExports/
|
|
reports/training_index.json
|
|
models/cut_ranker_v2.json
|
|
```
|
|
|
|
The generation window prefers the bundled `RuntimeData~` root and falls back
|
|
to the optional external root when explicitly configured. It validates the
|
|
selected reference data before enabling generation.
|
|
|
|
The reference library may be read-only. Generation caches are stored under
|
|
the current Unity project's `Library/CWAI` directory. Set `CWAI_CACHE_ROOT`
|
|
before launching Unity only when a different writable cache location is
|
|
required.
|
|
|
|
## First run
|
|
|
|
1. Open `Tools > Streamingle > AI 카메라 생성`.
|
|
2. Confirm the panel shows `Timeline 입력 확인 완료` after selecting a
|
|
Timeline containing character animation and audio.
|
|
3. Leave `후보 풀도 새로 계산 (느림)` disabled for the normal fast path.
|
|
4. Run `전체 카메라 자율 생성`.
|
|
|
|
Generated files and caches are written to the Unity project, never into the
|
|
reference library or the immutable Package Cache.
|