57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# Streamingle Utilities
|
|
|
|
A Unity package containing reusable Streamingle utilities. The package is divided by feature while retaining the existing public namespaces for compatibility.
|
|
|
|
## Modules
|
|
|
|
- **Gaze** — Blendshape eye-gaze driver, Timeline track, guided calibration window, and tests.
|
|
- **Constraints** — Lightweight transform constraints and custom inspectors.
|
|
- **Camera** — `SmoothFollow` component.
|
|
- **Timeline/Subtitles** — TextMeshPro subtitle Timeline track and SRT installer API.
|
|
- **Animation** — Blendshape gap-edge cleanup editor window.
|
|
|
|
## Editor menu conventions
|
|
|
|
- `Tools/Streamingle Utilities/Gaze/Calibration`
|
|
- `Tools/Streamingle Utilities/Animation/Blend Shape Gap Cleanup`
|
|
- `Component/Streamingle Utilities/Constraints/...`
|
|
- `Assets/Create/Streamingle Utilities/Gaze/Blendshape Gaze Profile`
|
|
|
|
## Dependencies
|
|
|
|
- Unity Timeline 1.8.10 or later
|
|
- TextMeshPro 5.0.0 or later
|
|
|
|
## Compatibility
|
|
|
|
The initial package release is validated against Unity 6 (`6000.3`). Public namespaces and the Gaze assembly names are retained during the package extraction to preserve existing project references.
|
|
|
|
## Camera Work AI package
|
|
|
|
This repository also contains a separately installable Unity package for
|
|
high-quality Timeline camera generation. It is intentionally stored under
|
|
`CameraAI~` so installing the root `Streamingle Utilities` package does not
|
|
also import the camera tools or their large worker distribution.
|
|
|
|
Install **Git and Git LFS before opening Unity**, then use **Add package from
|
|
git URL** with:
|
|
|
|
```text
|
|
https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.5
|
|
```
|
|
|
|
The Camera AI package includes the complete Windows x64
|
|
`CWCameraWorker.exe` onedir build, so artist workstations do not need Python.
|
|
The executable must remain beside its `_internal` directory. Authored camera,
|
|
character-motion, and source-audio reference data are not mirrored in this
|
|
utility repository; connect an access-controlled `CW-AI` data root containing
|
|
`DatasetExports`, `reports/training_index.json`, and
|
|
`models/cut_ranker_v2.json`.
|
|
|
|
After installation, open `Tools > Streamingle > AI 카메라 생성`. The package
|
|
automatically locates its bundled worker and validates the configured data
|
|
library before enabling generation. See
|
|
`CameraAI~/Documentation~/EXTERNAL_INSTALLATION.md` for the complete setup.
|
|
Reference data may be read-only; per-project caches are written under
|
|
`Library/CWAI` (or the optional `CWAI_CACHE_ROOT` override).
|