Android XR:增强体验的应用质量指南和政策

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
音频和
显示眼镜

智能眼镜的应用质量指南扩展了基础核心应用质量移动标准。

这些应用质量指南和政策重点关注智能眼镜上 Android XR 平台独有的关键多模态互动,如兼容性层级定义、核对清单和仅限音频体验的政策中所述。请查看这些部分,确保您的应用在音频眼镜和显示眼镜上提供出色的用户体验。

增强体验:移动应用兼容性层级定义

请查看以下兼容性层级定义,了解您的应用在眼镜上提供的增强现实体验的支持级别。

兼容

兼容的移动应用可在眼镜上提供增强体验,而无需开发者付出额外努力。这代表一个现有的 Android 移动应用,包括尚未针对眼镜进行修改的蓝牙连接。Android XR 平台会自动支持此类应用,前提是该应用不依赖于不受支持的硬件功能。

为了实现此功能,该平台将标准 Android 系统界面无缝扩展到眼镜上。例如,通知会自动显示在用户的视线范围内或大声朗读(对于无屏眼镜),确保用户无需拿出手机即可完成关键、一目了然的任务。

差异化

差异化增强体验是专为眼镜设计的,充分利用了 Jetpack XR SDK 的全部功能和眼镜的独特硬件。

如需构建这些变革性的增强体验,请使用以下库:

  • Jetpack Compose Glimmer:一个 Compose 界面工具包,用于创建针对光学透视显示屏进行优化的极简且易读的界面。
  • Jetpack Projected:管理资源,并在配套手机(主机)和眼镜(投影设备)之间无缝桥接功能。
  • ARCore for Jetpack XR:使用设备跟踪和 Geospatial API 等高级感知功能,实现步行导航等本地化和情境感知功能。

增强体验:移动应用质量核对清单

为确保您的应用在增强体验中提供出色的用户体验,请查看以下兼容性核对清单和测试。

这些核对清单和测试定义了一套全面的质量要求,适用于大多数类型的 Android 应用。

兼容

兼容的应用是指现有的 Android 移动应用,这些应用利用标准 Android 界面(例如标准通知和实时更新通知)在眼镜上自动运行。此兼容性层级不需要眼镜专用代码。

您的应用必须满足以下核心要求:

  • 通知:确保所有可操作且具有时效性的通知都使用标准 Android NotificationManager API,以便平台可以将其正确转换为音频读出(音频设备)或极简视觉叠加层(显示设备)。
  • 实时动态:如果应用有持续性活动(例如与进度相关的任务),则必须使用标准实时动态通知框架,以便平台能够以一目了然、免触摸的方式显示这些信息。
  • Google Play:应用必须遵守所有适用的 Android 和 Google Play 政策。系统会根据清单声明和功能要求自动确定兼容性。

差异化

差异化应用是专门使用 Jetpack XR SDK(以及 Jetpack Compose Glimmer、Jetpack Projected 和 ARCore for Jetpack XR 等库)构建的,旨在提供具有世界感知能力、高度优化的用户体验,或使用独特的增强功能。请参阅适合您应用的要求。

类别 领域 指南

核心功能

启动眼镜 activity 体验应可直接从移动应用启动和控制,尤其是在初始设置或浏览密集信息时,然后再切换到用户体验功能较少的音频和显示眼镜。
“打开应用”命令 在搭载 Gemini 的眼镜上,应将体验配置为零启动状态,这样当用户发出“打开 [应用]”指令时,应用会绕过传统菜单,立即过渡到可随时执行操作的音频体验,例如纯音频后台模式、实时聆听状态或即时音频提示。
相机启动 您可以通过移动设备上的入口点或活动,或者通过直接在设备上使用相机操作手势来启动相机访问。如果从移动设备界面启动摄像头访问,用户应在摄像头开始传输视频前听到倒计时。
清晰度和一致性(手势) 手势(例如语音、点按或滑动)应以清晰一致的方式实现,并符合用户对常见互动的预期。后续相应部分概述了核心手势政策。

性能和稳定性

电池 遵循 Android 后台任务限制,优化后台进程,并在不主动使用时尽量减少使用高耗能传感器(例如摄像头画面)。
摄像头帧速率和分辨率 应将摄像头画面访问权限配置为针对给定用例使用最高效的配置(最低帧速率和分辨率)。如需详细了解各种应用场景的推荐配置,请参阅开发者指南。
安全 安全 体验应围绕用户发起的动作进行设计,并严格减少对用户周围环境的干扰,尤其是在移动或公共场所。
隐私权和安全 权限 应用必须使用投影请求权限 API 请求眼镜专用权限以访问硬件(例如摄像头或麦克风),并处理重定向到主机设备以征得用户同意。

基本政策

无障碍 考虑具有不同需求的用户,并确保在适当情况下提供替代输入方法(例如,使用语音指令作为触控板手势的后备方案)。
测试 使用 Android XR 模拟器和可组合项预览,在各种用户场景、光照和嘈杂的环境条件下,全面测试所有手势和视觉实现。
Google Play 政策 遵守所有 Google Play 政策,包括后续部分中概述的眼镜专用政策,这些政策有助于保护用户的隐私和身心健康。

音频体验

语音提醒

语音提醒必须简明扼要,仅提供最相关、最实用的信息。无论是否连接到互联网,针对错误情况的语音提醒都应正常运行。

使用应用内代理或 Gemini 时,应明确预期会有后续跟进和更深入的对话。

音频焦点 音频焦点与输入焦点密切相关。应用应根据 Android 指南,酌情请求和放弃音频焦点。
音频政策 手势和 LED 行为应符合纯音频体验的所有政策。

纯音频体验政策

所有应用都必须遵守以下政策中的要求,以便在智能眼镜上提供安全且令人愉悦的纯音频体验。

应用安全

谨此提醒,通过 Google Play 分发的所有应用都必须遵守所有 Google Play 开发者政策。

我们严格禁止以下活动,应用不得协助或宣传这些活动:

  • 人肉搜索
  • 人脸识别或生物识别
  • 监视
  • 创建或传播未经当事人同意的私密图像 (NCII)

所有应用都必须提供以下旁观者保护措施:

相机安全

访问穿戴式设备摄像头传感器的应用必须尊重旁观者的隐私,并必须遵守以下规定:

视频和照片限制

允许的互动

说明

视频通话

允许应用出于视频通话目的使用穿戴式设备摄像头传感器。

场景理解和环境感知

允许应用使用穿戴式设备摄像头传感器进行环境摄像头感应或场景理解。

禁止的互动

说明

视频社交直播和公开直播

应用不得将穿戴式设备摄像头传感器用于视频社交直播,包括任何实时、一对多直播、公共广播或投放到公共信息流和开放频道。

实时人脸识别和人肉搜索

应用不得使用摄像头传感器进行人脸识别,以获取旁观者的个人身份信息 (PII)。例如:姓名、住址、电话号码或雇主。

未经当事人同意的私密图像 (NCII) 或非法内容生成

应用不得使用摄像头传感器来协助创建未经当事人同意的私密图像 (NCII) 或任何非法内容(例如 CSAM)。

音频安全

使用麦克风阵列的应用应尊重旁观者的隐私,并且必须遵守以下规定:

禁止的互动

说明

持续窃听

当佩戴者未主动与应用互动来执行用户发起的任务时,应用不得在后台持续录音或转写。

语音识别

应用不得使用麦克风阵列来识别非佩戴者的声音或旁观者。

程序化抑制或修改

应用不得更改或停用系统强制执行的音频降噪器。应用也不得鼓励或引导用户更改或停用音频降噪器。

手势和输入

这些政策概述了在纯音频体验期间在眼镜上实现手势事件的要求。请遵循这些指南,在不同的应用和 Android XR 设备上提供一致且直观的用户体验。如果您的应用具有音频焦点,则无论其前台状态如何,所有输入都应正常运行。

1. 轻按手势

点按手势是指在触控板输入区域快速点按一次。点按是用户在眼镜上执行操作的方式。这可以启动音频播放,例如根据用户的状态提供信息或重复播放最后一条语音消息。如果正在播放音频,点按可能会暂停或停止音频输出。

示例
允许的互动 说明

播放相关提示

向用户提供相关信息,例如:

  • 提示用户权限。
  • 基于用户当前状态的信息。例如,说“您的右侧是金门大桥”。
  • 重复向用户提供的最后一条语音消息。

在音频播放期间点按会停止播放音频。

将麦克风静音或取消静音

允许用户在体验中使用麦克风输入时,通过点按手势将麦克风静音或取消静音。

当麦克风静音或取消静音时,应提供音频反馈。

禁止的互动 说明

不相关的信息或广告

请勿使用点按手势投放广告或提供与用户当前身体状态或情境无关的信息。

游戏输入和快速连续操作

点按手势专为快速、单次轻触操作而设计。不得将其改用作互动游戏或高频输入任务的连续控制器,以免干扰标准系统控制。

助长犯罪、暴力或自残

点按手势绝不能触发会助长非法或有害行为(例如极端主义侦察、武器制造或自残)的可操作指令。

2. 相机操作手势

相机操作手势是指快速连续按两次相机按钮。访问摄像头的应用必须将此事件视为直接向应用提供传感器数据的摄像头操作。

示例
允许的互动 说明

为应用启用摄像头

启动摄像头视频传输,将其输入到应用中。这包括激活摄像头视频传输以拍摄照片、视频,或允许使用摄像头画面进行环境摄像头处理。

摄像头视频的使用必须符合与摄像头和麦克风捕获相关的所有 Android 政策,以及 Play 开发者政策中心内的用户数据政策。此外,欺凌和骚扰政策禁止应用公开人肉搜索或利用他人。

禁止的互动 说明

自定义输入和重新映射

相机双击手势必须专门用于激活摄像头视频传输,并直接向应用提供传感器数据。您不得将此硬件手势重新映射到非相机功能、自定义快捷方式或替代应用体验。

使用解耦传感器或虚拟传感器

拦截连按两次摄像头手势的应用必须将其视为对视觉传感器数据的真实请求。您不能注册连按两次事件来劫持硬件按钮,同时故意忽略、舍弃或抑制摄像头画面。

未披露或欺骗性使用

如果使用连按两次相机按钮手势来启动相机,您必须在移动应用流程中,在初始权限授予或应用设置期间,明确告知用户相机的具体用途。例如,一些有效的用例可能是直播、拍照或 AI 处理。摄像头视频传输绝不能用于未经用户明确同意的功能。

3. 单指向后滑动手势

单指向后滑动手势是指在触控板输入区域中连续向后移动。即使在纯音频体验期间,系统也会通过调用 onBack() 来支持此手势。您的应用应通过退出当前体验或将用户返回到之前的应用状态来处理此事件。

禁止的互动 说明

劫持 exit 命令

向后滑动的手势必须始终调用 onBack(),以退出体验或让用户返回到之前的应用状态。不得将其映射到自定义操作、新媒体启动或广告。

虚假退出(窃听)

当此手势被调用时,应用必须真正退出或暂停其主要传感器使用。不得模拟退出,同时在后台秘密保持传感器处于活动状态以进行监控。

LED 行为

您的应用不得根据麦克风和摄像头访问权限更改 LED 系统行为。

禁止的互动 说明

程序化抑制或修改

应用不得根据麦克风和摄像头访问权限更改、调暗或停用系统强制执行的外向 LED 和面向用户的 LED 行为。应用也不得鼓励或指示用户更改、调暗或停用 LED 的行为。

绕过防窃听和破坏检测

应用不得绕过或干扰设备的阻碍检测算法,也不得鼓励或引导用户这样做。这些算法旨在通过编程方式,在面向外部的 LED 被物理遮挡或损坏时停止录制。