Locus

技术参考

Locus 软件包v2、房间和景观 ZIP 格式

完整 Package v2 是具备完整功能的规范导入格式，只包含数据。为兼容旧内容，仍支持旧版／简易平面结构的房间和景观 ZIP。

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。

支持完整软件包，保留查看媒体和遮罩， sourceImage，查看所有者USDZ midground 场景和渲染器拥有的水（包括随风摇曳的道具和浅水冲浪），景观和房间声音，房间动画，视频表面，照明表面，粒子效果，预处理光层，座位组，来源以及支持的体验。Locus 验证安全路径、精确的文件库存、哈希值、资源限制、所需能力和最低应用程序版本。一个包含不完整的存档 locusplace.json 被拒绝，并且永远不会回到平坦兼容的进口商。

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

参考和兼容性工具

完整和兼容格式参考Package v2 的结构、身份与更新、旧版／简易格式布局、JSON 字段、限制和检查。平坦兼容性验证器检查旧版／简易房间或景观 ZIP；不验证完整 Package v2。平装兼容包装器创建可复现的旧版／简易 ZIP，并进行验证。来源模式创作者、权利、署名、变更和AI披露。

旧版／简易房间文件

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等角矩形图像。

完整的房间示例

所有三个下载均使用 房间 v5，并明确设置了渲染角色和光斑方向。更新于 2026 年 9 月 5 日。

需要 房间 v5 支持。 早期 Locus 1.1.0 构建（1–3）不支持这些 ZIP。自 Locus 1.1.0 构建 4 起支持房间 v5，包括 Locus 1.1.1。请在「设置 → 帮助与关于 → 关于 Locus」中查看构建版本。
不是应用程序中的1.1.5或1.2.0房间。 App Store 内置内容及资源库中针对 Locus 1.1.5 的修订增加了沙发和休闲座位，以及可隐藏的桌面组；Locus 1.2.0 又加入了作者定义的座位组，将相关座位在座位选择器中分组。这些可下载的 ZIP 仍采用9 月 5 日的桌面座位包，方便创作者研究基础的房间 v5 契约；不包含休闲座位、隐藏桌面或座位组。如需了解休闲座位和隐藏桌面，请参阅 格式参考；对于座位组，请参见 座位组参考.
大厅顶层2个办公椅·10.1 MB。庭院画廊3个办公桌座位·10.7 MB。Horizon工作室3个办公椅·12.9 MB。

使用较旧的版本？下载之前的兼容版本： 大厅顶层, 庭院画廊, Horizon工作室.

实验室动画样品

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

尝试云风会堂说明、权利声明和22.2 MB的下载。
在Locus中免费找到它打开“开放空间”，选择“房间”，下载“云风扇会堂”。

房间集成指南

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

来源和许可

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