저작 가이드
맞춤형 보기 또는 방을 만드세요.
기능을 완전히 전달하고 안정적으로 업데이트하려면 완전한 Package v2를, 호환성에는 legacy/simple 평면 ZIP을, 또는 완전한 파노라마를 View로 직접 가져오세요.
방 v1–v5 · v1–v2 보기가이드 경로를 선택하세요
지원 수입
| 행동 | 입력 | 출처 |
|---|---|---|
| 뷰 가져오기 | 완전한 2:1 등각원통 JPEG, PNG 또는 HEIC 이미지, View가 포함된 완전한 Package v2 ZIP 또는 legacy/simple 평면 View ZIP | 이미지에는 사진을, 이미지와 ZIP에는 파일 또는 직접 열 수 있는 공개 HTTPS URL을 사용하세요. |
| 룸 가져오기 | Room이 포함된 완전한 Package v2 ZIP 또는 legacy/simple 평면 Room ZIP | 파일 또는 직접 공개 HTTPS URL |
Complete Package v2 수입은 Locus 1.2.1 이상에서 사용할 수 있습니다. 브라우저 이미지 포함 직접 수입되는 파노라마 이미지의 4K 최소값은 ZIP 형식과 별개입니다. Complete 패키지는 안정적인 ID를 유지하고 의미 체계를 업데이트합니다. 평면 호환 ZIP 파일과 직접 수입되는 파노라마 이미지는 매 수입 시 새로운 UUID을 받습니다.
세 개의 완전한 방을 시도해 보세요
Room v5를 지원하는 Locus 빌드와 함께, ZIP을 다운로드하여 파일에 저장한 다음 선택하십시오. 룸 가져오기. 이러한 공공 예시에는 책상 좌석과 방문자 제어 조명이 포함됩니다. 이들은 2026년 9월 5일 작성된 수출 버전(Atrium Loft 1.0.14, Courtyard Gallery 1.0.16, Horizon Atelier 1.0.18)과 일치합니다.
이전 빌드를 사용하고 있습니까? 이전 호환 버전 다운로드: 아티움 로프트, 현관 갤러리, 호라이즌 아틀리에.
이 예시들을 아래에 있는 Locus과 함께 사용하세요. Locus 자산 권리.
실험적인 방 애니메이션을 시도해 보세요
클라우드 팬 파빌리온은 Locus Places에서 다운로드할 수 있는 무료 방으로, 바람에 따라 계속 움직이는 넓은 잎의 식물이 있습니다. 애니메이션 메타데이터, 재생, 빠른 컨트롤 및 모션 설정, 속도 및 재생 간격은 실험적이며 변경될 수 있습니다.
당신의 방을 가져오세요
이미 알고 있는 모델링, 재료 및 조명 워크플로우를 사용하십시오. Locus은 자체 포함된 USDZ와 개방, 좌석, 선택적 테이블톱 매핑 및 벽 또는 지붕 엔티티 참조, 선택적 방문자 제어 조명, 선택적 라운지 좌석 및 숨겨진 책상 그룹(Locus 1.1.5), 선택적 좌석 그룹(Locus 1.2.0), 그리고—실험을 선택할 때—방 애니메이션만 필요합니다.
정통 완전 패키지 v2
complete-place.zip
├── locusplace.json
└── catalog/
├── destinations/<destination-id>/destination.json
├── spaces/<space-id>/space.json
└── experiences/<experience-id>/experience.json # optional두다 locusplace.json 그리고 catalog/ ZIP 루트 바로에서—외부 래퍼 폴더 내부에 절대 들어가지 않습니다. 콘텐츠 자산은 일치하는 목적지, 공간 또는 Experience 디렉토리 아래에 유지됩니다. Locus은 동일한 ZIP 바이트를 가진다 .zip 또는 .locusplace 파일명.
이 형식은 저자가 작성한 안정적인 ID, 미디어 및 마스크를 보존합니다, sourceImage, 소유자 확인 USDZ midground 경관 및 렌더러 소유의 물, 뷰 및 방 사운드, 방 애니메이션, 비디오 표면 및 좌석 그룹, 출처 및 지원되는 번들된 경험. 그 포괄적 선언은 packageID, contentVersion, minimumAppVersion, 콘텐츠 ID, 파일 해시 및 크기, 그리고 contentHash. Locus은 정확한 인벤토리, 안전한 경로, 해시, 리소스 제한, 기능 및 최소 앱 버전을 검증합니다. 불완전한 전체 패키지는 평평한 ZIP으로 다시 시도하는 대신 거부됩니다.
legacy/simple Room ZIP 레이아웃
my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
├── thumbnail.jpg
├── sound.json # optional, Locus 1.1.4
└── forest-air.m4a # one or more, only with sound.json이 호환성 형식에서는 ZIP 루트에서 모든 다섯 개의 파일이 필요합니다. space.json 포함한다 displayName; 자산 ID가 포함되어 있지 않으며, 각 수입은 새로운 UUID를 받습니다. 상위 폴더, 편집 가능한 소스, GLB, 소스 텍스처 또는 기타 파일을 추가하지 마십시오. Locus은 하나가 누락될 경우 썸네일을 생성하지 않습니다. 방에는 자체 사운드가 포함될 수도 있습니다: 추가 sound.json 그리고 루트에 있는 오디오 파일은 설명되어 있습니다. 형식 참조. 모든 오디오 파일은 출처로 명명되어야 합니다. sound.json, 그리고 그것이 없는 오디오는 거부됩니다.
legacy/simple View ZIP 레이아웃
my-view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
├── lighting.jpg # optional
├── sound.json # optional, Locus 1.1.4
└── waterfall.m4a # one or more, only with sound.json파노라마는 완전한 2:1 직사각형 이미지여야 합니다. 패키지된 뷰는 시작 방향, 밝기, 대비, 채도, 방 조명, 수평 높이 및 선택적 일광을 설정할 수 있습니다. view.json. 사용자는 나중에 이것들을 통해 변경할 수 있습니다. 뷰 편집. 한 관점은 또한 방과 동일한 용어로 자체적인 소리를 가질 수 있으며, 설명된 형식 참조.
Locus에서 보기 조정
뷰 편집 제공한다 뷰 밝기, 대비, 색상, 방 조명, 햇빛 추가, 태양 위치, 햇빛 강도, 그리고 뷰 회전. 설정은 해당 보기용으로 저장됩니다.
외관 필드 보기
| 필드 | 사용하다 |
|---|---|
panorama.initialYawDegrees | 시작 방향. |
environment.skyGainEV | 가시적 보기 밝기. |
environment.exposureEV | 방 조명 강도. |
environment.horizonPitchDegrees | 호라이즌 조정. |
environment.colorGrade.contrast | 대조에서 0.5 에 2.0; 1.0 중립적이다. |
environment.colorGrade.saturation | 포화에서 0 에 2.0; 1.0 중립적이다. |
environment.directSun | 선택 가능한 일광 방향과 강도. |
environment.condition | 방 조명 스위치에 대한 v2 제안을 확인하세요: 낮, 황혼, 밤 또는 흐린 날씨. |
출처
모든 방과 전망에는 필요합니다 provenance.json. 크리에이터 또는 기관, 권리, 요청된 크레딧, 변경 사항 및 AI 사용을 진실되게 기록하십시오. 정확히 하나를 제공하십시오. license 또는 rights, 형식 참조에 설명된 대로. 언제 aiGenerated 는 true, 포함 aiProvider; 거짓인 경우 이를 생략하십시오. 라이선스는 자산에 대한 권리를 설명합니다; App Store EULA는 자산 라이선스가 아닙니다. 보다 Locus 자산 권리 Locus이 작성한 예시의 경우.
호환성 ZIP을 패키징하고 검증합니다.
현재 공개 Python 도구는 legacy/simple 평면 형식만 만들고 검증하며 완전한 Package v2는 검증하지 않습니다. Room 파일 5개 또는 필수 View 파일 4개를 한 디렉터리에 두고 macOS에서 포함된 도구를 실행하세요.
python3 tools/pack_locus_asset.py /absolute/path/to/asset /absolute/path/to/asset.zip
python3 tools/validate_locus_asset.py /absolute/path/to/asset.zipRoom 검증기는 Xcode의 usdchecker. 유효한 결과는 아카이브와 기계 읽을 수 있는 자산을 확인합니다; 정확한 ZIP을 가져오고 모든 좌석을 시도하는 것을 대체하지 않습니다.