使用 Jetpack XR SDK 進行開發

適用的 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡
音訊和螢幕眼鏡

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

打造全沉浸式體驗

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

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

打造擴增實境和實用體驗

目標是輕巧時尚的音訊眼鏡和螢幕眼鏡。使用 Kotlin 和 Jetpack Compose Glimmer 等 Modern Android Development 工具。使用可將手機應用程式投影到眼鏡的 API。

使用 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 推出 SceneCoreEntity 子空間可組合函式,可讓您放置實體 (例如 3D 模型),相對於 UI。

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

XR 裝置的 Material Design

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

Material Design 提供適用於 XR 的元件和版面配置。如果您要使用自動調整式版面配置建構應用程式,進一步瞭解如何導入 XR 專用的 Material Design。

Jetpack SceneCore

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

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

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

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

適用於 Jetpack XR 的 ARCore

適用的 XR 裝置:XR 頭戴式裝置、有線 XR 眼鏡、音訊眼鏡、螢幕眼鏡

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

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

Jetpack Compose Glimmer

適用的 XR 裝置:顯示眼鏡

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

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

Jetpack Projected

適用的 XR 裝置:音訊眼鏡、螢幕眼鏡

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

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

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