管理音频播放（摘自Android官方培训课程中文版(v0.9.5)）

编写:kesenhoo - 原文:http://developer.android.com/training/managing-audio/index.html

如果我们的应用能够播放音频，那么让用户能够以自己预期的方式控制音频是很重要的。为了保证良好的用户体验，我们应该让应用能够管理当前的音频焦点，因为这样才能确保多个应用不会在同一时刻一起播放音频。

在学习本系列课程中，我们将会创建可以对音量按钮进行响应的应用，该应用会在播放音频的时候请求获取音频焦点，并且在当前音频焦点被系统或其他应用所改变的时候，做出正确的响应。

Lessons

• 控制音量与音频播放(Controlling Your App’s Volume and Playback)

  学习如何确保用户能通过硬件或软件音量控制器调节应用的音量（通常这些控制器上还具有播放、停止、暂停、跳过以及回放等功能按键）。

• 管理音频焦点(Managing Audio Focus)

  由于可能会有多个应用具有播放音频的功能，考虑他们如何交互非常重要。为了防止多个音乐应用同时播放音频，Android使用音频焦点（Audio Focus）来控制音频的播放。在这节课中可以学习如何请求音频焦点，监听音频焦点的丢失，以及在这种情况发生时应该如何做出响应。

• 兼容音频输出设备(Dealing with Audio Output Hardware)

  音频有多种输出设备，在这节课中可以学习如何找出播放音频的设备，以及处理播放时耳机被拔出的情况。

  控制音量与音频播放

  编写:kesenhoo - 原文:http://developer.android.com/training/managing-audio/volume-playback.html

  良好的用户体验应该是可预期且可控的。如果我们的应用可以播放音频，那么显然我们需要做到能够通过硬件按钮，软件按钮，蓝牙耳麦等来控制音量。 同样地，我们需要能够对应用的音频流进行播放（Play），停止（Stop），暂停（Pause），跳过（Skip），以及回放（Previous）等动作，并且并确保其正确性。

  鉴别使用的是哪个音频流(Identify Which Audio Stream to Use)

  为了创建一个良好的音频体验，我们首先需要知道应用会使用到哪些音频流。Android为播放音乐，闹铃，通知铃，来电声音，系统声音，打电话声音与拨号声音分别维护了一个独立的音频流。这样做的主要目的是让用户能够单独地控制不同的种类的音频。上述音频种类中，大多数都是被系统限制。例如，除非你的应用需要做替换闹钟的铃声的操作，不然的话你只能通过STREAM_MUSIC来播放你的音频。

  使用硬件音量键来控制应用的音量(Use Hardware Volume Keys to Control Your App’s Audio Volume)

  默认情况下，按下音量控制键会调节当前被激活的音频流，如果我们的应用当前没有播放任何声音，那么按下音量键会调节响铃的音量。对于游戏或者音乐播放器而言，即使是在歌曲之间无声音的状态，或是当前游戏处于无声的状态，用户按下音量键的操作通常都意味着他们希望调节游戏或者音乐的音量。你可能希望通过监听音量键被按下的事件，来调节音频流的音量。其实我们不必这样做。Android提供了setVolumeControlStream()方法来直接控制指定的音频流。在鉴别出应用会使用哪个音频流之后，我们需要在应用生命周期的早期阶段调用该方法，因为该方法只需要在Activity整个生命周期中调用一次，通常，我们可以在负责控制多媒体的Activity或者Fragment的onCreate()方法中调用它。这样能确保不管应用当前是否可见，音频控制的功能都能符合用户的预期。

  setVolumeControlStream(AudioManager.STREAM_MUSIC);
  

  自此之后，不管目标Activity或Fragment是否可见，按下设备的音量键都能够影响我们指定的音频流（在这个例子中，音频流是"music"）。

  使用硬件的播放控制按键来控制应用的音频播放(Use Hardware Playback Control Keys to Control Your App’s Audio Playback)

  许多线控或者无线耳机都会有许多媒体播放控制按钮，例如：播放，停止，暂停，跳过，以及回放等。无论用户按下设备上任意一个控制按钮，系统都会广播一个带有ACTION_MEDIA_BUTTON的Intent。为了正确地响应这些操作，需要在Manifest文件中注册一个针对于该Action的BroadcastReceiver，如下所示：

  <receiver android:name=".RemoteControlReceiver">
      <intent-filter>
          <action android:name="android.intent.action.MEDIA_BUTTON" />
      </intent-filter>
  </receiver>
  

  在Receiver的实现中，需要判断这个广播来自于哪一个按钮，Intent通过EXTRA_KEY_EVENT这一Key包含了该信息，另外，KeyEvent类包含了一系列诸如KEYCODE_MEDIA_*的静态变量来表示不同的媒体按钮，例如KEYCODE_MEDIA_PLAY_PAUSE 与 KEYCODE_MEDIA_NEXT。

  public class RemoteControlReceiver extends BroadcastReceiver {
      @Override
      public void onReceive(Context context, Intent intent) {
          if (Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
              KeyEvent event = (KeyEvent)intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
              if (KeyEvent.KEYCODE_MEDIA_PLAY == event.getKeyCode()) {
                  // Handle key press.
              }
          }
      }
  }
  

  因为可能会有多个程序在监听与媒体按钮相关的事件，所以我们必须在代码中控制应用接收相关事件的时机。下面的例子显示了如何使用AudioManager来为我们的应用注册监听与取消监听媒体按钮事件，当Receiver被注册上时，它将是唯一一个能够响应媒体按钮广播的Receiver。

  AudioManager am = mContext.getSystemService(Context.AUDIO_SERVICE);
  ...
  
  // Start listening for button presses
  am.registerMediaButtonEventReceiver(RemoteControlReceiver);
  ...
  
  // Stop listening for button presses
  am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);
  

  通常，应用需要在他们失去焦点或者不可见的时候（比如在onStop()方法里面）取消注册监听。但是对于媒体播放应用来说并没有那么简单，实际上，在应用不可见（不能通过可见的UI控件进行控制）的时候，仍然能够响应媒体播放按钮事件是极其重要的。为了实现这一点，有一个更好的方法，我们可以在程序获取与失去音频焦点的时候注册与取消对音频按钮事件的监听。这个内容会在后面的课程中详细讲解。

  管理音频焦点

  编写:kesenhoo - 原文:http://developer.android.com/training/managing-audio/audio-focus.html

  由于可能会有多个应用可以播放音频，所以我们应当考虑一下他们应该如何交互。为了防止多个音乐播放应用同时播放音频，Android使用音频焦点（Audio Focus）来控制音频的播放——即只有获取到音频焦点的应用才能够播放音频。

  在我们的应用开始播放音频之前，它需要先请求音频焦点，然后再获取到音频焦点。另外，它还需要知道如何监听失去音频焦点的事件并对此做出合适的响应。

  请求获取音频焦点(Request the Audio Focus)

  在我们的应用开始播放音频之前，它需要获取将要使用的音频流的音频焦点。通过使用requestAudioFocus()方法可以获取我们希望得到的音频流焦点。如果请求成功，该方法会返回AUDIOFOCUS_REQUEST_GRANTED。

  另外我们必须指定正在使用的音频流，而且需要确定所请求的音频焦点是短暂的（Transient）还是永久的（Permanent）。

  • 短暂的焦点锁定：当计划播放一个短暂的音频时使用（比如播放导航指示）。
  • 永久的焦点锁定：当计划播放一个较长但时长可预期的音频时使用（比如播放音乐）。

  下面的代码片段是一个在播放音乐时请求永久音频焦点的例子，我们必须在开始播放之前立即请求音频焦点，比如在用户点击播放或者游戏中下一关的背景音乐开始前。

  AudioManager am = mContext.getSystemService(Context.AUDIO_SERVICE);
  ...
  
  // Request audio focus for playback
  int result = am.requestAudioFocus(afChangeListener,
                                   // Use the music stream.
                                   AudioManager.STREAM_MUSIC,
                                   // Request permanent focus.
                                   AudioManager.AUDIOFOCUS_GAIN);
  
  if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
      am.registerMediaButtonEventReceiver(RemoteControlReceiver);
      // Start playback.
  }
  

  一旦结束了播放，需要确保调用了abandonAudioFocus()方法。这样相当于告知系统我们不再需要获取焦点并且注销所关联的AudioManager.OnAudioFocusChangeListener监听器。对于另一种释放短暂音频焦点的情况，这会允许任何被我们打断的应用可以继续播放。

  // Abandon audio focus when playback complete 
  am.abandonAudioFocus(afChangeListener);
  

  当请求短暂音频焦点的时候，我们可以选择是否开启“Ducking”。通常情况下，一个应用在失去音频焦点时会立即关闭它的播放声音。如果我们选择在请求短暂音频焦点的时候开启了Ducking，那意味着其它应用可以继续播放，仅仅是在这一刻降低自己的音量，直到重新获取到音频焦点后恢复正常音量（译注：也就是说，不用理会这个短暂焦点的请求，这并不会打断目前正在播放的音频。比如在播放音乐的时候突然出现一个短暂的短信提示声音，此时仅仅是把歌曲的音量暂时调低，使得用户能够听到短信提示声，在此之后便立马恢复正常播放）。

  // Request audio focus for playback
  int result = am.requestAudioFocus(afChangeListener,
                               // Use the music stream.
                               AudioManager.STREAM_MUSIC,
                               // Request permanent focus.
                               AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK);
  
  if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
      // Start playback.
  }
  

  Ducking对于那些间歇性使用音频焦点的应用来说特别合适，比如语音导航。

  如果有另一个应用像上述那样请求音频焦点，它所请求的永久音频焦点或者短暂音频焦点（支持Ducking或不支持Ducking），都会被你在请求获取音频焦点时所注册的监听器接收到。

  处理失去音频焦点(Handle the Loss of Audio Focus)

  如果应用A请求获取了音频焦点，那么在应用B请求获取音频焦点的时候，A获取到的焦点就会失去。如何响应失去焦点事件，取决于失去焦点的方式。

  在音频焦点的监听器里面，当接受到描述焦点改变的事件时会触发onAudioFocusChange()回调方法。如之前提到的，获取焦点有三种类型，我们同样会有三种失去焦点的类型：永久失去，短暂失去，允许Ducking的短暂失去。

  • 失去短暂焦点：通常在失去短暂焦点的情况下，我们会暂停当前音频的播放或者降低音量，同时需要准备在重新获取到焦点之后恢复播放。

  • 失去永久焦点：假设另外一个应用开始播放音乐，那么我们的应用就应该有效地将自己停止。在实际场景当中，这意味着停止播放，移除媒体按钮监听，允许新的音频播放器可以唯一地监听那些按钮事件，并且放弃自己的音频焦点。此时，如果想要恢复自己的音频播放，我们需要等待某种特定用户行为发生（例如按下了我们应用当中的播放按钮）。

  在下面的代码片段当中，如果焦点的失去是短暂型的，我们将音频播放对象暂停，并在重新获取到焦点后进行恢复。如果是永久型的焦点失去事件，那么我们的媒体按钮监听器会被注销，并且不再监听音频焦点的改变。

  OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {
      public void onAudioFocusChange(int focusChange) {
          if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT
              // Pause playback
          } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
              // Resume playback 
          } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {
              am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);
              am.abandonAudioFocus(afChangeListener);
              // Stop playback
          }
      }
  };
  

  在上面失去短暂焦点的例子中，如果允许Ducking，那么除了暂停当前的播放之外，我们还可以选择使用“Ducking”。

  Duck!

  在使用Ducking时，正常播放的歌曲会降低音量来凸显这个短暂的音频声音，这样既让这个短暂的声音比较突出，又不至于打断正常的声音。

  下面的代码片段让我们的播放器在暂时失去音频焦点时降低音量，并在重新获得音频焦点之后恢复原来音量。

  OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {
      public void onAudioFocusChange(int focusChange) {
          if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {
              // Lower the volume
          } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
              // Raise it back to normal
          }
      }
  };
  

  音频焦点的失去是我们需要响应的最重要的事件广播之一，但除此之外还有很多其他重要的广播需要我们正确地做出响应。系统会广播一系列的Intent来向你告知用户在使用音频过程当中的各种变化。下节课会演示如何监听这些广播并提升用户的整体体验。

  兼容音频输出设备

  编写:kesenhoo - 原文:http://developer.android.com/training/managing-audio/audio-output.html

  当用户想要通过Android设备欣赏音乐的时候，他可以有多种选择，大多数设备拥有内置的扬声器，有线耳机，也有其它很多设备支持蓝牙连接，有些甚至还支持A2DP蓝牙音频传输模型协定。（译注：A2DP全名是Advanced Audio Distribution Profile 蓝牙音频传输模型协定! A2DP是能够采用耳机内的芯片来堆栈数据，达到声音的高清晰度。有A2DP的耳机就是蓝牙立体声耳机。声音能达到44.1kHz，一般的耳机只能达到8kHz。如果手机支持蓝牙，只要装载A2DP协议，就能使用A2DP耳机了。还有消费者看到技术参数提到蓝牙V1.0 V1.1 V1.2 V2.0 - 这些是指蓝牙的技术版本，是指通过蓝牙传输的速度，他们是否支持A2DP具体要看蓝牙产品制造商是否使用这个技术。来自百度百科）

  检测目前正在使用的硬件设备(Check What Hardware is Being Used)

  使用不同的硬件播放声音会影响到应用的行为。可以使用AudioManager来查询当前音频是输出到扬声器，有线耳机还是蓝牙上，如下所示：

  if (isBluetoothA2dpOn()) {
      // Adjust output for Bluetooth.
  } else if (isSpeakerphoneOn()) {
      // Adjust output for Speakerphone.
  } else if (isWiredHeadsetOn()) {
      // Adjust output for headsets
  } else { 
      // If audio plays and noone can hear it, is it still playing?
  }
  

  处理音频输出设备的改变(Handle Changes in the Audio Output Hardware)

  当有线耳机被拔出或者蓝牙设备断开连接的时候，音频流会自动输出到内置的扬声器上。假设播放声音很大，这个时候突然转到扬声器播放会显得非常嘈杂。

  幸运的是，系统会在这种情况下广播带有ACTION_AUDIO_BECOMING_NOISY的Intent。无论何时播放音频，我们都应该注册一个BroadcastReceiver来监听这个Intent。在使用音乐播放器时，用户通常会希望此时能够暂停当前歌曲的播放。而在游戏当中，用户通常会希望可以减低音量。

  private class NoisyAudioStreamReceiver extends BroadcastReceiver {
      @Override
      public void onReceive(Context context, Intent intent) {
          if (AudioManager.ACTION_AUDIO_BECOMING_NOISY.equals(intent.getAction())) {
              // Pause the playback
          }
      }
  }
  
  private IntentFilter intentFilter = new IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
  
  private void startPlayback() {
      registerReceiver(myNoisyAudioStreamReceiver(), intentFilter);
  }
  
  private void stopPlayback() {
      unregisterReceiver(myNoisyAudioStreamReceiver);
  }