Room TV 작동 방식

완전한 Package v2의 Room에는 최대 4대의 TV를 선언할 수 있습니다(기존 플랫 Room ZIP 형식은 tvs). 각 TV는 scene.usdz 의 평면 16:9 화면 쿼드 하나를 Virtual Space의 대화형 화면으로 만듭니다.

Gallery 실전 예제: Hilltop Villa. 참고: Gallery의 Hilltop Villa (및 해당 페이지에 안내된 1.0.17 Locus 1.5.0용 Package v2 아카이브와 Blender 소스 포함). 한 Room 안에 대비되는 두 대의 TV를 배치했습니다: 거실 벽난로 위의 98인치 액자형 아트 TV(living-tv / TV_Screen_Living)과 위층 스카이 룸의 65인치 다크 글라스 TV(sky-room-tv / TV_Screen_Sky_Room).
TV의 두 가지 활용 방식. 어두운 유리 머티리얼로 일반 벽걸이·거실장 TV를 만들거나, 그림 텍스처를 입혀 켜기 전까지 공간에 자연스럽게 어우러지는 아트 TV로 만들 수 있습니다.

옵션 1 · AI 워크플로우

Room 스킬로 AI 에이전트에게 요청하기

만약 나만의 룸 만들기 및 공개 Room 제작 스킬(build-original-locus-room), 해당 스킬에 TV 화면 지오메트리, 좌석 정렬 및 검증 단계가 이미 포함되어 있습니다.

  1. 공개 저장소 복제 하고, Blender 및 Xcode 명령줄 도구를 실행할 수 있는 에이전트 세션에서 여세요.
  2. TV 크기, 배치 위치, 시청할 좌석을 지정하세요. 벽걸이형, 콘솔형, 벽난로 위 아트 TV 중 원하는 형태를 말하고, 리모컨을 위해 화면 아래 공간을 비워 두라고 지시하세요.
  3. 에이전트가 제작, 검사, 패키징하도록 하기 패키지로 내보내도록 하세요: .locusplace 아카이브로 내보내세요.
에이전트에게 보낼 프롬프트build-original-locus-room 스킬을 사용해 아늑한 미디어 룸을 만들어 주세요. 약 3m 맞은편 벽의 75인치 TV를 향하는 깊은 소파, TV 아래 낮은 월넛 콘솔, 따뜻한 벽 조명, 한쪽의 큰 창문을 배치해 주세요.
에이전트에게 보낼 프롬프트벽난로 위 주 좌석 구역을 향하도록 65인치 아트 TV를 추가하고, 꺼져 있을 때는 유화를 표시하며 리모컨을 위해 아래 공간을 비워 두세요.

직접 제작하기 전에 작동하는 참고 예제를 보려면 다음을 실행하세요: Example Media Room 생성기:

python3 examples/media-room/build_media_room.py /tmp/media-room
python3 tools/check_room.py --current-app-version 1.4.9 \
  --renders /tmp/media-room-renders /tmp/media-room/media-room.locusplace

옵션 2 · 수동 3D

3D 씬에서 화면 쿼드 모델링하기

Blender나 다른 USDZ 파이프라인에서 각 TV 화면은 명확한 이름을 가진 별도의 메시 오브젝트여야 합니다:

Package v2

선언하기: tvs 안에 space.json

설정: "minimumAppVersion": "1.4.9" (또는 이후 버전)으로 locusplace.json로 설정한 다음, 다음 파일에 최상위 tvs 배열을 다음에 추가하세요: space.json (1~4개 항목):

{
  "tvs": [
    {
      "id": "living-tv",
      "displayName": "Living Room TV",
      "entityName": "TV_Screen_Living"
    },
    {
      "id": "sky-room-tv",
      "displayName": "Sky Room TV",
      "entityName": "TV_Screen_Sky_Room"
    }
  ],
  "localizations": {
    "zh-Hans": {
      "tvTitles": {
        "living-tv": "客厅电视",
        "sky-room-tv": "玻璃房电视"
      }
    }
  }
}
필드규칙
id필수, 다음 배열에서 고유해야 함: tvs, 1~64바이트의 영문 소문자, 숫자, 하이픈([a-z0-9-]).
displayName필수, 공백 불가, 최대 200 UTF-8바이트. 다음 메뉴에 표시됩니다: Play on TV 메뉴.
entityName필수, tvs, 공백 불가, 최대 200 UTF-8바이트. 다음 파일의 메시를 포함한 오브젝트 이름과 정확히 일치해야 합니다: scene.usdz.
localizations.<lang>.tvTitles각 TV의 다음 키를 기준으로 한 선택적 번역: id.

검증

패키징, 검사 및 Apple Vision Pro 테스트

Package v2 디렉터리를 패키징하고 다음 옵션으로 패키지 검증기와 macOS Room 검사기를 모두 실행하세요: --current-app-version 1.4.9 (또는 이후 버전):

python3 tools/pack_locusplace.py --current-app-version 1.4.9 \
  /absolute/path/to/MyRoomDir /absolute/path/to/MyRoom.locusplace

python3 tools/check_room.py --current-app-version 1.4.9 \
  --renders /absolute/path/to/my-room-renders \
  /absolute/path/to/MyRoom.locusplace

tools/check_room.py 는 각 화면이 2개의 삼각형으로 된 단일 평면 쿼드인지, 다른 바인딩된 엔티티 내부에 중첩되지 않았는지, 16:9 비율, 비발광 꺼짐 상태 머티리얼, 깔끔한 UV 및 전방을 향한 좌석이 있는지 검사합니다. 가져오기 전에 3D 소스에서 오류나 경고를 수정하세요.

  1. 패키징한 .locusplace 를 iCloud Drive에 저장하거나 AirDrop으로 Apple Vision Pro에 전송하세요.
  2. Places → Import → Import a Room → Files로 가져오기로 가져온 뒤 Virtual Space에서 여세요.
  3. TV를 향한 모든 좌석에 앉아 보세요. 화면을 바라보고 핀치하여 켠 뒤 Play on TV 및 윈도우에서 열기, 리모컨 조작 거리와 시청 편안함을 확인하세요.

디자인 팁 및 제한