只要現有的 2D 行動應用程式不需要任何不支援的功能 (例如電話)，就能自動與 Android XR 頭戴式裝置和有線 XR 眼鏡裝置相容。使用者可以在 Android XR 相容應用程式中完成重要工作流程，但使用者體驗較不理想。理想情況下，您應為 XR 設計差異化體驗，並實作僅適用於 XR 裝置的功能。詳情請參閱開發人員指南，瞭解如何使用 XR 技術將應用程式帶入 3D 世界。
不過，在為應用程式開發空間功能時，您也可以針對目前在 Android XR 裝置上使用應用程式的使用者，最佳化現有的應用程式體驗。如要達成這個目標，請遵循自適應應用程式品質指南，並盡量支援至少第 2 級。開始之前，請先詳閱本指南中的各節，瞭解應著重哪些領域，才能在 Android XR 上為使用者提供優質體驗。
檢查您的應用程式
請檢查應用程式是否屬於下列類別，這些類別通常會影響 Android XR 上的應用程式體驗。針對每個類別，請參閱相關的自動調整式應用程式指南和開發人員指南，打造優質的自動調整式體驗。
螢幕和螢幕方向
Android XR 的許多常見問題，都是因為對裝置螢幕方向和螢幕設定的假設所致。
檢查事項
- 自然方向不符：大多數手機的自然方向 (
Surface.ROTATION_0) 對應直向模式，但許多 XR 裝置的自然方向為橫向。 - 避免硬式編碼螢幕方向：硬式編碼應用程式螢幕方向可能會導致應用程式無法配合不同螢幕和板型規格調整。
- 設定變更：請確認應用程式會處理設定變更。設計應用程式時，請勿假設裝置是手機。
- 版面配置和算繪：XR 頭戴式裝置和有線 XR 眼鏡等 XR 裝置的螢幕解析度可能非常高。請檢查特定視窗界線，而非顯示大小，以免 UI 元素過大或遭到裁剪。請勿將應用程式內容和互動式按鈕放置在視窗邊緣附近，以免遭到裁剪。
指引
- 開發人員指南：
- 自動調整式應用程式指南：
動態調整大小和多視窗模式
XR 頭戴式裝置和有線 XR 眼鏡提供空間環境，可自由調整應用程式視窗大小和位置。
檢查事項
- 支援視窗大小調整：應用程式應在調整大小事件期間和之後，維持使用者進度、捲動位置和文字輸入。此外，請務必根據新的視窗尺寸調整應用程式的 UI。
指引
- 開發人員指南：
- 自動調整式應用程式指南：
攝影機
相機應用程式需要特別考量 XR 頭戴式裝置和有線 XR 眼鏡上的感應器和虛擬前置鏡頭。
檢查事項
- 裝置的自然螢幕方向：XR 裝置通常會以橫向做為自然螢幕方向。系統會計算相機感應器相對於裝置自然方向的旋轉值。也就是說，在 XR 裝置上，當相機感應器旋轉 0 度時，方向通常為橫向；在手機上，方向通常為直向。因此，請勿根據旋轉角度值假設裝置或相機感應器方向。
- 虛擬前置鏡頭：與行動裝置不同，配備前置鏡頭的 XR 裝置會提供使用者的虛擬化身檢視畫面。這個虛擬檢視畫面可能會水平翻轉，因此應用程式不應假設特定方向。
指引
- 開發人員指南：
- 自動調整式應用程式指南：
輸入
應用程式應支援 XR 頭戴式裝置和有線 XR 眼鏡支援的各種輸入方式。
檢查事項
- 觸控目標：使用比其他板型規格更大的觸控目標，提高精確度、舒適度和可用性。
- 鍵盤支援：使用系統虛擬鍵盤和外接鍵盤測試應用程式。
- 支援遊戲手把：在瀏覽應用程式選單和玩遊戲時支援遊戲控制器。
指引
- 開發人員指南：
- 自動調整式應用程式指南：
- Touch_Targets (如需 XR 專屬目標大小，請參閱「Android XR 中的目標」)
- Keyboard_Input
系統生命週期
應用程式應妥善處理系統生命週期事件。
檢查事項
- 調整大小時音訊和影片持續播放：調整視窗大小時，媒體播放應保持同步。
- 取下和戴上裝置時音訊和視訊不中斷：使用者取下或戴上裝置時，媒體播放應從上次停止播放的位置繼續播放。
指引
- 開發人員指南：
- 自動調整式應用程式指南：