使用 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 等新式 Android 開發工具。使用 API,將應用程式體驗從手機投射到眼鏡。

使用 Jetpack 程式庫

Jetpack XR SDK 程式庫提供全方位的工具包,可用於建構豐富的沉浸式體驗、輕量擴增體驗,以及介於兩者之間的所有體驗。Jetpack XR SDK 包含下列程式庫:

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

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

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

適用於 XR 的 Jetpack Compose

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡

有了 Jetpack Compose for XR,您可以使用列和欄等空間化元件,透過熟悉的宣告式 Compose 模型建構空間 UI 和版面配置。

這個程式庫也提供子空間可組合項,例如空間面板和軌道器,可讓您將現有的 2D Compose 或 View 型 UI 放入空間版面配置。其他子空間可組合項可處理其他類型的空間用途,例如 SceneCoreEntity 可讓您放置實體,例如相對於 UI 的 3D 模型。

開發 UI XR 元件 Orbiter 一般範例

無論是要將現有 Android 應用程式立體化,還是從頭建立新的 XR 應用程式,都可以使用 Jetpack Compose for XR。

詳情請參閱空間 UI 開發人員指南,以及程式庫和 API 參考文件。

XR 專用 Material Design

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡

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

Jetpack SceneCore

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡

Jetpack SceneCore 程式庫可讓您放置及排列 3D 內容 (由實體定義),並根據彼此和環境調整位置。使用 SceneCore,您可以:

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

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

Jetpack XR 適用的 ARCore

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡
音訊和
顯示型眼鏡

ARCore for Jetpack XR 程式庫的靈感來自現有的 ARCore 程式庫,可將數位內容與真實世界融合。這個程式庫包含動作追蹤、永久錨點、點擊測試,以及平面識別與語意標籤 (例如地板、牆壁和桌面)。這個程式庫採用 OpenXR 支援的底層感知堆疊,可確保與多種裝置相容,並協助應用程式與時俱進。

詳情請參閱「使用 ARCore for Jetpack XR」。

Jetpack Compose Glimmer

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
有線 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 元件 Orbiter 一般範例

Jetpack Projected

適用的 XR 裝置
這個程式庫可協助您為這類 XR 裝置打造體驗。
音訊和
顯示型眼鏡

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

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

使用 Android XR 模擬器測試 XR 應用程式體驗

Android XR 模擬器是專為 XR 應用程式開發設計的 Android 模擬器版本。您可以在熟悉的 Android Studio 環境中,測試 XR 應用程式及偵錯。您可以為任何類型的 Android XR 裝置建立虛擬裝置,包括 XR 頭戴式裝置和有線 XR 眼鏡等沉浸式裝置,以及音訊和顯示型眼鏡等智慧型眼鏡。

準備好執行應用程式並偵錯時,請參閱下列指南:


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