> For the complete documentation index, see [llms.txt](https://melissa-industry.gitbook.io/openmascotai_hologram/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://melissa-industry.gitbook.io/openmascotai_hologram/5./future.md).

# 앞으로 만들 것

하드웨어는 다 준비되어 있지만, 홀로그램 전용 소프트웨어는 아직 없습니다. 어떤 것을 만들 계획인지와 그 전까지 어떻게 쓰는지입니다. 설계의 근거는 리포 `docs/specs/2026-09-26-hologram-device-design.md` 6장에 있습니다.

## 만들 순서

| 순서 | 무엇                | 하는 일                                                                    | 그 전까지                                                                                  |
| -- | ----------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 1  | **홀로그램 출력 모드**    | 세로 화면 · 좌우 반전 · 검정 배경 · 실제 크기(310 mm) · 창 UI 숨김 · 사람이 없으면 화면 끄기         | 공개 클라이언트를 세로 모니터에 그대로 띄움([OpenMascotAI 설치](/openmascotai_hologram/5./openmascotai.md)) |
| 2  | **센서 허브 펌웨어와 연동** | 허브가 USB로 JSON 메시지를 보내고 받음: 재실 · 터치 · 조도 → 클라이언트, 감정 색 LED · 표시등 ← 클라이언트 | 벤치 시험 스케치(LED 무지개 · 팬 · 온도)를 올려 둠                                                      |
| 3  | **카메라 시선과 운동 시차** | 얼굴을 찾아 캐릭터가 쳐다보고, 머리를 움직이면 캐릭터가 공간에 고정된 것처럼 보임(VRM)                     | 카메라는 꽂아만 둠                                                                             |

## 어디에 만드나

홀로그램 기능은 **공개 OpenMascotAI 클라이언트에 넣지 않습니다**. 공개 클라이언트를 복사한 비공개 앱에 홀로그램 전용 폴더와 씬만 더해 만들 계획입니다. 서버는 바꿀 것이 없습니다. 기기는 다른 client\_id로 붙는 또 하나의 클라이언트일 뿐입니다.

## 허브 메시지 약속(계획)

USB 직렬 115200 bps, JSON 한 줄씩.

| 방향         | 예                                                                                    |
| ---------- | ------------------------------------------------------------------------------------ |
| 허브 → 클라이언트 | `{"t":"hello","fw":"1.0.0","caps":["presence","touch","lux","led"]}`                 |
|            | `{"t":"presence","on":true,"dist_cm":120,"moving":true}`                             |
|            | `{"t":"touch","pad":"head","ev":"down"}`                                             |
|            | `{"t":"lux","v":87.5}`                                                               |
| 클라이언트 → 허브 | `{"t":"led","zone":"stage","rgb":[80,200,255],"level":0.3,"fx":"breathe","ms":1500}` |
|            | `{"t":"camled","on":true}`                                                           |

터치 패드는 기존 터치 반응(머리 쓰다듬기 · 팔 · 콕 찌르기)에 연결하고, LED 색은 감정 카드 색을 그대로 씁니다. 조도로 LED와 배경판 밝기를 정하되, 배경판은 IPS 검정 누설을 가리는 최소 밝기를 유지합니다.

## 지금 상태에서 이 설명서로 할 수 있는 것

* 외함 완성, 전장 완성, LED · 팬 · 센서 벤치 시험 통과
* SER8에서 OpenMascotAI 클라이언트로 캐릭터가 세로 화면에 서서 말하고 듣기
* 유리에 비친 캐릭터를 보며 방향 · 크기 · 배경판 밝기 맞추기

출력 모드가 만들어지면 이 장을 고치고, 설치법을 [OpenMascotAI 설치](/openmascotai_hologram/5./openmascotai.md)에 더합니다.