가이드 경로를 선택하세요

지원 수입

행동입력출처
뷰 가져오기완전한 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을 받습니다.

가져온 패키지 제거

가져온 항목의 메뉴를 열고 다음을 선택하세요: 가져오기 제거. 가져온 항목을 제거하면 해당 패키지 전체가 제거됩니다. 룸이나 뷰가 여러 개 들어 있으면 확인 창에 모두 표시됩니다.

다른 설치된 패키지가 이 패키지에 의존하는 경우, Locus는 두 패키지를 모두 변경하지 않습니다. 먼저 의존 패키지를 제거하십시오. 그렇지 않으면 Locus는 설치된 패키지 파일과 저장된 패키지 내용을 삭제합니다; 파일 또는 클라우드 저장소의 원래 ZIP 또는 이미지는 변경되지 않습니다. 원래 패키지를 다시 가져오면 안정적인 식별 아래에 생성하거나 업데이트되며, Views 및 Rooms가 현재 가져오기 허용량에 포함됩니다.

뷰와 룸을 따로 관리하려면 별도로 패키징하세요. 통합 Package v2도 지원하지만 가져오기 제거를 선택하면 그 아카이브에 담긴 모든 뷰와 룸이 함께 제거됩니다.

예제 다운로드

무료 Room과 일부 무료 View는 학습용 예제로 다운로드할 수 있으며, 일부는 Blender 소스도 함께 제공됩니다. 갤러리에서 예제 둘러보기.

코딩 에이전트는 place-examples.json 에서 각 다운로드의 URL, 크기, SHA-256, 기능, 라이선스를 읽을 수 있습니다.

룸 학습용 이전 패키지

현재 배포 형식은 Package v2입니다. 이 이전 평면 호환 ZIP은 책상 좌석과 사용자가 제어하는 조명을 살펴볼 수 있는 학습용 예시로 남겨 두었습니다.

완성된 룸 세 개 체험하기(이전 패키지)

이전 호환 형식의 구조와 현재 필드는 다음에서 확인하세요: 형식 참조. 다음을 포함합니다: 라운지 좌석 및 책상 숨기기 및 좌석 그룹.

이전 호환 형식 다운로드: 아티움 로프트, 현관 갤러리, 호라이즌 아틀리에.

이 예시들을 아래에 있는 Locus과 함께 사용하세요. Locus 자산 권리.

실험적인 방 애니메이션을 시도해 보세요

클라우드 팬 파빌리온은 Locus Places에서 다운로드할 수 있는 무료 방으로, 바람에 따라 계속 움직이는 넓은 잎의 식물이 있습니다. 애니메이션 메타데이터, 재생, 빠른 컨트롤 및 모션 설정, 속도 및 재생 간격은 실험적이며 변경될 수 있습니다.

당신의 방을 가져오세요

이미 알고 있는 모델링, 재료 및 조명 워크플로우를 사용하십시오. Locus은 자체 포함된 USDZ와 개방, 좌석, 선택적 테이블톱 매핑 및 벽 또는 지붕 엔티티 참조, 선택적 방문자 제어 조명, 선택적 라운지 좌석 및 숨겨진 책상 그룹(Locus 1.1.5), 선택적 좌석 그룹(Locus 1.2.0), 그리고—실험을 선택할 때—방 애니메이션만 필요합니다.

권장 완전한 Package 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 파일명.

뷰와 룸을 함께 공유하려면 하나의 완전한 패키지에 둘 다 넣으세요. 다음을 추가하세요: experience.json 를 추가하면 조합의 개방부, 방향, 노출, 제목, 지원 모드를 설정할 수 있습니다. 경험은 고정 ID로 뷰와 룸을 참조하며, 없으면 Locus가 기본 조합을 만듭니다. 통합 파일은 다음에서 한 번 가져오세요: 장소 → 가져오기 → 뷰 가져오기 또는 룸 가져오기에서 파일 또는 공개 HTTPS URL로 가져옵니다. 패키지에 담긴 콘텐츠 종류에 맞는 가져오기 항목을 선택하세요. 통합 패키지의 콘텐츠는 함께 설치됩니다. 자세한 내용은 다음을 참고하세요: 완전 패키지 가이드 및 예시 에서 매니페스트와 패키징 명령을 확인하세요.

이 형식은 저자가 작성한 안정적인 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을 패키징하고 검증합니다.

완전한 Package v2 아카이브에는 다음을 사용하세요: 완전한 패키지 가이드 및 해당 pack_locusplace.py / validate_locusplace.py 도구를 사용하세요. 아래 명령은 레거시/단순 플랫 형식에만 적용됩니다. Room 파일 다섯 개 또는 필수 View 파일 네 개를 한 디렉터리에 모으고 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을 가져오고 모든 좌석을 시도하는 것을 대체하지 않습니다.