在 Android XR 中,3D 模型是具有深度和体积的数字对象,可为应用增添真实感和空间理解能力。用户可以自然地与 3D 模型互动,从而获得变革性的沉浸式体验。
Android XR 支持文件扩展名为 .glTF 或 .glb 的 3D 模型。GL 传输格式 (glTF) 是一种标准 3D 文件格式,可最大限度地减小素材资源大小、快速加载,并且可在多个平台运行。您可以从 Blender、Maya、Spline 等第三方数字内容创作工具导出这些文件格式。
为优化性能,请优先考虑小文件大小。避免使用过多的多边形或高分辨率纹理,以免影响渲染速度。
集成 3D 模型的方法
Android XR 提供了不同的工具,可用于在应用中添加互动式 3D 模型:使用 SceneCore API 或 Scene Viewer。如果您要使用 Compose for XR 进行构建,可以使用 SceneCoreEntity 子空间可组合项将 3D 模型放置在相对于界面的位置。
- SceneCore API。您可以创建自己的互动,包括旋转、移动和缩放。这样一来,用户便可以与 3D 模型互动,同时使用应用的 3D 面板和环境。您还可以在面板和 3D 模型之间创建父级关系。了解 SceneCore API。
- 场景查看器可用于加载和显示 3D 模型,并支持旋转、移动和缩放等互动操作。不过,场景查看器是作为单独的应用运行的。因此,用户在与 3D 模型互动时,将无法看到您应用的面板和环境。了解场景查看器。
SceneCore API
借助 SceneCore API,您可以为 3D 模型开发丰富的互动功能,同时让用户留在应用情境中。由于 SceneCore 可让您在显示 3D 模型的同时继续显示面板和环境,因此您可以在 3D 模型和面板之间建立关联,并使用场景感知功能将内容锚定到用户的物理空间。
借助 SceneCore,您还可以添加:
- 3D 模型的注释
- 播放嵌入在 3D 模型中的动画
- 多个 3D 模型
- 自定义菜单和启动位置
婚恋交友
3D 模型可以与面板或其他 3D 模型建立父级关系,这样子级元素就会跟随父级的移动而移动。
Anchors
用户可以将 3D 模型固定到现实世界中的特定点。您可以选择将锚点添加到一般水平或垂直表面,也可以添加到特定表面(例如地面或墙壁)。
Scene Viewer
借助 Scene Viewer,用户可以查看 3D 模型并与之互动。用户可以打开受支持的 .glTF 3D 模型(例如 .glb 文件),并将对象放置在空间中。您可以在应用中集成 3D 查看器,让用户轻松直观地查看产品、探索教育内容和体验 3D 模型。Scene Viewer 提供内置界面,用于执行基本互动,包括移动、旋转、缩放和锚定。
发布位置
3D 模型会在用户视线下方 1.5 米处以 15 度角启动,位于用户视野的中心。它们以每轴 1.5 米的微型尺寸打开。

互动包括
界面和互动,可让用户使用自然手势移动、旋转、锚定和缩放 3D 模型。
互动菜单
您可以使用其他操作自定义 3D 模型菜单。如果 glTF 文件包含不同的大小(例如建议的大小和实际大小),用户可以使用 1:1 按钮在它们之间快速切换。如需退出 3D 模型视图并返回应用,用户可以点击强制性关闭按钮。
