> For the complete documentation index, see [llms.txt](https://help.movin3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.movin3d.com/kr/movin-studio-usage-guide/live-streaming/streaming-mocap-data-into-touchdesigner.md).

# Streaming Mocap Data into TouchDesigner

**TouchDesigner**는 Derivative에서 개발한 노드 기반 실시간 제작 툴로, 인터랙티브 미디어나 공연, 전시 등에서 실시간 그래픽과 시스템 연동을 빠르게 구현할 수 있습니다.

MOVIN TRACIN과 MOVIN Studio로 캡처한 모션 데이터는 TouchDesigner로 실시간 스트리밍하여, 사람의 움직임을 트리거로 한 비주얼 이펙트나 조명, 사운드 제어에 활용될 수 있어, 라이브 퍼포먼스와 인터랙티브 콘텐츠 제작에 바로 활용할 수 있습니다.

MOVIN Studio에서 TouchDesigner로의 모션 데이터 및 포인트 클라우드 스트리밍 방법은 [TouchDesigner 공식 문서](https://derivative.ca/UserGuide/Movin3D)에서도 확인할 수 있습니다.

{% stepper %}
{% step %}

### OSC In CHOP을 추가해주세요.

<figure><img src="/files/QgRtMScIxYXnBGWmm7mI" alt=""><figcaption></figcaption></figure>

* TouchDesigner 프로젝트에서 우측 마우스 클릭 > Add Operator를 선택한 뒤, CHOP 탭에서 OSC In을 선택해 추가해주세요.
* Network Port를 11237로 설정해주세요.
  {% endstep %}

{% step %}

### NULL CHOP을 추가해주세요.

<figure><img src="/files/nVGDzQWuIegSZBFjfMbC" alt=""><figcaption></figcaption></figure>

* TouchDesigner 프로젝트에서 우측 마우스 클릭 > Add Operator를 선택한 뒤, CHOP 탭에서 NULL을 선택해 추가해주세요.
* [#touchdesigner-osc-in-chop](#touchdesigner-osc-in-chop "mention")에서 생성한 OSC In CHOP과 NULL CHOP을 연결해주세요.
* NULL CHOP의 설정 내 common 탭에서 Export Method를 'Channel Name is Path:Parameter'로 설정해주세요.
  {% endstep %}

{% step %}

### MOVIN Studio와 TouchDesigner에 동일한 캐릭터를 불러와주세요.

<figure><img src="/files/bsKAESDqC8I8GZocmgpt" alt="" width="375"><figcaption></figcaption></figure>

* TouchDesigner에 사용할 FBX 캐릭터 파일을 불러와주세요.

<figure><img src="/files/ElvgxxF7dZUy14ESxKST" alt="" width="375"><figcaption></figcaption></figure>

* MOVIN Studio에도 TouchDesigner에 불러온 동일한 FBX 캐릭터 파일을 불러와주세요.
  * 캐릭터를 불러오는 방법에 대해서는 [Import Custom Character](/kr/movin-studio-usage-guide/import-custom-character.md)를 참고해주세요.
* <mark style="background-color:$primary;">**TouchDesigner에 설정된 노드의 이름과 MOVIN Studio에서 설정된 캐릭터의 이름이 동일**</mark>한지 확인해주세요.&#x20;

{% hint style="warning" %}
MOVIN Studio에서 설정된 캐릭터의 이름과 TouchDesigner에서 설정된 FBX 노드의 이름이 동일하지 않을 경우, 라이브 스트리밍이 원활하게 작동하지 않습니다.&#x20;
{% endhint %}
{% endstep %}

{% step %}

### MOVIN Studio에서 TouchDesigner로의 스트리밍을 시작해주세요.

<figure><img src="/files/tyLFmWNXLupbOlJz2ee9" alt=""><figcaption></figcaption></figure>

* TouchDesigner에서 설정한 포트 번호가 MOVIN Studio에 동일하게 작성되어 있는지 확인해주세요.
  * MOVIN Studio v2.1.0부터는 포인트 클라우드 데이터까지 라이브 스트리밍할 수 있습니다.
* MOVIN Studio에서 TouchDesigner로의 스트리밍을 시작해주세요.
  {% endstep %}

{% step %}

### NULL CHOP의 Export 옵션을 켜주세요.

<figure><img src="/files/qhxgXyDbZ6xw87Hwsaor" alt=""><figcaption></figcaption></figure>

* TouchDesigner 프로젝트의 NULL CHOP 우측 하단의 초록색 원형으로 표시된 Export 옵션을 켜주세요.

<figure><img src="/files/ESJPs4LJKoum9cJL7eT6" alt=""><figcaption></figcaption></figure>

* NULL CHOP과 캐릭터가 회색 점선으로 연결되며, 캐릭터에 MOVIN Studio의 모션 데이터가 실시간 스트리밍되는 것을 확인할 수 있습니다.
  {% endstep %}
  {% endstepper %}

* [MOVIN의 공식 다운로드 페이지](https://www.movin3d.com/downloads#movin-studio)의 'Download TouchDesigner Sample Project'를 클릭하면 위의 과정이 적용된 예시 프로젝트를 다운로드 받을 수 있습니다. 해당 프로젝트를 확인해 사용 방법을 익혀보세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.movin3d.com/kr/movin-studio-usage-guide/live-streaming/streaming-mocap-data-into-touchdesigner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.