3.3 KiB (Stored with Git LFS)
3.3 KiB (Stored with Git LFS)
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/
주요 기능
- IController 패턴 아키텍처: 모든 제어 시스템을 통합 인터페이스로 관리
- 멀티 카메라 제어: Cinemachine 프리셋 + 단축키 지원
- 아이템/프롭 관리: 씬 오브젝트 가시성 및 상태 토글
- 이벤트/애니메이션 트리거: UnityEvent 기반 애니메이션 시스템
- Stream Deck 연동: JSON 기반 WebSocket 프로토콜 (포트 64211)
- Spout/NDI 이중 스트리밍: 알파 채널 보존 출력
- 모션 캡처: OptiTrack, iFacialMocap, Rokoko 동시 지원
- 아바타 복장 시스템: 동적 외형 관리
- 에디터 도구: 카메라 매니저, 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 특화 셰이더 에셋 사용