使用 ARCore for Jetpack XR 通过感知功能增强应用体验

适用的 XR 设备

本指南可帮助您为这些类型的 XR 设备打造体验。

了解 XR 设备类型 →

XR 头戴设备

有线 XR 眼镜

AI 眼镜

了解 XR 设备类型 →

Jetpack XR 的 ARCore 通过各种 API 为您的应用带来强大的感知能力，让应用能够了解现实世界。其中一些 API 可帮助您增强 XR 头戴设备和有线 XR 眼镜等设备的沉浸式体验，另一些 API 可帮助您增强 AI 眼镜等设备的增强现实体验，还有一些 API 可帮助您增强所有类型的 Android XR 设备的沉浸式应用体验。

例如，您可以使用 ARCore for Jetpack XR 来检索平面数据、将内容锚定到空间中的固定位置，或使用地理空间姿势将内容锚定到现实世界中的位置。

添加库依赖项

在开始在 XR 应用中使用感知功能之前，请添加必要的依赖项，具体取决于您要通过 AR 增强的应用体验类型。

访问会话

ARCore for Jetpack XR 中的感知功能依赖于 Session，后者使用 Jetpack XR 运行时。

应用应如何访问会话取决于您要通过感知功能增强的应用体验类型：

如果您的应用使用 Jetpack Compose for XR 通过空间界面增强沉浸式体验，请访问 Jetpack Compose for XR 的会话。
在所有其他情况下，您都可以从 Jetpack XR 运行时访问会话，这将在本页的下一部分中介绍。

从 Jetpack XR 运行时访问会话

如需从 Jetpack XR 运行时访问会话，您需要创建会话：

如需创建会话，请将 activity 传递给 create() 方法，如以下示例所示：

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}Session.kt

当会话的 activity 被销毁时，与该会话关联的所有 AR 内容都会被销毁，并且该会话不再有效。

配置会话

某些功能可能默认处于停用状态，必须进行配置才能正常运行。如需配置会话，请使用 configure() 并指定 Session 所需的配置选项。如需详细了解不同 AR 功能所需的配置，请参阅每项 AR 功能的相应页面。