【Android Developers Training】 45. 控制音频

系统 1783 0

注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。

原文链接: http://developer.android.com/training/managing-audio/audio-focus.html


有很多应用会要播放音频,所以他们之间如何交互是很重要的。为了防止每个音乐播放器应用在同一时间播放,Android使用音频焦点来调整音频的播放。也就是说,只有获得了音频焦点的应用可以播放音频。

在你的应用开始播放音频之前,它应该需求并接收音频焦点。另外,它应该知道如何监听音频焦点丢失的情况,并在发生焦点丢失时能够正确地响应。


一). 需求音频焦点

在你的应用开始播放音频之前,它应该获取要使用音频流的焦点。这需要调用 requestAudioFocus() 方法。如果请求成功,那么会返回 AUDIOFOCUS_REQUEST_GRANTED

你必须指定你正在使用的是什么流,和你期望获得暂时的还是永久的音频焦点。当你只需要短时间的播放音频时(比如当播放一些使用导航时),那么应该请求暂时焦点。当你计划在可预测的未来持续播放音频时(比如播放音乐),那么你应该请求永久焦点。

下面的代码请求音乐音频流的永久焦点。你必须在你开始播放之前就请求音频焦点,比如当用户按下了播放键,或下一级别游戏的背景音乐开始时:

      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.unregisterMediaButtonEventReceiver(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 ”选项)音频焦点,在请求时都会被你注册的监听器所接收。


二). 处理焦点丢失

如果你的应用请求了音频焦点,它遵守这样的规定:如果其他应用请求焦点,它会按照次序丢失焦点。你的应用应该如何响应焦点丢失取决于丢失的方式。

在你请求音频焦点时,注册的音频焦点变更监听器中 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来让你改变用户的音频体验。下一节课将会讲授如何监听它们来提供用户的音频体验。

【Android Developers Training】 45. 控制音频焦点


更多文章、技术交流、商务合作、联系博主

微信扫码或搜索:z360901061

微信扫一扫加我为好友

QQ号联系: 360901061

您的支持是博主写作最大的动力,如果您喜欢我的文章,感觉我的文章对您有帮助,请用微信扫描下面二维码支持博主2元、5元、10元、20元等您想捐的金额吧,狠狠点击下面给点支持吧,站长非常感激您!手机微信长按不能支付解决办法:请将微信支付二维码保存到相册,切换到微信,然后点击微信右上角扫一扫功能,选择支付二维码完成支付。

【本文对您有帮助就好】

您的支持是博主写作最大的动力,如果您喜欢我的文章,感觉我的文章对您有帮助,请用微信扫描上面二维码支持博主2元、5元、10元、自定义金额等您想捐的金额吧,站长会非常 感谢您的哦!!!

发表我的评论
最新评论 总共0条评论