# Streamingle_URP - 프로젝트 분석

## 프로젝트 이름과 설명

**이름:** Streamingle_URP (밍글 스트리밍 플랫폼)
**경로:** `C:\Dev\Unity\Streamingle_URP`
**설명:** VTuber 전문 가상 아바타 스트리밍 및 제어 시스템. Unity 6 URP 기반으로 멀티 카메라 제어, 모션 캡처 통합(OptiTrack, iFacialMocap, Rokoko), Spout/NDI 이중 스트리밍, Stream Deck 연동을 지원하는 프로덕션급 플랫폼.

---

## 사용 기술 스택

| 항목 | 내용 |
|------|------|
| 언어 | C# (97개 스크립트) |
| 엔진 | Unity 6000.3.8f1 |
| 렌더 파이프라인 | Universal Render Pipeline (URP) 17.3.0 |
| 주요 패키지 | Cinemachine 3.1.5, Animation Rigging 1.4.1, Newtonsoft JSON 3.2.2 |
| 스트리밍 | Klak NDI 2.1.6, Spout 출력 |
| 기타 | Alembic 2.4.4, Input System 1.18.0, Timeline 1.8.10 |
| 모션 캡처 | OptiTrack, iFacialMocap, Rokoko |
| 외부 에셋 | AmplifyShaderEditor, NiloToon, MagicaCloth2, BioIK |

---

## 프로젝트 구조 개요

```
Streamingle_URP/
├── Assets/
│   ├── Scripts/
│   │   ├── Streamingle/           # 메인 프레임워크 (제어, 내보내기, 디버그)
│   │   ├── Streamdeck/            # WebSocket 서버 (Stream Deck 플러그인 통신)
│   │   ├── SpoutOutputScript/     # Spout/NDI 이중 스트리밍 (알파 보존)
│   │   ├── KindRetargeting/       # 모션 리타겟팅 시스템
│   │   ├── Vrmtool/               # VRM 아바타 유틸리티
│   │   ├── YAMO_Scripts/          # 애니메이션 유틸리티
│   │   └── WefLab/                # 실험적 기능
│   ├── External/                  # 서드파티 패키지
│   ├── Motion/                    # 모션 데이터
│   └── Preset/                    # 사전 설정
└── ProjectSettings/
```

---

## 주요 기능

1. **IController 패턴 아키텍처:** 모든 제어 시스템을 통합 인터페이스로 관리
2. **멀티 카메라 제어:** Cinemachine 프리셋 + 단축키 지원
3. **아이템/프롭 관리:** 씬 오브젝트 가시성 및 상태 토글
4. **이벤트/애니메이션 트리거:** UnityEvent 기반 애니메이션 시스템
5. **Stream Deck 연동:** JSON 기반 WebSocket 프로토콜 (포트 64211)
6. **Spout/NDI 이중 스트리밍:** 알파 채널 보존 출력
7. **모션 캡처:** OptiTrack, iFacialMocap, Rokoko 동시 지원
8. **아바타 복장 시스템:** 동적 외형 관리
9. **에디터 도구:** 카메라 매니저, VRM 유틸리티, 애니메이션 포즈 레코더

---

## 설정 파일 및 환경 변수

| 항목 | 값 |
|------|-----|
| Unity 버전 | `6000.3.8f1` |
| URP 버전 | `17.3.0` |
| WebSocket 포트 | `64211` (localhost) |
| 색 공간 | Linear |
| GPU 스키닝 | 활성화 |
| 그래픽 API | Direct3D 12 (기본), Vulkan (보조) |
| Scripting Defines | `UNITY_URP, MAGICACLOTH2, DLSS_INSTALLED, AMPLIFY_SHADER_EDITOR` |
| 마지막 업데이트 | `2026년 3월` |

---

## 특이사항 및 메모

- 97개 스크립트의 대규모 아키텍처, IController 패턴으로 체계적 구성
- CLAUDE.md에 상세한 아키텍처 문서화
- 2026년 3월까지 활발히 개발 중인 프로덕션급 플랫폼
- 복잡한 실시간 모션 캡처 통합 및 스트리밍이 핵심 기능
- NiloToon, lilToon 등 VTuber 특화 셰이더 에셋 사용