在 Android XR Engine Hub 中管理和调试设备

适用的 XR 设备

本指南可帮助您为以下类型的 XR 设备打造优质体验。

了解 XR 设备类型 →

扩展现实头戴设备

有线扩展现实眼镜

了解 XR 设备类型 →

Android XR Engine Hub 中的设备管理器信息中心提供了一个集中式界面，让您无需切换到终端即可安装和测试 build、切换运行时感知权限、执行 ADB 命令、过滤实时 logcat 流以及调整设备配置切换开关。

在使用设备管理器工具之前：

1. 使用 USB-C 数据线将 Android XR 设备连接到工作站。
2. 确保您已在设备上启用开发者选项和 USB 调试。
3. 从 Android XR Engine Hub 顶部的下拉菜单中选择您的设备。

旁加载 APK

您可以直接从设备操作卡片将本地 .apk build 安装到已连接的 Android XR 设备上，而无需从命令行运行 adb install：

1. 在 Android XR Engine Hub 的左侧导航边栏中，选择设备管理器。

2. 在设备操作卡片中，点击旁加载 APK。

   

3. 在 Sideload APK 对话框中，在 Select APK File 字段中输入 .apk 文件的路径，或点击文件夹图标（Browse APK File）从工作站中选择 .apk 文件。

4. 根据需要配置可选安装标志：

   • 允许降级：传递 -d 标志，以允许在应用的现有安装版本上安装旧版本代码。
   • 授予所有权限：传递 -g 标志，以便在安装时自动授予应用清单中声明的所有运行时权限。
   注意： 目标 APK 必须使用与设备上之前安装的任何软件包版本相同的证书进行签名，否则安装不会成功。

5. 点击 Install（安装）。该对话框会显示安装进度，并在软件包安装完毕后通知您。

管理功能权限

测试 XR 感知功能通常需要在已授予和已拒绝权限状态之间切换。借助功能权限卡片，您可以实时检查和切换任何已安装软件包的 Android XR 功能组和精细运行时权限：

1. 在设备管理器中，找到功能权限卡片。

   

2. 从目标应用下拉菜单中，选择要管理其权限的安装式应用（或点击刷新图标以重新加载软件包列表）。

3. 查看每个 Android XR 功能组的权限状态标记（已授予、已拒绝或未请求）：

   • 头部追踪
   • 手部追踪
   • 眼动追踪
   • 空间锚点
   • 场景理解
   • 相机
   • 麦克风
   • 面部追踪

4. 使用以下任一控件修改所选应用的权限：

   • 批量操作：点击全部授予或全部撤消，即可一次性授予或撤消所选应用请求的所有权限。
   • 功能切换开关：使用功能行上的切换开关，可授予或撤消该功能组中的所有权限。
   • 精细权限：点击功能行（例如场景理解或眼动追踪）上的展开箭头，即可检查和切换各个 Android 权限字符串，例如 android.permission.SCENE_UNDERSTANDING_COARSE 或 android.permission.SCENE_UNDERSTANDING_FINE。
   • 搜索：在搜索能力或权限…字段中输入能力名称或权限字符串，以过滤列表。

如需详细了解 Android XR 运行时权限，请参阅了解 XR 的权限。

运行 ADB 命令并保存快捷方式

借助 ADB 命令卡片，您可以针对所选设备运行任意 adb 命令，查看格式化的终端输出和退出代码，并将常用命令保存为一键式快捷方式条状标签：

1. 在设备管理器中，找到 ADB 命令卡片。

   

2. 使用预设条状标签或命令输入字段运行命令：

   • 内置预设：点击任意内置快捷方式条状标签，即可立即运行常见诊断：
     • 电池状态：运行 shell dumpsys battery
     • 显示大小：运行 shell wm size
     • 第三方应用：运行 shell pm list packages -3
     • WLAN IP 地址：运行 shell ip addr show wlan0
     • 唤醒屏幕：运行 shell input keyevent 224
   • 自定义命令：在输入字段中输入 ADB 命令（不带前导 adb 二进制文件名称，例如 shell dumpsys package com.example.xrapp），然后点击执行（或按 Enter 键）。

3. 在结果窗格中检查退出代码、执行时长和命令输出。您可以点击输出窗格右上角的复制输出或清除输出。

4. 如需将自定义命令保存为可重复使用的条状标签（最多 10 个快捷方式），请在输入字段中输入命令，点击书签图标（将命令保存为快捷方式），在保存 ADB 命令快捷方式对话框中输入快捷方式名称，然后点击保存。

过滤设备日志并保存快捷方式

设备日志卡片会流式传输来自已连接的 Android XR 设备的实时 logcat 消息：

• 过滤日志：在过滤日志…搜索字段中输入关键字或日志标记（例如 Unity 或 OpenXR），然后按 Enter 键过滤日志消息。
• 保存过滤条件快捷方式：点击搜索栏中的书签图标（保存过滤条件快捷方式），打开保存日志快捷方式对话框，并将当前过滤条件查询保存为搜索栏下方可点击的快捷方式条状标签（最多 10 个快捷方式）。
• 独立窗口：点击设备日志卡片中的弹出图标，即可在单独的可调整大小的桌面窗口中打开日志查看器，以便在多显示器设置中使用。

配置设备设置并捕获媒体

使用设备管理器中的设备配置和设备操作卡片，可在测试期间控制运行时设备行为并捕获媒体：

• 显示 XR 性能数据叠加层：在设备配置卡片中切换此设置，以显示或隐藏实时设备端性能指标叠加层。
• 充电时不锁定屏幕（即使已取下设备）：在设备配置卡片中切换此设置，以便在 Android XR 设备接通电源时保持唤醒状态，即使您在测试运行之间取下头戴式设备也是如此。
• 屏幕投射：点击设备操作卡片中的屏幕投射，即可在低延时窗口化模式中镜像 Android XR 设备显示屏。
• 截取屏幕截图和屏幕录制：在设备操作卡片中，点击截取屏幕截图或屏幕录制（在处于活动状态时会变为正在录制屏幕），以从设备显示屏中截取图片或录制视频，并在工作站上自动打开保存的文件。点击图片或视频，打开本地输出文件夹。