> 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/movin-tracin-stage-kr/reference/troubleshooting.md).

# 문제 해결

아래에서 증상을 찾아주세요. 공연 중 **Restart**는 처리와 송출을 잠시 멈춥니다.

## 화면이 열리지 않을 때

* **No signal:** 모니터 전원, 선택한 입력, 서버와 연결한 HDMI 케이블을 확인해주세요.
* **바탕화면만 보임:** 서버의 브라우저에서 `http://localhost:8000`을 열어주세요.
* **부팅 후에도 페이지가 열리지 않음:** 표시된 오류를 MOVIN 지원 팀에 알려주세요.

연결 순서는 [서버 연결 및 전원 켜기](/movin-tracin-stage-kr/undefined/server-back.md)에 있습니다.

## OSC 테스트는 되는데 공연 데이터가 안 들어올 때

**Test connection**의 ping 응답은 수신 프로그램이 받았다는 뜻이 아닙니다. 수신 프로그램에서 `/movin/test`가 보이는지, GO LIVE 후 실제 메시지가 들어오는지 [첫 데이터 수신 확인](/movin-tracin-stage-kr/setup/receive-output.md) 순서로 점검해주세요. 수신 IP, UDP 포트, 주소 필터, 방화벽을 확인합니다.

## 센서가 목록에 없거나 **Disconnected**로 표시됨

센서 전원과 네트워크 케이블을 확인해주세요. **Connect sensors**(Calibration 스테이지)에서 **Detect again**을 선택합니다.

## 센서가 **Standby** 또는 **No data**로 표시됨

센서는 연결됐지만 데이터가 오지 않는 상태입니다. 캘리브레이션 Step 1에서는 **Sensor stream → Try again** 안내가 나타나므로 그것을 선택해주세요. 그 외에는 파이프라인이 멈춰 있으면 **Settings**를 열어 시작하고, 이미 실행 중이면 **Restart**를 선택합니다.

## 3D 장면이 납작하게(모든 점이 바닥에) 보임

센서 문제일 수 있습니다. MOVIN 지원 팀에 문의해주세요.

## 센서의 **PTP sync**가 초록색이 되지 않음

시간 동기화가 되지 않는 상태입니다. 네트워크 또는 하드웨어 문제이니 MOVIN 지원 팀에 문의해주세요.

## 워밍업이 끝나도 뷰가 비어 있음

시작 후 5\~15초는 정상입니다. 그 뒤에도 비어 있으면 **Sensors** 표시등과 뷰포트의 Display 선택을 확인한 뒤 **Restart**를 선택해주세요. 여전히 비어 있으면 연결을 확인하고 지원 팀에 문의합니다.

## 캘리브레이션 **Confirm**이 비활성

Step 2에서는 모든 센서가 준비될 때까지 계속 수집해주세요. Step 5에서는 **World solve**가 끝난 뒤에도 몇 초간 비활성일 수 있으니 잠시 기다려주세요.

## Refine 후 잔차(residual) 경고가 나타남

Wand를 몇 군데 더 움직여 수집한 뒤(**Capture more**) Refine을 다시 실행해주세요. 경고가 계속되면 MOVIN 지원 팀에 문의해주세요.

## 캘리브레이션을 편집할 수 없고, 선택하면 중지하라고 안내함

파이프라인이 실행 중이면 캘리브레이션이 잠깁니다. 중지를 확인하고 편집한 뒤 다시 라이브로 가면 됩니다.

## 배경 학습이 끝나지 않음

파이프라인이 실행 중이고 무대가 비어 있어야 합니다. **Post processing**에서 **Remove background**를 껐다 켠 뒤 **Learn a new one**을 선택해주세요.

## 무대 가장자리의 사람이 추적되지 않음

캡처 영역 경계, 센서 가림, 거리, **Max tracked people**을 확인해주세요. 계속 놓치면 어느 위치에서 그런지 기록해 지원 팀에 문의합니다.

## 쇼 중에 뷰포트에 *LiDAR … offline*이 나타남

센서 하나가 데이터를 보내지 않는 상태입니다. 쇼는 남은 센서로 계속 진행됩니다. 센서 전원과 네트워크 케이블을 확인하고, 바로 복구할 수 없으면 **Acknowledge**를 선택해 이번 운영 동안 경고를 닫아둡니다.

## 수신 프로그램이 OSC 데이터를 받지 못함

**OSC output**에서 **Target IP**와 **Target port**를 확인하고 **Test connection**을 선택해주세요. 파이프라인 실행 중에 값을 바꿨다면 그 옆의 **Apply** 버튼을 눌러야 적용됩니다.

## 장면이 어긋남(벽이 두 겹)

센서가 움직였거나 저장된 캘리브레이션이 더 이상 맞지 않는 상태입니다. 파이프라인을 멈춘 뒤 다시 캘리브레이션해주세요.

## **"Backend unreachable"** 배너가 나타남

제어 서비스가 응답하지 않는 상태입니다. 재연결을 기다려주세요. 계속되면 MOVIN 지원 팀에 문의해주세요.

## 지원 요청 시 준비할 정보

납품·설치 때 받은 MOVIN 담당 연락처로 아래 내용을 함께 보내주세요.

* 서버 식별 정보, 설치 장소, 문제가 시작된 시각.
* 현재 단계와 정확한 오류 문구. 상단 상태와 Sensors가 보이는 화면 캡처.
* 마지막 정상 동작 이후 바뀐 센서, 세트, 설정.
* 수신 문제라면 프로그램과 버전, Target IP·port, `/movin/test` 수신 여부.
* 재현 방법. 필요하면 [진단용 녹화](https://help.movin3d.com/movin-tracin-stage-kr/reference/pages/zgjMuFLh1QYB3sk9gceR#진단용-녹화) 파일.

화면이 켜지지 않는 경우에는 모니터에 보이는 내용과 서버 뒷면 케이블 연결 사진을 보내주세요.


---

# 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, and the optional `goal` query parameter:

```
GET https://help.movin3d.com/movin-tracin-stage-kr/reference/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.