处理音频输出变化

用户希望能够控制音频应用的音量。标准行为包括能够使用音量控件(设备上的按钮或旋钮,或界面中的滑块),以及避免在使用过程中耳机等外围设备断开连接时突然大声播放。

使用音量控制

当用户在游戏或音乐应用中按下音量键时,即使播放器在歌曲之间暂停或当前游戏位置没有音乐,音量也应随之改变。

Android 使用单独的音频流来播放音乐、闹钟、通知、来电铃声、系统声音、通话音量和 DTMF 音。这允许用户独立控制每个流的音量。

默认情况下,按下音量控制会修改活动音频流的音量。如果您的应用当前没有播放任何内容,按下音量键会调整音乐音量(或 Android 9 之前的铃声音量)。

除非您的应用是闹钟,否则您应该使用 AudioAttributes.USAGE_MEDIA 播放音频。

为确保音量控制调整正确的流,您应该调用 setVolumeControlStream(),并传入与您可以从 AudioAttributes.getVolumeControlStream 检索的属性匹配的流类型。

Kotlin

setVolumeControlStream(AudioManager.STREAM_MUSIC)

Java

setVolumeControlStream(AudioManager.STREAM_MUSIC);

在您的应用生命周期中进行此调用,通常是在控制媒体的 activity 或 fragment 的 onResume() 方法中。这会将音量控制连接到 STREAM_MUSIC,只要目标 activity 或 fragment 可见。

以编程方式控制流音量

在极少数情况下,您可以以编程方式设置音频流的音量。例如,当您的应用替换现有 UI 时。不建议这样做,因为 Android AudioManager 会将所有相同类型的音频流混合在一起。这些方法会改变使用该流的所有应用的音量。避免使用它们。

使用固定音量设备

某些设备(如 Chromebook 和 Android Automotive OS 汽车)具有音量控制,但不允许应用使用前面描述的 AudioManager 方法来更改音频流的音量级别。这些设备称为固定音量设备。您可以通过调用 isVolumeFixed() 来判断您的应用是否在固定音量设备上运行。

音频应用应提供平衡其输出音量与可能在同一流上播放的其他应用音量的能力。在固定音量设备上,应用应将其自己的音量控制连接到适当的 setVolume() 方法。

播放器 方法
AudioTrack AudioTrack.setVolume()
MediaPlayer MediaPlayer.setVolume()
ExoPlayer 使用 SimpleExoPlayer.setVolume(),它设置底层 AudioTrack 的音量。
Web 设置 HTMLMediaElementvolume 属性

不要制造噪音

用户可以通过多种方式欣赏其 Android 设备中的音频。大多数设备都有内置扬声器、用于有线耳机的耳机插孔,许多还支持蓝牙连接和 A2DP 音频。

当耳机拔出或蓝牙设备断开连接时,音频流会自动重新路由到内置扬声器。如果您以高音量听音乐,这可能会带来噪音惊喜。

用户通常希望包含屏幕播放控制的音乐播放器应用在这种情况下暂停播放。其他应用,例如不包含控制的游戏,应继续播放。用户可以使用设备的硬件控制来调整音量。

当音频输出切换回内置扬声器时,系统会广播 ACTION_AUDIO_BECOMING_NOISY 意图。您应该创建一个 BroadcastReceiver,在播放音频时监听此意图。您的接收器应如下所示:

Kotlin

private class BecomingNoisyReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action == AudioManager.ACTION_AUDIO_BECOMING_NOISY) {
            // Pause the playback
        }
    }
}

Java

private class BecomingNoisyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
      if (AudioManager.ACTION_AUDIO_BECOMING_NOISY.equals(intent.getAction())) {
          // Pause the playback
      }
    }
}

在开始播放时注册接收器,并在停止播放时注销它。如果您按照本指南中的描述设计您的应用,这些调用应出现在 onPlay()onStop() 媒体会话回调中。

Kotlin

private val intentFilter = IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY)
private val myNoisyAudioStreamReceiver = BecomingNoisyReceiver()

private val callback = object : MediaSessionCompat.Callback() {

    override fun onPlay() {
        registerReceiver(myNoisyAudioStreamReceiver, intentFilter)
    }

    override fun onStop() {
        unregisterReceiver(myNoisyAudioStreamReceiver)
    }
}

Java

private IntentFilter intentFilter = new IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
private BecomingNoisyReceiver myNoisyAudioStreamReceiver = new BecomingNoisyReceiver();

MediaSessionCompat.Callback callback = new
MediaSessionCompat.Callback() {
  @Override
  public void onPlay() {
    registerReceiver(myNoisyAudioStreamReceiver, intentFilter);
  }

  @Override
  public void onStop() {
    unregisterReceiver(myNoisyAudioStreamReceiver);
  }
}