使用 Jetpack XR SDK 進行開發

適用 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡
AI 眼鏡

Jetpack XR SDK 包含所有工具和程式庫,可供您為 Android XR 裝置打造沉浸式和擴增體驗。

打造全沉浸式體驗

指定 XR 頭戴式裝置和有線 XR 眼鏡等專用高保真裝置。使用 KotlinCompose 等新式 Android 開發工具,以及 Java 和 Views 等舊版工具。您可以空間化 UI載入及算繪 3D 模型,並從語意上瞭解真實世界。

如果您已在 Android 上推出行動裝置或大螢幕應用程式,Jetpack XR SDK 可將應用程式帶入全新境界,方法是將現有版面配置空間化,並透過 3D 模型和沉浸式環境提升體驗。如要瞭解如何將現有的 Android 應用程式空間化,請參閱我們的品質指南

打造強化型實用體驗

目標是推出輕巧時尚的 AI 眼鏡。使用新式 Android 開發工具,例如 KotlinJetpack Compose Glimmer。使用 API,在手機和 AI 眼鏡之間投影應用程式畫面。

使用 Jetpack 程式庫

Jetpack XR SDK 程式庫提供全方位工具包,可打造豐富的沉浸式體驗、輕巧的擴增體驗,以及介於兩者之間的各種體驗。Jetpack XR SDK 包含下列程式庫:

開發人員預覽版期間的 API 開發

Jetpack XR SDK 程式庫是 Android XR 開發人員預覽版的一部分,這些 API 仍在開發中。如要查看已知問題,請參閱程式庫版本資訊:

如果遇到不在清單中的問題,請回報錯誤或提交意見回饋

適用於 XR 的 Jetpack Compose

適用 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡

透過 Jetpack Compose for XR,您可以使用熟悉的 Compose 概念 (例如資料列資料欄),在 XR 中建立空間 UI 版面配置,無論是將現有的 2D 應用程式移植到 XR,還是從頭建立新的 XR 應用程式,都適用這項功能。

這個程式庫提供子空間可組合項,例如空間面板軌道器,可讓您將現有的 2D Compose 或以 Views 為基礎的 UI 放置在空間版面配置中。

如需詳細指引,請參閱「使用 Jetpack Compose 為 XR 開發 UI」。

開發 UI XR 元件軌道器一般範例

Compose for XR 推出 Volume 子空間可組合函式,可讓您相對於 UI 放置 SceneCore 實體,例如 3D 模型。

瞭解如何將現有 Android 應用程式空間化,或查看 API 參考資料以取得更詳細的資訊。

XR 裝置的 Material Design

適用 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡

Material Design 提供適用於 XR 的元件和版面配置。舉例來說,如果您使用自適應版面配置進行建構,並使用 EnableXrComponentOverrides 包裝函式將依附元件更新至最新 Alpha 版,則每個窗格都會放置在 SpatialPanel 中,而導覽軌則會放置在 Orbiter 中。進一步瞭解如何導入 XR 專用的 Material Design

Jetpack SceneCore

適用 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡

使用 Jetpack SceneCore 程式庫,您可以放置及排列 實體定義的 3D 內容,並設定彼此和環境的相對位置。使用 SceneCore,您可以:

Jetpack SceneCore 程式庫也支援空間化使用 Views 建構的應用程式。詳情請參閱檢視畫面使用指南

如需更多詳細資訊,請參閱 API 參考資料

適用於 Jetpack XR 的 ARCore

適用 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡、AI 眼鏡

ARCore for Jetpack XR 程式庫的靈感來自現有的 ARCore 程式庫,可提供將數位內容與現實世界融合的功能。這個程式庫包含動作追蹤、持續性錨點、命中測試,以及使用語意標籤識別平面 (例如地板、牆壁和桌面)。這個程式庫採用 OpenXR 支援的基礎感知堆疊,確保與各種裝置相容,並協助應用程式永不過時。

如需更多詳細資訊,請參閱「使用 ARCore for Jetpack XR」。

Jetpack Compose Glimmer

適用 XR 裝置:AI 眼鏡

Jetpack Compose Glimmer 是一種 UI 工具包,可用於建構擴增 Android XR 體驗,並針對顯示 AI 眼鏡進行最佳化。為全天佩戴的裝置打造美觀、簡潔且舒適的 UI。

  • 易於瀏覽和閱讀:與手機不同,主要畫布是光學透視螢幕,也就是透明的。Jetpack Compose Glimmer 提供眼鏡專屬主題簡化調色盤排版,讓內容容易閱讀、處理速度快,且不會造成干擾。
  • 專為穿戴式裝置互動最佳化:我們已根據使用者操作眼鏡的方式,最佳化互動模型。Jetpack Compose Glimmer 元件具有清楚的焦點狀態,例如經過最佳化的外框,而非會分散注意力的漣漪效果,且可處理常見的實體輸入內容,例如輕觸、在影格上滑動,當然還有語音。
  • 使用熟悉的宣告式 UI 模式:由於 Jetpack Compose Glimmer 完全以 Jetpack Compose 為基礎建構,因此您可以使用在 Android 中建構宣告式 UI 時所學的一切。我們提供全套預先建構的核心可組合函式,例如 TextIconButton,以及 TitleChip 等專用元件,全都針對眼鏡環境進行最佳化。
開發 UI XR 元件軌道器一般範例

Jetpack Projected

適用 XR 裝置:AI 眼鏡

為 AI 眼鏡建構應用程式時,應用程式會在隨附的主機裝置 (例如 Android 手機) 上執行,並投射應用程式的 XR 體驗。如果 Android 主機裝置具備 XR 投影功能,Jetpack Projected 可讓這些裝置與 AI 眼鏡通訊。

  • 存取投影裝置硬體:與投影裝置 (AI 眼鏡) 相關聯的裝置環境。這個預測情境可存取預測的裝置硬體,例如相機。專為在 AI 眼鏡上顯示而建立的專屬活動已可做為投影內容。如果應用程式的其他部分 (例如電話活動或服務) 需要存取 AI 眼鏡硬體,可以取得投影的內容
  • 簡化權限要求:AI 眼鏡採用標準 Android 權限模型,並提供眼鏡專屬權限,應用程式必須在執行階段要求這些權限,才能存取裝置硬體,例如相機。權限輔助工具會簡化手機和 AI 眼鏡介面中的權限要求機制,提供一致的要求體驗。
  • 檢查裝置和螢幕功能:檢查投影裝置是否有螢幕,以及螢幕狀態是否可顯示影像。根據裝置功能調整應用程式。舉例來說,如果裝置沒有螢幕或螢幕處於關閉狀態,你可能需要提供更多音訊背景資訊。
  • 存取應用程式的攝影機動作:應用程式可以存取使用者的攝影機動作,例如在影片串流應用程式中開啟或關閉攝影機。

OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 的商標,已在中國、歐盟、日本和英國註冊為商標。