MOVIN TRACIN · MOVIN Studio Usage Guide
Streaming Mocap Data over OSC
이 문서에서는 MOVIN Studio의 모션 데이터 (필요한 경우 점군 (Point Cloud) 까지) 를 직접 만든 OSC 수신기로 받는 방법을 안내합니다.
OSC 플랫폼은 액터 또는 캐릭터의 모션 데이터를 OSC/UDP로 전송하며, OSC를 읽을 수 있는 앱이나 코드라면 어디서든 사용할 수 있습니다. 스트리밍 상태를 확인하거나 직접 수신기를 만들 때 출발점으로 삼고 싶다면 MOVIN OSC Receiver & Viewer (Python) 를 사용해주세요.
ROS 2의 경우 Streaming Mocap Data into ROS by OSC를, Python 코드는 MOVIN SDK Python을 참고해주세요.
사전 준비사항
- 무료 Basic 라이선스를 사용하는 경우, Capture 화면에서 OSC로 스트리밍하려면 Unlimited 라이선스가 필요합니다.
- 뷰어 사용 시: Windows와 Python 3.11 환경, 그리고 OpenGL을 지원하는 디스플레이를 권장합니다. 연결 상태와 FPS는 MOVIN Studio v3.3.0 이상에서 표시됩니다.
다운로드: MOVIN OSC Receiver 레포지토리에서 MOVIN-OSC-Receiver-v3.3.0.zip을 다운로드해주세요.
OSC로 스트리밍하기: 단계별 안내
-
뷰어를 설정하고 실행해주세요.
- ZIP 파일의 압축을 해제한 뒤, 해당 폴더에서 터미널을 열어주세요.
- 아래 방법 중 하나로 의존성 패키지를 설치해주세요.
# Conda conda env create -f environment.yml conda activate movin-osc# Python venv python -m venv .venv .venv\Scripts\Activate.ps1 pip install -r requirements.txt- 뷰어를 실행해주세요. 뷰어는 11235 포트로 수신합니다.
python main.py- 다른 포트를 사용하려면
python main.py --port 11236과 같이 실행해주세요.
-
MOVIN Studio에서 스트리밍을 시작해주세요.
- 스트리밍 대상 선택: 액터를 선택하거나, Characters 탭에서 캐릭터를 더블 클릭해주세요.
- 하단 패널의 Streaming 섹션에서 ⚙ 버튼을 클릭해 스트리밍 설정을 열어주세요.
- Platform을 OSC로 설정해주세요. Port Number가 11235로 변경됩니다.
- 수신기가 같은 PC에서 실행 중이라면 Host를
127.0.0.1로, 다른 PC에서 실행 중이라면 수신기 PC의 IPv4 주소로 설정해주세요. - 필요한 경우 Additional Data에서 Hand와 Point Cloud를 켜주세요.
- Stream 버튼을 클릭해주세요. 상태가 On으로 표시되고, 뷰어가 응답하면 OSC: connected가 표시됩니다.
-
뷰어에서 스트리밍을 확인해주세요.
- 뷰어에는 캐릭터별 이름, Bone 수, 수신된 모션 FPS와 함께 포인트 수, 점군 FPS, 뷰어 FPS가 표시됩니다.
- 조작 방법: 왼쪽 드래그로 회전, 휠로 확대/축소, R 키로 카메라 초기화, Up / Down 키로 카메라 타깃 이동, Esc 키로 종료합니다.
문제 해결
| 문제 | 확인 사항 |
|---|---|
| 포트가 이미 사용 중입니다 | 해당 포트를 사용하는 다른 수신기를 종료하거나, 두 앱에서 모두 다른 포트를 사용해주세요. |
| 뷰어가 모션을 기다리고만 있습니다 | Platform이 OSC인지, 스트리밍이 켜져 있는지, Host, Port Number, 방화벽 설정이 올바른지 확인해주세요. |
| 점군이 보이지 않습니다 | MOVIN Studio에서 Point Cloud를 켜주세요 (Capture 화면 전용). |
| 실행 시 의존성 또는 OpenGL 오류가 발생합니다 | 올바른 Python 환경을 활성화하고 requirements를 설치한 뒤, 그래픽 드라이버를 확인해주세요. |
다른 PC로 스트리밍하는 경우, 수신기 PC에서 UDP 11235 (또는 사용하는 포트) 의 수신을 허용하고, 연결 상태 확인을 위해 MOVIN Studio PC에서 UDP 39581의 수신을 허용해주세요.