只要现有 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 头戴设备和有线 XR 眼镜上的传感器和虚拟前置摄像头，相机应用需要特别考虑。
检查事项
- 设备自然屏幕方向：XR 设备通常使用横向模式作为其自然屏幕方向。系统会相对于设备的自然屏幕方向来计算相机传感器旋转值。这意味着，在 XR 设备上，当摄像头传感器旋转角度为 0 度时，方向通常为横向；而在手机上，方向通常为纵向。因此，请勿根据旋转角度值来假定设备或相机传感器的方向。
- 虚拟前置摄像头：与手机不同，配备前置摄像头的 XR 设备可提供用户的虚拟化身视图。此虚拟视图可能会水平翻转，因此您的应用不应假定为某个特定方向。
指南
- 开发者指南：
- 自适应应用准则：
输入
应用应支持 XR 头戴设备和有线 XR 眼镜支持的各种输入方法。
检查事项
- 触摸目标：使用比其他设备规格更大的触摸目标，以提高精确度、舒适度和易用性。
- 键盘支持：使用系统虚拟键盘和外接键盘测试应用。
- 游戏手柄支持：在浏览应用菜单和游戏过程中支持游戏控制器。
指南
- 开发者指南：
- 自适应应用准则：
- Touch_Targets（有关特定于 XR 的目标尺寸，请参阅 Android XR 中的目标）
- Keyboard_Input
系统生命周期
应用应妥善处理系统生命周期事件。
检查事项
- 调整大小期间的音频和视频连续性：在调整窗口大小时，媒体播放应保持同步。
- 摘下和戴上设备时的音频和视频连续性：当用户摘下或戴上设备时，媒体播放应从中断处继续播放。
指南
- 开发者指南：
- 自适应应用准则：