룸 및 뷰 ZIP 참조

Locus 1.2.1 및 이후 버전. 파일에서 또는 View 또는 Room 진입점을 통해 직접 공개 HTTPS URL를 통해 v2 패키지를 완전히 가져옵니다. Locus은 동일한 ZIP 바이트를 사용하지만 .zip 또는 .locusplace 파일명.

완전 패키지 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 루트에 직접 위치하며 외부 래퍼 폴더가 없습니다. 중첩된 catalog/destinations/, catalog/spaces/, 그리고 선택 사항 catalog/experiences/ 경로는 필수 구조입니다. 뷰 임포트는 요청된 뷰를 포함해야 하며, 룸 임포트는 요청된 룸을 포함해야 합니다. 지원되는 경험은 해당 콘텐츠와 함께 번들될 수 있습니다.

봉투는 안정적인 내용 ID를 보존하고 선언합니다 packageID, contentVersion, minimumAppVersion, 콘텐츠 인벤토리, 모든 파일의 바이트 카운트와 SHA-256, 그리고 contentHash. 변경되지 않은 콘텐츠를 다시 가져오는 것은 일종의 불변성입니다; 동일한 패키지 ID 아래의 변경된 콘텐츠에는 더 새로운 콘텐츠 버전과 동일한 선언된 콘텐츠 ID가 필요합니다.

지원되는 완전한 패키지는 미디어와 마스크를 볼 수 있도록 보존합니다, sourceImage, 소유자 확인 USDZ midground 경관 및 렌더러 소유 물 (바람에 흔들리는 소품과 얕은 물 서핑을 포함), 뷰 및 룸 사운드, 룸 애니메이션, 비디오 표면, 조명된 표면, 입자 효과, 베이킹된 라이트 레이어, 시트 그룹, 출처 및 지원되는 경험. Locus은 안전한 경로, 정확한 파일 인벤토리, 해시, 리소스 제한, 필요한 기능 및 최소 앱 버전이 안전한지 검증합니다. 포함된 불완전한 아카이브 locusplace.json 거부되고 평평한 호환성 수입업체로 돌아가지 않습니다.

순수 데이터 계약 하나. 같은 Locus 바이너리에서 지원되는 Room/View 데이터는 번들, Library 다운로드 또는 완전한 공개 ZIP 중 어느 방식이든 같은 렌더링 의미를 가집니다. 패키지에는 형식화된 미디어와 USD/USDZ를 담을 수 있지만 스크립트, 플러그인, 동적 라이브러리, 실행 확장은 포함할 수 없습니다. 미래 콘텐츠 기능도 별도의 공개 가져오기 허용 목록이 아니라 이 공통 계약에 합류합니다. 경계 및 연장 규칙을 읽어보세요.

참조 및 호환성 도구

완료 및 호환성 형식 참조Package v2 구조, ID, 업데이트, legacy/simple 레이아웃, JSON 필드, 제한 및 검사.평평한 호환성 검증기legacy/simple Room 또는 View ZIP을 검사하며 완전한 Package v2는 검증하지 않습니다.평평한 호환성 패커결정적인 legacy/simple ZIP을 만들고 검증합니다.출처 스키마크리에이터, 권리, 크레딧, 변경 사항 및 AI 공개.

legacy/simple Room 파일

room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg

이 평면 호환 형식은 모든 수입 시 새로운 UUID을 받습니다. 모든 파일이 필요합니다. 방에는 최소 하나의 사용 가능한 엔트리 시트가 포함되어야 합니다. 썸네일은 저자가 제공하며, Locus은 수입 시 하나를 캡처하지 않습니다.

legacy/simple View 파일

view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg       # optional

view.json 방향, 가시광도, 방광 강도, 수평 기울기, 대비, 채도 및 선택적 일광을 설정할 수 있습니다. 파노라마는 완전한 2:1 직사각형 이미지입니다.

완성된 방 예시

세 가지 다운로드는 모두 Room v5를 사용하며, 명확한 렌더링 역할과 스포트라이트 방향을 제공합니다. 2026년 9월 5일 업데이트.

Room v5 지원이 필요합니다. Early Locus 1.1.0 빌드(1~3)는 이러한 ZIP 파일을 지원하지 않습니다. Room v5는 Locus 1.1.0 빌드 4부터 지원되며, Locus 1.1.1도 포함됩니다. 설정 → 도움말 및 정보 → Locus에 있는 빌드를 확인하세요.

앱 내 1.1.5 또는 1.2.0 Rooms가 아닙니다. App Store의 Locus 1.1.5용 기본 통합 기능 및 라이브러리 수정을 통해 소파와 라운지 시트와 숨겨진 데스크 그룹이 추가되었습니다; Locus 1.2.0에서는 작성된 시트 그룹이 있는 Seats 선택기에서 관련 시트 그룹을 추가로 그룹화했습니다. 이러한 다운로드 가능한 ZIP 파일은 9월 5일 데스크-시트 패키지에 남아 있어 작성자는 라운지 시트, 숨겨진 데스크 또는 시트 그룹 없이 기본 Room v5 계약을 연구할 수 있습니다. 라운지 시트와 숨겨진 데스크에 대해서는 다음을 참조하십시오. 형식 참조; 좌석 그룹의 경우, 참조하십시오 좌석 그룹 참조.

아티움 로프트2 데스크 시트 · 10.1 MB.현관 갤러리3 데스크 시트 · 10.7 MB.호라이즌 아틀리에3 데스크 시트 · 12.9 MB.

이전 빌드를 사용하고 있습니까? 이전 호환 버전 다운로드: 아티움 로프트, 현관 갤러리, 호라이즌 아틀리에.

실험실 방 애니메이션 샘플

클라우드 팬 파빌리온은 Locus Places에서 다운로드할 수 있는 무료 방으로, 실험 애니메이션 메타데이터와 재생을 보여줍니다. 지속적인 플랜트 브리즈, 애니메이션 스위치, 속도 제어 및 재생 간격 동작이 변경될 수 있습니다.

클라우드 팬 파빌리온을 시도해지침, 권리 공지 및 22.2 MB 다운로드.

Locus에서 무료로 찾으세요오픈 플레이스에서 방을 선택하고 클라우드 팬 파빌리온을 다운로드하세요.

룸 통합 가이드

그 룸 통합 가이드 모델링 워크플로우를 명시하지 않고 USDZ, 엔티티, 좌석, 책상, 안전, 재료, 선택적 조명 및 실험 애니메이션 계약을 설명합니다. 공유하기 전에 정확한 결과를 가져와 입력하세요.

소스 및 라이선스

이 문서, 샘플 기술 및 검증 도구를 게시하는 것은 개인 Locus 앱 소스나 앱 라이센스를 변경하지 않습니다. Locus이 작성한 예시 자산은 설명된 용어를 사용합니다. 자산권 페이지.