83 lines
3.3 KiB (Stored with Git LFS)
Markdown
83 lines
3.3 KiB (Stored with Git LFS)
Markdown
# 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 특화 셰이더 에셋 사용
|