기술 레퍼런스
Locus 패키지 v2, 방 및 보기 ZIP 형식
완전한 Package v2는 기능을 모두 담는 표준 순수 데이터 가져오기 형식입니다. legacy/simple 평면 Room/View 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가 필요합니다.
지원되는 완전한 패키지는 View 미디어 및 마스크(쌍을 이룬 media.dayNight 맵 포함), sourceImage, 소유자 확인 USDZ midground 미드그라운드(하늘 앵커, 바람 흔들림, 텍스처 흐름, 유수 포함), 실시간 계산 shore 해변 파도 및 렌더러 관리 물, 낮/밤 sunPath 주기 및 쌍으로 된 panoramaBlend 파노라마, View 및 Room 사운드, Room 애니메이션, 비디오 서피스, 조명 받는 표면, 파티클 효과, 베이크된 라이트 레이어, 좌석 그룹, View 지면 풋프린트 폴리곤, Room 텍스처 흐름 및 유수, 출처 정보, 지원되는 Experience를 보존합니다. Locus는 안전한 경로, 정확한 파일 목록, 해시, 리소스 한도, 필수 기능, 최소 App 버전을 검증합니다. 다음 파일이 포함된 잘못된 아카이브는 플랫 호환 가져오기로 폴백하지 않고 거부됩니다: locusplace.json 거부되고 평평한 호환성 수입업체로 돌아가지 않습니다.
룸 TV에는 Locus 1.4.9 이상이 필요합니다. 룸은 모델 안의 평평한 화면을 최대 네 개까지 TV로 만들 수 있습니다. TV 튜토리얼 읽기 또는 Room TV 규칙 읽기.
레퍼런스 및 도구
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 # optionalview.json 방향, 가시광도, 방광 강도, 수평 기울기, 대비, 채도 및 선택적 일광을 설정할 수 있습니다. 파노라마는 완전한 2:1 직사각형 이미지입니다.
과거 플랫 Room 예제
이 평면 호환 ZIP은 학습용 이전 예시이며 현재 지원 기능의 목록이 아닙니다. Package v2와 다음을 사용하세요: 필드 레퍼런스 로 새 콘텐츠를 만드세요.
이전 다운로드 및 호환성 메모를 열어보세요.
실험실 방 애니메이션 샘플
클라우드 팬 파빌리온은 Locus Places에서 다운로드할 수 있는 무료 방으로, 실험 애니메이션 메타데이터와 재생을 보여줍니다. 지속적인 플랜트 브리즈, 애니메이션 스위치, 속도 제어 및 재생 간격 동작이 변경될 수 있습니다.
룸 통합 가이드
그 룸 통합 가이드 모델링 워크플로우를 명시하지 않고 USDZ, 엔티티, 좌석, 책상, 안전, 재료, 선택적 조명 및 실험 애니메이션 계약을 설명합니다. 공유하기 전에 정확한 결과를 가져와 입력하세요.
소스 및 라이선스
이 문서, 샘플 기술 및 검증 도구를 게시하는 것은 개인 Locus 앱 소스나 앱 라이센스를 변경하지 않습니다. Locus이 작성한 예시 자산은 설명된 용어를 사용합니다. 자산권 페이지.