共享音频输入  

音频输入通常来自内置麦克风、外部麦克风或连接到设备的音频接口。音频输入也可以来自电话对话。

有时候，两个或多个应用可能都想“捕获”同一个音频输入。这些应用可能在执行不同的任务。例如，某些接收音频的应用可能像简单的语音记录器一样在“录制”，而其他应用可能像响应语音指令的 Google 助理或无障碍服务一样在“侦听”。

无论属于哪种情况，这些应用都希望接收音频输入。在本页面中，无论应用是录制还是侦听，我们都使用“捕获”一词。

如果两个或多个应用希望同时捕获音频，则将音频信号从同一源传送给所有应用可能存在问题。本页面介绍 Android 系统如何在捕获音频的多个应用之间共享音频输入。

在 Android 10 之前，输入音频流一次只能由一个应用捕获。如果已有应用在录制或侦听音频，则您的应用可以创建一个 AudioRecord 对象，但系统会在您调用 AudioRecord.startRecording() 时返回错误，并且不会开始录制。

该规则的一个例外情况是，特权应用（例如 Google 助理或无障碍服务）拥有 android.permission.CAPTURE_AUDIO_HOTWORD 权限并使用 HOTWORD 类型的音频源。在这种情况下，另一个应用可以开始录音。出现这种情况时，特权应用终止，新应用捕获输入。

Android 9 中还添加了一项更改：只有在前台运行的应用（或前台服务）才能捕获音频输入。当没有前台服务或前台界面组件的应用开始捕获时，应用将继续运行，但会受到静默处理，即便它是当时唯一捕获音频的应用也是如此。

之前的行为是“先到先得”。应用开始捕获音频后，所有其他应用在捕获应用停止之前均无法访问音频输入。

Android 10 (API 级别 29) 或更高版本 采用优先级方案，可以在运行的应用之间切换输入音频流。在大多数情况下，如果新应用获取音频输入，则之前的捕获应用将继续运行，但会受到静默处理。在某些情况下，系统可以继续向这两个应用传送音频。下面将介绍各种共享方案。

此方案类似于音频焦点处理多个应用争夺音频输出使用的方式。不过，音频焦点获取和焦点释放由编程请求管理；此处描述的输入切换方案基于优先级策略，该策略会在新应用开始捕获音频时自动应用。

为了捕获音频，Android 会区分两种类型的应用：

此外，如果应用使用“隐私敏感”音频源（CAMCORDER 或 VOICE_COMMUNICATION），则其会受到区别对待。

使用和共享音频输入的优先级规则如下：

当两个应用试图捕获音频时，它们都可以接收输入信号，或者其中一个可能会受到静默处理。

四种主要方案如下：

Google 助理属于特权应用，因为其预先安装在设备上并且拥有 RoleManager.ROLE_ASSISTANT 角色。拥有此角色的任何其他预安装应用都会受到类似处理。

Android 根据以下规则共享输入音频：

除非另一个使用隐私敏感音频源的应用已在捕获音频，否则 Google 助理可以接收音频（无论在前台还是后台）。

除非 Google 助理在屏幕顶部具有可见的界面组件，否则应用会接收音频。

请注意，这两个应用仅在 Google 助理位于后台且其他应用未从隐私敏感音频源进行捕获时才接收音频。

AccessibilityService 需要严格的声明。

Android 根据以下规则共享输入音频：

如果服务的界面位于顶部，则服务和应用都将接收音频输入。此行为提供使用语音指令控制语音通话或视频捕获等功能。

如果该服务不在顶部，则此情况的处理方式与下述两个普通应用的情况一样。

当两个应用同时进行捕获时，只有一个应用接收音频，另一个应用会受到静默处理。

Android 根据以下规则共享输入音频：

如果 AudioManager.getMode() 返回的音频模式为 MODE_IN_CALL 或 MODE_IN_COMMUNICATION，则语音通话处于活动状态。

Android 根据以下规则共享输入音频：

如果是拥有 CAPTURE_AUDIO_OUTPUT 权限的特权（预安装）应用，则应用可以捕获语音通话。

如要捕获语音通话的上行链路 (TX)、下行链路 (RX) 或这两者，则应用必须指定音频源 MediaRecorder.AudioSource.VOICE_UPLINK 或 MediaRecorder.AudioSource.VOICE_DOWNLINK 和/或设备 AudioDeviceInfo.TYPE_TELEPHONY。

当多个应用同时捕获音频时，只有一个或两个应用处于“活动”状态（正在接收音频），其他应用则处于静音状态（接收静音）。当活动应用发生更改时，音频框架可能会根据以下规则重新配置音频路径：

当优先级较高的应用处于活动状态时，活动应用可能会受到静默处理，因此您可以在 AudioRecord 或 MediaRecorder 对象上注册一个 AudioManager.AudioRecordingCallback，以便在配置发生更改时收到通知。可能的更改如下：

您必须在开始捕获前调用 AudioRecord.registerAudioRecordingCallback()。仅当应用正在接收音频且发生更改时才执行回调。

onRecordingConfigChanged() 方法返回包含当前音频捕获状态的 AudioRecordingConfiguration。使用以下方法了解更改：

通过调用 AudioManager.getActiveRecordingConfigurations()，您可以获得设备上所有活动录音的一般视图。