Locus 1.2.1及更高版本。 通过景观或房间入口点从文件中或直接通过公共 HTTPS URL 导入完整的 Package 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。

受支持的完整压缩包可保留 View 媒体与遮罩(包括配对的 media.dayNight 贴图), sourceImage,查看所有者USDZ midground 中景(含天空锚点、风摆、纹理流动与流水)、实时计算 shore 海岸碎浪与引擎水体、日夜 sunPath 循环与配对的 panoramaBlend 全景、View 与 Room 音频、Room 动画、视频表面、受光表面、粒子效果、烘焙光照层、座位分组、View 地面轮廓多边形、Room 纹理流动与流水、版权声明及受支持的 Experience。Locus 会校验安全路径、精确文件清单、哈希、资源上限、所需能力与最低 App 版本。包含以下文件的畸形压缩包会被拒绝,而不会回退到扁平兼容导入器: locusplace.json 被拒绝,并且永远不会回到平坦兼容的进口商。

房间电视需要 Locus 1.4.9 或更高版本:一个房间可以把模型中最多四个平面屏幕变成电视。 阅读电视教程 或 阅读 Room 电视规则。

一份纯数据合同。 在同一个 Locus 应用版本中,受支持的房间和景观数据具有相同的渲染含义,无论它是内置内容、从资源库下载,还是从完整的公开 ZIP 安装。包可以包含特定类型的媒体和 USD/USDZ 资产,但绝不能包含脚本、插件、动态库或可执行扩展。未来的内容能力会加入这一共同契约,而非使用单独的公开导入白名单。 阅读边界和延伸规则。

参考与工具

旧版/简易房间文件

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       # optional

view.json 可以设置方向、可见亮度、房间照明强度、地平线高度、对比度、饱和度以及可选的阳光。全景是一张完整的2:1等角矩形图像。

历史扁平 Room 示例

这些扁平兼容 ZIP 是历史学习示例,并不代表当前功能范围。请使用 Package v2,以及 字段参考 来制作新内容。

展开历史下载与兼容性说明

更早的兼容版本下载: 大厅顶层, 庭院画廊, Horizon工作室.

实验室动画样品

Cloud Fan Pavilion 是可以在 Locus 空间 下载的免费房间,展示实验动画元数据和播放。其连续的 Plant Breeze、动画切换、速度控制和重播间隔行为可能会发生变化。

房间集成指南

那个 房间集成指南 解释USDZ、实体、座位、桌子、安全、材料、可选照明和实验动画合同,但不规定建模工作流程。在分享之前导入并输入精确结果。

来源和许可

发布这些文档、示例技能和验证工具不会发布私有的 Locus 应用源代码,也不会更改应用的许可证。由 Locus 编写的示例资产使用所描述的条款。 资产权利页面.