mingle/streamingle-unity-utilities
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
streamingle-unity-utilities/CameraAI~/Documentation~/EXTERNAL_INSTALLATION.md

2.5 KiB
Raw Blame History

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:

https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.17

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.17 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:

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.