扩展控件、设置和帮助

使用 Android 模拟器上的扩展控件发送数据、更改设备属性、控制应用等。要打开扩展控件窗口，请点击模拟器面板中的更多 模拟器扩展控件图标。请注意，其中某些扩展控件选项仅在您在 Android Studio 外部的单独窗口中运行模拟器时可用。

您可以使用键盘快捷键执行其中许多任务。如需模拟器中所有快捷键的完整列表，请按 F1（macOS 上为 Command+/）以打开“帮助”窗格。

表 1. 扩展控件详情

功能 说明
显示

模拟器允许您将应用部署到多个显示屏，这些显示屏支持自定义尺寸，可以帮助您测试支持多窗口和多显示屏的应用。虚拟设备运行时，您可以按如下方式添加最多两个额外的显示屏

  1. 点击添加辅助显示屏以添加显示屏。
  2. 在辅助显示屏下的菜单中，执行以下操作之一
    1. 选择一个预设纵横比。
    2. 选择自定义并设置自定义显示屏的高度、宽度和DPI。
  3. （可选）再次点击添加辅助显示屏以添加第三个显示屏。
  4. 点击应用更改以将指定的显示屏添加到正在运行的虚拟设备中。
蜂窝网络

模拟器允许您模拟各种网络条件。您可以估算不同网络协议的网络速度，也可以指定完全，这会以计算机允许的最快速度传输数据。指定网络协议总是比完全慢。您还可以指定语音和数据网络状态，例如漫游。默认值在 AVD 中设置。

选择网络类型

  • GSM：全球移动通信系统
  • HSCSD：高速电路交换数据
  • GPRS：通用分组无线服务
  • EDGE：GSM 增强数据速率
  • UMTS：通用移动通信系统
  • HSPDA：高速下行分组接入
  • LTE：长期演进
  • 完全（默认）：使用您的计算机提供的网络

选择信号强度

  • 无
  • 差
  • 中等（默认）
  • 好
  • 极好

选择语音状态、数据状态或两者

  • 主页（默认）
  • 漫游
  • 搜索中
  • 拒绝（仅限紧急呼叫）
  • 未注册（关闭）
电池

您可以模拟设备的电池属性，以查看您的应用在不同条件下的表现。要选择充电电量，请使用滑块控件。

选择充电器连接值

  • 无
  • 交流充电器

选择电池健康状况值

  • 良好（默认）
  • 故障
  • 电量耗尽
  • 过压
  • 过热
  • 未知

选择电池状态值

  • 未知
  • 充电中（默认）
  • 放电中
  • 未充电
  • 充满
相机 您可以在打开模拟器相机时将图片加载到模拟场景中。有关详细信息，请参阅 ARCore 文档中的向场景添加增强图像。
位置

模拟器允许您模拟“我的位置”信息：模拟设备所处的位置。例如，如果您在 Google 地图中点击“我的位置”我的位置图标，然后发送一个位置，地图上就会显示该位置。

设备的地理位置信息控件分为两个标签页：单点和路线。

单点

在单点标签页中，您可以使用 Google 地图网页视图搜索兴趣点，就像您在手机或浏览器中使用 Google 地图一样。当您在地图中搜索（或点击）一个位置时，可以通过选择地图底部附近的保存点来保存该位置。所有您保存的位置都会列在扩展控件窗口的右侧。

要将模拟器的位置设置为您在地图上选择的位置，请点击扩展控件窗口右下角附近的设置位置按钮。

路线

与单点标签页类似，路线标签页提供了一个 Google 地图网页视图，您可以使用它在两个或更多位置之间创建路线。要创建和保存路线，请执行以下操作

  1. 在地图视图中，使用文本字段搜索路线的第一个目的地。
  2. 从搜索结果中选择该位置。
  3. 选择导航 导航图标 按钮。
  4. 从地图中选择路线的起点。
  5. （可选）点击添加目的地以向路线添加更多停靠点。
  6. 通过点击地图视图中的保存路线来保存您的路线。
  7. 指定路线名称，然后点击保存。

要模拟模拟器遵循您保存的路线，请从已保存路线列表中选择路线，然后点击扩展控件窗口右下角附近的播放路线。要停止模拟，请点击停止路线。

要连续模拟模拟器遵循指定路线，请启用重复播放旁边的开关。要更改模拟器遵循指定路线的速度，请从播放速度菜单中选择一个选项。

导入 GPX 和 KML 数据

要使用 GPS 交换格式 (GPX) 或 Keyhole Markup Language (KML) 文件中的地理数据

  1. 点击加载 GPX/KML。
  2. 在文件对话框中，选择您计算机上的一个文件，然后点击打开。
  3. （可选）选择一个速度。

    4. 速度默认为延迟值（速度 1X）。您可以将其速度提高一倍（速度 2X）、三倍（速度 3X）等。

  4. 点击运行 运行图标。
电话

模拟器允许您模拟来电和短信。

要向模拟器发起呼叫

  1. 在发件人字段中选择或输入电话号码。
  2. 点击呼叫设备。
  3. （可选）点击保持通话以将呼叫置于保持状态。
  4. 要结束呼叫，请点击结束呼叫。

要向模拟器发送短信

  1. 在发件人字段中选择或输入电话号码。
  2. 在短信字段中输入消息。
  3. 点击发送消息。
方向键

如果 AVD 在硬件配置文件中启用了方向键，您可以使用模拟器上的方向键控件。但是，并非所有设备都支持方向键；例如，Android 手表不支持。这些按钮模拟以下操作

Directional Pad Control
麦克风

出于隐私和性能原因，Android 模拟器中的麦克风输入默认处于禁用状态。要启用麦克风输入，请切换虚拟麦克风使用主机音频输入选项。Android 模拟器提供开关和按键事件来模拟各种耳机和麦克风场景

  • 虚拟麦克风使用主机音频输入：启用后，模拟器从主机麦克风接收音频输入。禁用后，模拟器不接收音频输入。请注意，您的主机操作系统（Windows、macOS 或 Linux）可能会在首次启用此选项时提示您授予麦克风访问权限。
  • 虚拟耳机插入：此选项模拟将耳机和麦克风插入 3.5 毫米音频插孔。切换此选项会触发 SW_HEADPHONE_INSERT 和 SW_MICROPHONE_INSERT 输入事件，通知 Android 系统模拟的硬件连接。
  • 虚拟耳机带麦克风：此选项模拟连接的耳机上存在麦克风。切换此选项会触发 KEY_HEADSETHOOK 按键事件。此 Android 按键代码通常用于接听电话、结束电话和控制媒体播放等操作。
  • 语音助手：此选项模拟设备语音助手的激活。切换此选项会触发 KEYCODE_ASSIST 按键事件。此 Android 按键代码用于启动设备的助手应用，例如 Google 助理。
指纹

此控件可以模拟 10 种不同的指纹扫描。您可以使用它来测试应用中的指纹集成。Android 5.1 (API level 22) 及更低版本以及 Wear OS 禁用此功能。

要在虚拟设备上模拟指纹扫描

  1. 准备一个应用以接收指纹。
  2. 选择一个指纹值。
  3. 点击触摸传感器。
虚拟传感器 > 设备姿态

此控件允许您针对设备位置、方向或两者的变化测试您的应用。例如，您可以模拟倾斜和旋转等手势。加速度计不跟踪设备的绝对位置：它只检测何时发生变化。该控件模拟加速度计和磁力计传感器在您移动或旋转真实设备时将如何响应。

您必须在您的 AVD 中启用加速度计传感器才能使用此控件。

该控件报告 x、y 和 z 轴上的 TYPE_ACCELEROMETER 事件。这些值包括重力。例如，如果设备悬浮在外太空，它将经历零加速度（x、y 和 z 均为 0）。当设备在地球上并平放在桌面上时，由于重力，加速度为 0、0 和 9.8。

该控件还报告 TYPE_MAGNETIC_FIELD 事件，该事件以微特斯拉 (μT) 为单位测量 x、y 和 z 轴上的环境磁场。

要围绕 x、y 和 z 轴旋转设备，请选择旋转并执行以下操作之一

  • 调整偏航角、俯仰角和滚转角滑块，并观察上方窗格中的位置。
  • 移动上方窗格中的设备表示，并观察偏航角、俯仰角和滚转角以及由此产生的加速度计值如何变化。

有关偏航角、俯仰角和滚转角如何计算的更多信息，请参阅计算设备的朝向。

要水平 (x) 或垂直 (y) 移动设备，请选择移动并执行以下操作之一

  • 调整X和Y滑块，并观察上方窗格中的位置。
  • 移动上方窗格中的设备表示，并观察X和Y滑块值以及由此产生的加速度计值如何变化。

要将设备定位在 0、90、180 或 270 度

  • 在设备旋转区域，选择一个按钮以更改旋转。

当您调整设备时，结果值字段会相应更改。这些是应用可以访问的值。

有关这些传感器的更多信息，请参阅传感器概览、运动传感器和位置传感器。
虚拟传感器 > 其他传感器

模拟器可以模拟各种位置和环境传感器。它允许您调整以下传感器，以便您可以通过您的应用对其进行测试

  • 环境温度：此环境传感器测量环境空气温度。
  • 磁场：此位置传感器分别测量 X、Y 和 Z 轴上的环境磁场。值以微特斯拉 (μT) 为单位。
  • 接近度：此位置传感器测量与物体的距离；例如，它可以通知手机有脸部靠近它以进行通话。您必须在您的 AVD 中启用接近度传感器才能使用此控件。
  • 光线：此环境传感器测量照度。值以勒克斯 (lux) 为单位。
  • 压力：此环境传感器测量环境空气压力。值以毫巴 (hPa) 为单位。
  • 相对湿度：此环境传感器测量环境相对湿度。

有关这些传感器的更多信息，请参阅传感器概览、位置传感器和环境传感器。
错误报告 如果您在使用模拟器时遇到问题，可以准备并发送错误报告。模拟器会自动收集屏幕截图、日志和其他数据以用于错误报告。
录制和播放 请参阅屏幕录制。
Google Play 当 AVD 系统映像包含 Play 商店应用时，此项会显示 Google Play 服务版本信息。
设置 > 常规
  • 模拟器窗口主题：选择浅色或深色。
  • 将键盘快捷键发送到：默认情况下，某些键盘组合会触发模拟器控制快捷键。如果您正在开发包含键盘快捷键的应用（例如针对带蓝牙键盘的设备的应用），您可以更改此设置，将所有键盘输入发送到虚拟设备，包括在模拟器中作为快捷键的输入。
  • 屏幕截图保存位置：点击文件夹图标以指定保存模拟器屏幕截图的位置。
  • 使用检测到的 ADB 位置：如果您从 Android Studio 运行模拟器，请选择此设置（默认）。如果您从 Android Studio 外部运行模拟器并希望它使用特定的 adb 可执行文件，请取消选择此选项并指定 SDK 工具位置。如果此设置不正确，则屏幕截图捕获和拖放应用安装等功能将无法工作。
  • 何时发送崩溃报告：选择始终、从不或询问。
  • 显示设备周围的窗口框架：默认情况下，带有设备外观文件的模拟器不显示周围的窗口框架。
设置 > 代理

默认情况下，模拟器使用 Android Studio HTTP 代理设置。此屏幕允许您手动定义模拟器的 HTTP 代理配置。有关详细信息，请参阅将模拟器与代理配合使用。
设置 > 高级
  • OpenGL ES 渲染器：选择图形加速类型。（这等同于 -gpu 命令行选项。）
    • 基于主机自动检测：让模拟器根据您的计算机设置选择硬件或软件图形加速。它会检查您的 GPU 驱动程序是否与已知有故障的 GPU 驱动程序列表匹配，如果匹配，模拟器会禁用图形硬件模拟并转而使用 CPU。
    • ANGLE：（仅限 Windows。）使用ANGLE Direct3D在软件中渲染图形。
    • SwiftShader：使用SwiftShader在软件中渲染图形。
    • 桌面原生 OpenGL：使用主机计算机上的 GPU。此选项通常最快。但是，某些驱动程序在渲染 OpenGL 图形时存在问题，因此它可能不是一个可靠的选项。
  • OpenGL ES API 级别：选择模拟器中使用的 OpenGL ES 的最大版本。
    • 自动选择：让模拟器根据主机和访客支持选择 OpenGL ES 版本。
    • 渲染器最大值（最高到 OpenGL ES 3.1）：尝试使用最大版本的 OpenGL ES。
    • 兼容性（OpenGL ES 1.1/2.0）：使用与大多数环境兼容的 OpenGL ES 版本。
帮助 > 键盘快捷键（模拟器独立版）

此窗格提供了模拟器的完整键盘快捷键列表。要在使用模拟器时打开此窗格，请按 F1（macOS 上为 Command+/）。

要使快捷键生效，常规设置窗格中的发送键盘快捷键选项必须设置为模拟器控件（默认）。

当模拟器以嵌入模式与 Android Studio 一起运行时，此菜单选项不可用。如果您在嵌入模式下使用模拟器，可以在 File（macOS 上为 Android Studio）> Settings > Keymap 下的 Running Devices 中找到键盘快捷键。
帮助 > 模拟器帮助（模拟器独立版）

要访问模拟器的在线文档，请点击文档。

要针对模拟器提交错误，请点击发送反馈。有关详细信息，请了解如何报告模拟器错误。

当模拟器以嵌入模式与 Android Studio 一起运行时，此菜单选项不可用。如果您在嵌入模式下使用模拟器，请点击帮助 > 提交错误报告以打开错误模板，然后手动添加Android 模拟器错误的详细信息。
帮助 > 关于

查看模拟器使用的 adb 端口以及 Android 和模拟器版本号。将最新的可用模拟器版本与您的版本进行比较，以确定您是否安装了最新的软件。

模拟器序列号为 emulator-adb_port，您可以将其指定为 adb 命令行选项，例如。