가이드 경로를 선택하세요

지원 수입

행동입력출처
뷰 가져오기완전한 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)과 일치합니다.

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가 아닙니다. Locus 1.1.5를 위한 App Store 기본 제공 기능과 라이브러리 수정을 통해 소파와 라운지 좌석과 숨겨지는 책상 그룹이 추가되었습니다; Locus 1.2.0에서는 작성된 좌석 그룹이 있는 Seats 선택기에서 관련 좌석 그룹을 추가로 그룹화했습니다. 이러한 다운로드 가능한 ZIP 파일은 이전의 책상-좌석 패키지에 남아 있어 작성자는 라운지 좌석, 숨겨진 책상 또는 좌석 그룹 없이 기본 Room v5 계약을 연구할 수 있습니다. 라운지 좌석 및 숨겨진 책상 작성에 대해서는 다음을 참조하십시오. 형식 참조; 좌석 그룹의 경우, 참조하십시오 좌석 그룹 참조.

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

이 예시들을 아래에 있는 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으로 다시 시도하는 대신 거부됩니다.

패키지는 코드가 아니라 데이터입니다. 동일한 Locus 이진 파일에서 지원되는 Room 및 View 데이터는 라이브러리에서 번들하거나 다운로드하거나 완전한 공개 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.zip

Room 검증기는 Xcode의 usdchecker. 유효한 결과는 아카이브와 기계 읽을 수 있는 자산을 확인합니다; 정확한 ZIP을 가져오고 모든 좌석을 시도하는 것을 대체하지 않습니다.