使用 ARCore for Jetpack XR，透過感知功能提升應用程式體驗

適用 XR 裝置

這份指南可協助您為這類 XR 裝置打造體驗。

瞭解 XR 裝置類型 →

瞭解 XR 裝置類型 →

Jetpack XR 適用的 ARCore 提供多種 API，可讓應用程式瞭解現實世界，具備強大的感知能力。部分 API 可協助您提升 XR 頭戴式裝置和有線 XR 眼鏡等裝置的沉浸式體驗，部分 API 可協助您提升 AI 眼鏡等裝置的擴增體驗，部分 API 則可協助您提升所有類型 Android XR 裝置的應用程式體驗。

舉例來說，您可以使用 Jetpack XR 的 ARCore 擷取平面資料、將內容錨定至空間中的固定位置，或是使用地理空間姿勢將內容錨定至現實世界的位置。

新增程式庫依附元件

開始在 XR 應用程式中使用感知功能前，請先新增必要的依附元件，視您要透過 AR 強化哪種應用程式體驗而定。

存取工作階段

Jetpack XR 適用的 ARCore 感知功能依賴 Session，後者會使用 Jetpack XR Runtime。

應用程式存取工作階段的方式，取決於您要透過感知功能提升哪些類型的應用程式體驗：

• 如果您的應用程式使用 Jetpack Compose for XR，透過空間 UI 提升沉浸式體驗，請存取 Jetpack Compose for XR 的工作階段。
• 在其他情況下，您可以從 Jetpack XR Runtime 存取工作階段，這部分將在本頁的下一節中說明。

從 Jetpack XR 執行階段存取工作階段

如要從 Jetpack XR 執行階段存取工作階段，請建立工作階段：

如要建立工作階段，請將活動傳遞至 create() 方法，如下列範例所示：

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

工作階段的活動遭到刪除時，與該工作階段相關聯的所有 AR 內容都會遭到刪除，且工作階段會失效。

設定工作階段

部分功能可能預設為停用，必須經過設定才能運作。如要設定工作階段，請使用 configure()，並指定 Session 需使用的設定選項。如要進一步瞭解不同 AR 功能的必要設定，請參閱各項 AR 功能的對應頁面。

後續步驟

應用程式有工作階段後，請探索如何運用工作階段，為不同 XR 裝置提升應用程式體驗：

• 使用 ARCore for Jetpack XR 偵測平面
• 使用 ARCore for Jetpack XR 建立錨點
• 使用 ARCore for Jetpack XR 處理手部動作
• 使用 ARCore for Jetpack XR 在應用程式中加入頭部位置
• 使用 Jetpack XR 適用的 ARCore，在應用程式中加入臉部追蹤功能
• 使用 Jetpack XR 適用的 ARCore 在應用程式中擷取深度資訊
• 使用 Jetpack XR 的 ARCore 追蹤裝置姿勢
• 使用 ARCore for Jetpack XR 處理地理空間姿勢