Room 가이드 · 약 15분
Room에 TV 추가하기.
Room 모델의 평면 화면을 바라보고 핀치하여 깨운 뒤 웹 페이지를 시청할 수 있는 TV로 만드세요. Room 제작 스킬 또는 사용 중인 3D 도구로 제작할 수 있습니다.
Locus 1.4.9 이상 필요 · 완전한 Package v2Room TV 작동 방식
완전한 Package v2의 Room에는 최대 4대의 TV를 선언할 수 있습니다(기존 플랫 Room ZIP 형식은 tvs). 각 TV는 scene.usdz 의 평면 16:9 화면 쿼드 하나를 Virtual Space의 대화형 화면으로 만듭니다.
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를 켜진 상태로 시작하거나 기본 URL을 불러오도록 설정할 수 없습니다.
- 바라보고 핀치하여 켜기. Virtual Space에서 화면을 바라보고 핀치하면 TV가 켜지고 화면 아래에 리모컨이 나타납니다.
- Locus Browser에서 페이지 보내기. 사용하다 Play on TV 브라우저 윈도우에서 지정한 TV로 페이지를 재생하고, 윈도우에서 열기 로 다시 창으로 되돌립니다.
- Virtual Space 전용. Room TV는 3D Room 모델의 일부이므로 Room Portal에서는 표시되지 않습니다.
옵션 1 · AI 워크플로우
Room 스킬로 AI 에이전트에게 요청하기
만약 나만의 룸 만들기 및 공개 Room 제작 스킬(build-original-locus-room), 해당 스킬에 TV 화면 지오메트리, 좌석 정렬 및 검증 단계가 이미 포함되어 있습니다.
- 공개 저장소 복제 하고, Blender 및 Xcode 명령줄 도구를 실행할 수 있는 에이전트 세션에서 여세요.
- TV 크기, 배치 위치, 시청할 좌석을 지정하세요. 벽걸이형, 콘솔형, 벽난로 위 아트 TV 중 원하는 형태를 말하고, 리모컨을 위해 화면 아래 공간을 비워 두라고 지시하세요.
- 에이전트가 제작, 검사, 패키징하도록 하기 패키지로 내보내도록 하세요:
.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 화면은 명확한 이름을 가진 별도의 메시 오브젝트여야 합니다:
- 하나의 평평한 16:9 쿼드. 높이가 0.3m 이상인 4개 정점, 2개 삼각형의 단일 평면 메시를 독립된 이름의 오브젝트로 모델링하세요.
- 깔끔한 0–1 UV. 매핑:
u화면 정면에 앉았을 때 왼쪽에서 오른쪽으로,v아래에서 위로 매핑하고 노멀은 시청자를 향하게 하세요. - 다른 바인딩과 분리하세요. 다음 필드에 지정된 엔티티 안에 화면을 중첩하지 마세요:
lighting,ambientAnimations,videoSurfaces,spatialAdaptation, 또는 다른 TV 안에 중첩하지 마세요. - 동일 평면 겹침을 피하세요. Z-파이팅이 발생하지 않도록 화면 쿼드를 베젤, 뒷판 또는 벽보다 몇 밀리미터 앞에 배치하세요.
- 꺼짐 상태 머티리얼을 작성하세요. 방출값이 없는
UsdPreviewSurface(방출값 0으로 설정하여 입장 시 꺼져 보이도록 합니다). - 리모컨 공간과 좌석을 확보하세요. TV 앞쪽(화면 법선 기준 약 45° 이내)에 최소 한 개 이상의 텔레포트 좌석을 두고, 화면 바로 아래에는 선반이나 높은 소품을 두지 마세요.
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. | 각 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.locusplacetools/check_room.py 는 각 화면이 2개의 삼각형으로 된 단일 평면 쿼드인지, 다른 바인딩된 엔티티 내부에 중첩되지 않았는지, 16:9 비율, 비발광 꺼짐 상태 머티리얼, 깔끔한 UV 및 전방을 향한 좌석이 있는지 검사합니다. 가져오기 전에 3D 소스에서 오류나 경고를 수정하세요.
- 패키징한
.locusplace를 iCloud Drive에 저장하거나 AirDrop으로 Apple Vision Pro에 전송하세요. - Places → Import → Import a Room → Files로 가져오기로 가져온 뒤 Virtual Space에서 여세요.
- TV를 향한 모든 좌석에 앉아 보세요. 화면을 바라보고 핀치하여 켠 뒤 Play on TV 및 윈도우에서 열기, 리모컨 조작 거리와 시청 편안함을 확인하세요.
디자인 팁 및 제한
- Room당 최대 TV 4대. 각 TV에는 고유한
id및 고유한entityName. - 별도의 오디오 또는 비디오 에셋 파일이 필요하지 않습니다. 다음과 달리
videoSurfaces(패키지된.mp4)와 달리 TV는 실시간 웹 콘텐츠를 재생하므로luminaireGroupID. - 시청 거리에 맞게 크기를 정하세요. 소파 거리 2.5~3m에서는 대각선 65~75인치 화면이 공간 비율을 해치지 않고 자연스럽습니다.