Streamingle_URP/streamingle-urp-analysis.md

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/

주요 기능

  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 특화 셰이더 에셋 사용