178 lines
6.3 KiB (Stored with Git LFS)
Markdown
178 lines
6.3 KiB (Stored with Git LFS)
Markdown
# 원격 모션캡쳐 시스템 (Remote Motion Capture System)
|
|
|
|
> 모션캡쳐 스튜디오의 공간적 제약을 해결하는 혁신적인 원격 모션캡쳐 솔루션
|
|
|
|
## 🎯 프로젝트 개요
|
|
|
|
이 프로젝트는 물리적 모션캡쳐 스튜디오에 직접 방문하지 않고도 실시간으로 모션캡쳐 데이터를 관찰하고 녹화할 수 있는 웹 기반 시스템입니다.
|
|
|
|
### 핵심 아이디어
|
|
- **스튜디오**: 모션캡쳐 장비 + Unity 서버
|
|
- **웹사이트**: 실시간 3D 아바타 뷰어 + 녹화 제어
|
|
- **결과물**: 웹에서 직접 모션 파일 다운로드 (BVH, FBX, JSON)
|
|
|
|
## ✨ 주요 기능
|
|
|
|
- 🎭 **실시간 3D 아바타 스트리밍**: Unity에서 웹으로 실시간 모션 데이터 전송
|
|
- ⏺️ **원격 녹화 제어**: 웹에서 모션캡쳐 녹화 시작/정지
|
|
- 📁 **즉시 파일 출력**: 녹화 완료 후 즉시 모션 파일 다운로드
|
|
- 🎬 **모션 미리보기**: 녹화된 모션을 웹에서 바로 재생
|
|
- 🌐 **크로스 플랫폼**: 웹 브라우저만 있으면 어디서든 접근 가능
|
|
|
|
## 🏗️ 시스템 구조
|
|
|
|
```
|
|
[모션캡쳐 스튜디오] → [Unity 서버] → [WebSocket] → [웹 클라이언트]
|
|
↓ ↓ ↓
|
|
실제 모션 수집 실시간 스트리밍 3D 뷰어 + 제어 UI
|
|
↓ ↓
|
|
EasyMotionRecorder 모션 파일 생성
|
|
```
|
|
|
|
## 📋 개발 로드맵
|
|
|
|
| Phase | 기능 | 기간 | 상태 |
|
|
|-------|------|------|------|
|
|
| **Phase 1** | Unity-Web 연결 | 2-3주 | 📋 계획 중 |
|
|
| **Phase 2** | 3D 뷰어 + UI | 3-4주 | 📋 계획 중 |
|
|
| **Phase 3** | 파일 출력 시스템 | 2-3주 | 📋 계획 중 |
|
|
| **Phase 4** | Unity 원격 제어 | 2-3주 | 📋 계획 중 |
|
|
|
|
자세한 로드맵은 [`Documentation/PROJECT_ROADMAP.md`](Documentation/PROJECT_ROADMAP.md)를 참조하세요.
|
|
|
|
## 🛠️ 기술 스택
|
|
|
|
### Unity (서버)
|
|
- **언어**: C#
|
|
- **네트워킹**: WebSocketSharp
|
|
- **모션캡쳐**: EasyMotionRecorder
|
|
- **버전**: Unity 2022.3 LTS
|
|
|
|
### Web (클라이언트)
|
|
- **프론트엔드**: HTML5, CSS3, JavaScript (ES6+)
|
|
- **3D 렌더링**: Three.js
|
|
- **네트워킹**: WebSocket API
|
|
- **저장소**: IndexedDB
|
|
|
|
## 📁 프로젝트 구조
|
|
|
|
```
|
|
RemoteMotionCapture/
|
|
├── Unity/ # Unity 프로젝트
|
|
│ ├── Scripts/ # Unity C# 스크립트
|
|
│ │ ├── WebSocketServer.cs
|
|
│ │ ├── RemoteMotionAPI.cs
|
|
│ │ └── MotionDataStreamer.cs
|
|
│ └── Scenes/
|
|
│ └── MotionCaptureStudio.unity
|
|
│
|
|
├── WebClient/ # 웹 클라이언트
|
|
│ ├── index.html # 메인 웹페이지
|
|
│ ├── css/
|
|
│ │ └── style.css # 스타일시트
|
|
│ ├── js/ # JavaScript 모듈
|
|
│ │ ├── main.js # 메인 앱 로직
|
|
│ │ ├── motionViewer.js # 3D 렌더링
|
|
│ │ ├── motionExporter.js # 파일 출력
|
|
│ │ └── websocketClient.js # 통신 관리
|
|
│ └── assets/
|
|
│ └── models/ # 3D 모델 파일
|
|
│
|
|
├── Documentation/ # 프로젝트 문서
|
|
│ ├── PROJECT_ROADMAP.md # 개발 로드맵
|
|
│ ├── TECHNICAL_SPECIFICATIONS.md # 기술 사양서
|
|
│ └── SETUP_GUIDE.md # 설치 가이드 (예정)
|
|
│
|
|
└── Assets/ # 공용 리소스
|
|
├── Models/ # 아바타 모델
|
|
├── Animations/ # 테스트 애니메이션
|
|
└── TestData/ # 테스트 데이터
|
|
```
|
|
|
|
## 🚀 빠른 시작
|
|
|
|
### 필요 조건
|
|
- Unity 2022.3 LTS 이상
|
|
- 모던 웹 브라우저 (Chrome, Firefox, Safari, Edge)
|
|
- 모션캡쳐 장비 (Kinect, OptiTrack 등)
|
|
|
|
### 설치 및 실행
|
|
1. **저장소 클론**
|
|
```bash
|
|
git clone https://github.com/yourrepo/RemoteMotionCapture.git
|
|
cd RemoteMotionCapture
|
|
```
|
|
|
|
2. **Unity 프로젝트 열기**
|
|
- Unity Hub에서 `Unity/` 폴더 열기
|
|
- `MotionCaptureStudio.unity` 씬 로드
|
|
|
|
3. **웹 클라이언트 실행**
|
|
- `WebClient/index.html` 파일을 브라우저에서 열기
|
|
- 또는 로컬 서버 실행:
|
|
```bash
|
|
cd WebClient
|
|
python -m http.server 8000 # Python 3
|
|
# 브라우저에서 http://localhost:8000 접속
|
|
```
|
|
|
|
4. **연결 확인**
|
|
- Unity에서 Play 버튼 클릭
|
|
- 웹 페이지에서 연결 상태 확인
|
|
- 실시간 아바타 움직임 확인
|
|
|
|
## 📖 사용법
|
|
|
|
### 기본 워크플로우
|
|
1. **연결**: 웹 브라우저에서 Unity 서버에 접속
|
|
2. **관찰**: 실시간 3D 아바타로 모션 확인
|
|
3. **녹화**: 웹에서 녹화 시작/정지 버튼 클릭
|
|
4. **다운로드**: 녹화 완료 후 원하는 포맷으로 파일 다운로드
|
|
|
|
### 지원 파일 포맷
|
|
- **BVH**: 범용 모션캡쳐 포맷
|
|
- **FBX**: Unity, Maya, Blender 등에서 사용
|
|
- **JSON**: 커스텀 데이터 분석용
|
|
|
|
## 🔧 개발 가이드
|
|
|
|
### Unity 개발
|
|
- `Scripts/` 폴더의 스크립트 수정
|
|
- EasyMotionRecorder와의 연동 확인
|
|
- WebSocket 통신 테스트
|
|
|
|
### 웹 클라이언트 개발
|
|
- `js/` 폴더의 모듈별 개발
|
|
- Three.js 3D 렌더링 최적화
|
|
- 파일 출력 형식 추가
|
|
|
|
자세한 개발 가이드는 [`Documentation/TECHNICAL_SPECIFICATIONS.md`](Documentation/TECHNICAL_SPECIFICATIONS.md)를 참조하세요.
|
|
|
|
## 🤝 기여하기
|
|
|
|
1. Fork the Project
|
|
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
|
|
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
|
|
4. Push to the Branch (`git push origin feature/AmazingFeature`)
|
|
5. Open a Pull Request
|
|
|
|
## 📄 라이선스
|
|
|
|
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 `LICENSE` 파일을 참조하세요.
|
|
|
|
## 📞 연락처
|
|
|
|
프로젝트 관련 문의: [이메일 주소]
|
|
|
|
프로젝트 링크: [https://github.com/yourrepo/RemoteMotionCapture](https://github.com/yourrepo/RemoteMotionCapture)
|
|
|
|
## 🙏 감사의 말
|
|
|
|
- EasyMotionRecorder 개발팀
|
|
- Three.js 커뮤니티
|
|
- Unity Technologies
|
|
|
|
---
|
|
|
|
*원격 모션캡쳐의 새로운 가능성을 함께 열어가요! 🚀*
|