> 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 지원 팀에 알려주세요.

## 센서가 목록에 없거나 Disconnected

전원과 랜선을 확인하고 **Connect sensors**에서 **Detect again**을 선택합니다.

## 센서가 Standby 또는 No data

연결은 됐지만 데이터가 오지 않는 상태입니다. Calibration Step 1이면 **Sensor stream → Try again**, 그 외에는 **Settings**를 열어 시작하거나, 실행 중이면 **Restart**합니다.

## PTP sync가 초록색이 되지 않음

MOVIN 지원 팀에 문의해주세요.

## 뷰가 비어 있음

시작 후 5\~15초는 정상입니다. 그 뒤에도 비어 있으면 **Sensors** 표시등과 뷰포트 **Display** 선택을 확인하고 **Restart**합니다.

## 3D 장면이 납작하게 보임

MOVIN 지원 팀에 문의해주세요.

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

센서가 움직였거나 저장된 캘리브레이션이 맞지 않는 상태입니다. 파이프라인을 멈추고 다시 캘리브레이션합니다.

## Calibration을 열 수 없음

파이프라인이 실행 중이면 잠깁니다. 중지를 확인하면 열립니다.

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

Step 2는 모든 센서가 ready가 될 때까지 수집합니다. Step 5는 **World solve**가 끝난 뒤 몇 초 기다립니다.

## Refine 후 잔차(residual) 경고

**Capture more**로 더 수집하고 **Refine again**합니다. 계속되면 지원 팀에 문의해주세요.

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

파이프라인이 실행 중이고 무대가 비어 있어야 합니다. **Remove background**를 껐다 켜고 **Learn a new one**을 선택합니다.

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

캡처 영역 경계, 센서 가림, **Max tracked people**을 확인합니다.

## 쇼 중에 LiDAR offline 알림

센서 하나가 끊겼고 쇼는 남은 센서로 계속됩니다. 전원과 랜선을 확인하고, 바로 복구할 수 없으면 **Acknowledge**로 경고를 닫습니다.

## 수신 프로그램에 데이터가 안 들어옴

1. **OSC output**의 **Target IP**·**Target port**를 확인합니다. 실행 중에 바꿨다면 옆의 **Apply**를 눌러야 적용됩니다.
2. **Test connection**을 눌러봅니다. 수신 컴퓨터가 응답해도 `/movin/test`가 안 보이면 수신 포트, UDP 입력, 주소 필터, 방화벽 문제입니다.
3. 테스트는 되는데 공연 데이터가 없으면 **LIVE** 상태인지, 선택한 **Source**에 점이 있는지 확인합니다.

## "Backend unreachable" 배너

제어 서비스가 응답하지 않는 상태입니다. 잠시 기다리고, 계속되면 지원 팀에 문의해주세요.

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

납품·설치 때 받은 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.