본문으로 건너뛰기

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로 스트리밍하기: 단계별 안내

  1. 뷰어를 설정하고 실행해주세요.

    • 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과 같이 실행해주세요.
  2. 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가 표시됩니다.
  3. 뷰어에서 스트리밍을 확인해주세요.

    • 뷰어에는 캐릭터별 이름, 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의 수신을 허용해주세요.