作者指南
创建自定义的景观或房间。
使用完整 Package v2 交付完整功能和稳定更新，使用旧版／简易平面结构 ZIP 保持兼容，或直接将完整全景图导入为景观。
房间v1-v5 · 查看v1-v2选择一个引导路径
支持的进口
| 行动 | 输入 | 来源 |
|---|---|---|
| 导入景观 | 完整的 2:1 等距柱状投影 JPEG、PNG 或 HEIC 图像；包含景观的完整 Package v2 ZIP；或旧版／简易平面结构的景观 ZIP | 图片可从「照片」导入；图片和 ZIP 可从「文件」或直接公开的 HTTPS URL 导入 |
| 导入房间 | 包含房间的完整 Package v2 ZIP；或旧版／简易平面结构的房间 ZIP | 文件或直接公共HTTPS URL |
Locus 1.2.1 及更高版本支持导入完整 Package v2 包。直接导入的全景图片（包括浏览器中的图片）最低须达到 4K，这一要求与两种 ZIP 格式各自的规则无关。完整包保留稳定 ID 和更新语义；扁平兼容 ZIP 及直接导入的全景图片每次导入都会获得新的 UUID。
尝试三个完整的房间
使用支持房间 v5的Locus版本，下载任何ZIP，将其保存到文件，然后选择 导入房间。这些公共示例包括书桌座位和访客控制的灯光。它们与2026年9月5日发布的导出版本（Atrium Loft 1.0.14、Courtyard Gallery 1.0.16、Horizon Atelier 1.0.18）相匹配。
使用较旧的版本？下载之前的兼容版本： 大厅顶层, 庭院画廊, Horizon工作室.
使用以下例子，在Locus下 Locus资产权利.
尝试实验性房间动画
云扇亭是Locus 空间中可以下载的免费房间，里面有宽叶植物在微风中不断移动。动画元数据、播放、快捷控制和运动设置、速度和重播间隔为实验性，可能会发生变化。
带自己的房间
使用您已经知道的模型、材料和照明工作流程。Locus只需要一个独立的USDZ以及开口、座位、可选的桌面映射和墙壁或屋顶实体参考、可选的访客控制灯、可选的休息椅和隐藏的办公桌组（Locus 1.1.5）、可选的座位组（Locus 1.2.0），以及——当您选择进行实验时——房间动画。
标准完整软件包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根目录下——永远不在外包装文件夹内。内容资产将保留在其匹配的目的地、空间或体验目录下。Locus接受相同的ZIP字节，并带有 .zip 或者 .locusplace 文件名。
此格式保留了作者的稳定ID，查看媒体和遮挡， sourceImage，查看所有者USDZ midground 场景和渲染器拥有的水、景观和房间声音、房间动画、视频表面和座位组、来源以及支持的捆绑式体验。其manifest声明 packageID, contentVersion, minimumAppVersion，内容ID，文件哈希值和大小，以及 contentHash。Locus验证确切的库存、安全路径、哈希值、资源限制、能力和最低应用版本。不完整的完整软件包将被拒绝，而不是作为扁平的ZIP重新尝试。
旧版／简易房间 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，没有音频则会被拒绝。
旧版／简易景观 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
目前的公开 Python 工具只构建和验证旧版／简易平面结构格式，不验证完整 Package v2。将房间的五个文件或景观的四个必需文件放在同一目录中。在 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房间验证器使用Xcode的 usdchecker。有效的结果检查存档和可机器读取的资产；它不替代导入确切的ZIP并尝试每个座位。