技术参考
Locus 软件包v2、房间和景观 ZIP 格式
完整 Package v2 是具备完整功能的规范导入格式,只包含数据。为兼容旧内容,仍支持旧版/简易平面结构的房间和景观 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 被拒绝,并且永远不会回到平坦兼容的进口商。
房间电视需要 Locus 1.4.9 或更高版本:一个房间可以把模型中最多四个平面屏幕变成电视。 阅读电视教程 或 阅读 Room 电视规则。
参考与工具
旧版/简易房间文件
room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg此平坦兼容格式每次导入时都会接收一个新的 UUID。每个文件都必须包含。一个房间必须至少包含一个可用的入口座位。缩略图由作者提供;Locus 在导入时不会捕捉一个。
旧版/简易景观文件
view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg # optionalview.json 可以设置方向、可见亮度、房间照明强度、地平线高度、对比度、饱和度以及可选的阳光。全景是一张完整的2:1等角矩形图像。
历史扁平 Room 示例
这些扁平兼容 ZIP 是历史学习示例,并不代表当前功能范围。请使用 Package v2,以及 字段参考 来制作新内容。
实验室动画样品
Cloud Fan Pavilion 是可以在 Locus 空间 下载的免费房间,展示实验动画元数据和播放。其连续的 Plant Breeze、动画切换、速度控制和重播间隔行为可能会发生变化。
房间集成指南
那个 房间集成指南 解释USDZ、实体、座位、桌子、安全、材料、可选照明和实验动画合同,但不规定建模工作流程。在分享之前导入并输入精确结果。
来源和许可
发布这些文档、示例技能和验证工具不会发布私有的 Locus 应用源代码,也不会更改应用的许可证。由 Locus 编写的示例资产使用所描述的条款。 资产权利页面.