选择一个引导路径

支持的进口

行动输入来源
导入景观完整的 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。

移除已导入的包

打开已导入内容的菜单,然后选择 移除导入。移除导入项会移除整个包。如果包内有多个房间或景观,确认窗口会列出它们。

如果其他已安装的包依赖此包,Locus 会保留这两个包。请先移除依赖它的包。否则,Locus 会移除已安装的包文件及其保存的内容;“文件”或云端储存中的原始 ZIP 或图片不受影响。重新导入原始包时,会按其固定标识创建或更新内容,其中的景观和房间会计入当前导入额度。

景观和房间需要独立管理时,请分别打包。仍支持同时包含两者的 Package v2 包,但“移除导入”会一起移除该包中的所有景观和房间。

下载示例

免费 Room 和部分免费 View 可作为示例下载学习,其中一些附带 Blender 源文件。 在画廊中浏览示例。

编程智能体可以读取 place-examples.json 获取每个下载的 URL、大小、SHA-256、功能和许可。

房间历史示例包

当前请使用 Package v2 交付。以下早期的扁平兼容 ZIP 保留为学习用历史示例,其中包含书桌座位和可由使用者控制的灯光。

体验三个完整房间(历史示例包)

较早的兼容布局和当前字段请参阅 格式参考,包括 休闲座位与“隐藏书桌” 和 座位分组.

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

使用以下例子,在Locus下 Locus资产权利.

尝试实验性房间动画

云扇亭是Locus 空间中可以下载的免费房间,里面有宽叶植物在微风中不断移动。动画元数据、播放、快捷控制和运动设置、速度和重播间隔为实验性,可能会发生变化。

带自己的房间

使用您已经知道的模型、材料和照明工作流程。Locus只需要一个独立的USDZ以及开口、座位、可选的桌面映射和墙壁或屋顶实体参考、可选的访客控制灯、可选的休息椅和隐藏的办公桌组(Locus 1.1.5)、可选的座位组(Locus 1.2.0),以及——当您选择进行实验时——房间动画。

推荐:完整 Package 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 文件名。

要一起分享景观和房间,请将两者放入一个完整内容包。添加一个 experience.json ,以设置该组合的开口、方向、曝光、标题或支持的模式。体验通过固定 ID 引用景观和房间;如果没有体验,Locus 会自动生成默认组合。通过以下入口一次性导入合并的文件: 空间 → 导入 → 导入景观 或 导入房间,通过“文件”或直接的公共 HTTPS URL 导入。入口必须与包内的内容类型相符;合并包中的内容会一起安装。请参阅 完整内容包指南与示例 ,查看清单文件和打包命令。

此格式保留了作者的稳定ID,查看媒体和遮挡, sourceImage,查看所有者USDZ midground 场景和渲染器拥有的水、景观和房间声音、房间动画、视频表面和座位组、来源以及支持的捆绑式体验。其manifest声明 packageID, contentVersion, minimumAppVersion,内容ID,文件哈希值和大小,以及 contentHash。Locus验证确切的库存、安全路径、哈希值、资源限制、能力和最低应用版本。不完整的完整软件包将被拒绝,而不是作为扁平的ZIP重新尝试。

这个包裹是数据,而不是代码。 在相同的 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

对于完整的 Package v2 归档,请使用 完整包指南 及其 pack_locusplace.py / validate_locusplace.py 工具。下方命令仅适用于旧版简易扁平格式。将五个 Room 文件或四个必填 View 文件放在同一目录。在 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并尝试每个座位。