Jetpack XR SDK 包含所有工具和程式庫,可供您為 Android XR 裝置打造沉浸式和擴增體驗。
打造全沉浸式體驗
指定 XR 頭戴式裝置和有線 XR 眼鏡等專用高保真裝置。使用 Kotlin 和 Compose 等新式 Android 開發工具,以及 Java 和 Views 等舊版工具。您可以空間化 UI、載入及算繪 3D 模型,並從語意上瞭解真實世界。
如果您已在 Android 上推出行動裝置或大螢幕應用程式,Jetpack XR SDK 可將應用程式帶入全新境界,方法是將現有版面配置空間化,並透過 3D 模型和沉浸式環境提升體驗。如要瞭解如何將現有的 Android 應用程式空間化,請參閱我們的品質指南。
打造強化型實用體驗
目標是推出輕巧時尚的 AI 眼鏡。使用新式 Android 開發工具,例如 Kotlin 和 Jetpack Compose Glimmer。使用 API,在手機和 AI 眼鏡之間投影應用程式畫面。
使用 Jetpack 程式庫
Jetpack XR SDK 程式庫提供全方位工具包,可打造豐富的沉浸式體驗、輕巧的擴增體驗,以及介於兩者之間的各種體驗。Jetpack XR SDK 包含下列程式庫:
- Jetpack Compose for XR:以宣告方式建構空間 UI 版面配置,充分運用 Android XR 的空間功能。
- XR 專用的 Material Design:使用可配合 XR 調整的 Material Design 元件和版面配置建構應用程式。
- Jetpack SceneCore:建構及操控 Android XR 場景圖,並加入 3D 內容。
- 適用於 Jetpack XR 的 ARCore:透過感知功能,將數位內容帶入現實世界。
- Jetpack Compose Glimmer:UI 工具包,用於建構擴增 Android XR 體驗,並針對顯示器 AI 眼鏡進行最佳化。
- Jetpack Projected:這類 API 可讓您將手機上的應用程式投影到 AI 眼鏡,提供投影體驗。
開發人員預覽版期間的 API 開發
Jetpack XR SDK 程式庫是 Android XR 開發人員預覽版的一部分,這些 API 仍在開發中。如要查看已知問題,請參閱程式庫版本資訊:
- 適用於 XR 的 Jetpack Compose 版本資訊
- 適用於 Jetpack XR 的 ARCore 版本資訊
- Jetpack SceneCore 版本資訊
- XR 執行階段版本資訊
- Jetpack Compose Glimmer 版本資訊
- Jetpack 預計發布版本資訊
如果遇到不在清單中的問題,請回報錯誤或提交意見回饋。
適用於 XR 的 Jetpack Compose
適用 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡
透過 Jetpack Compose for XR,您可以使用熟悉的 Compose 概念 (例如資料列和資料欄),在 XR 中建立空間 UI 版面配置,無論是將現有的 2D 應用程式移植到 XR,還是從頭建立新的 XR 應用程式,都適用這項功能。
這個程式庫提供子空間可組合項,例如空間面板和軌道器,可讓您將現有的 2D Compose 或以 Views 為基礎的 UI 放置在空間版面配置中。
如需詳細指引,請參閱「使用 Jetpack Compose 為 XR 開發 UI」。
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 時所學的一切。我們提供全套預先建構的核心可組合函式,例如 Text、Icon、Button,以及 TitleChip 等專用元件,全都針對眼鏡環境進行最佳化。
Jetpack Projected
適用 XR 裝置:AI 眼鏡
為 AI 眼鏡建構應用程式時,應用程式會在隨附的主機裝置 (例如 Android 手機) 上執行,並投射應用程式的 XR 體驗。如果 Android 主機裝置具備 XR 投影功能,Jetpack Projected 可讓這些裝置與 AI 眼鏡通訊。
- 存取投影裝置硬體:與投影裝置 (AI 眼鏡) 相關聯的裝置環境。這個預測情境可存取預測的裝置硬體,例如相機。專為在 AI 眼鏡上顯示而建立的專屬活動已可做為投影內容。如果應用程式的其他部分 (例如電話活動或服務) 需要存取 AI 眼鏡硬體,可以取得投影的內容。
- 簡化權限要求:AI 眼鏡採用標準 Android 權限模型,並提供眼鏡專屬權限,應用程式必須在執行階段要求這些權限,才能存取裝置硬體,例如相機。權限輔助工具會簡化手機和 AI 眼鏡介面中的權限要求機制,提供一致的要求體驗。
- 檢查裝置和螢幕功能:檢查投影裝置是否有螢幕,以及螢幕狀態是否可顯示影像。根據裝置功能調整應用程式。舉例來說,如果裝置沒有螢幕或螢幕處於關閉狀態,你可能需要提供更多音訊背景資訊。
- 存取應用程式的攝影機動作:應用程式可以存取使用者的攝影機動作,例如在影片串流應用程式中開啟或關閉攝影機。
OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 的商標,已在中國、歐盟、日本和英國註冊為商標。