Android音频焦点

什么是音频焦点?

音频焦点是 API 8 中引入的一个概念。它用于传达这样一个事实:用户一次只能专注于一个音频流,例如收听音乐或播客,但不能同时关注两者。在某些情况下,多个音频流可以同时播放,但只有一个是用户真正会听的(专注于),而另一个在后台播放。一个例子是,在播放音乐时,会播报行车路线,而音乐的音量会降低(又称为闪避)。

官方连接:https://developer.android.google.cn/reference/android/media/AudioFocusRequest?hl=en 在该文档解释了什么是音频焦点,也展示了一个播放有声读物的App如何处理音频焦点。

对于AudioAttributes中的setUsagesetContentType的含义,文档中也有对应说明:https://developer.android.google.cn/reference/android/media/AudioAttributes,在Builder中也有对应的使用示例:https://developer.android.google.cn/reference/android/media/AudioAttributes.Builder

AudioManager.requestAudioFocus()函数的作用:当一个应用程序请求音频焦点时,系统会通知其他正在播放音频的应用程序让出音频焦点。根据请求的类型和当前的音频焦点状态,其他应用程序可能会降低音量、暂停播放或完全停止播放音频。

对于focusGain参数:

  • AudioManager.AUDIOFOCUS_GAIN: 长时间获取焦点。
  • AudioManager.AUDIOFOCUS_GAIN_TRANSIENT: 短时间获取焦点。
  • AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK: 短时间获取焦点,允许其他应用降低音量(ducking)。
  • AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE: 短时间获取独占焦点。

这些参数如何选择,比如我是一个音乐播放器,播放音乐的时间可能很长,所以应用用AUDIOFOCUS_GAIN,这样我一请求音频焦点,别的应用就会收到AUDIOFOCUS_LOSS的通知,它们应该要完全停止播放了。

如果是一个通话app,则应该AUDIOFOCUS_GAIN_TRANSIENT,这样通话应该在请求焦点后,播放器app就会收到AUDIOFOCUS_LOSS_TRANSIENT,此时播放器应该暂停,通话结束后,调用audioManager.abandonAudioFocusRequest(audioFocusRequest)来释放音频焦点,此时播放器app就会收到AUDIOFOCUS_GAIN,此时就可以恢复播放之间暂停的音乐了。

示例代码如下:

kotlin 复制代码
fun log(msg: String) {
    Log.i("AAAA", msg)
}

class MainActivity : AppCompatActivity() {

    private val binding by lazy { ActivityMainBinding.inflate(layoutInflater) }
    private val audioManager by lazy { getSystemService(Context.AUDIO_SERVICE) as AudioManager }

    // 创建音频焦点改变监听器
    private val audioFocusChangedListener = { focusChanged: Int ->
        when (focusChanged) {
            AudioManager.AUDIOFOCUS_GAIN -> log("获得焦点,此时可以恢复播放")
            AudioManager.AUDIOFOCUS_LOSS -> log("永久丢失焦点,如被其他播放器抢占,此时应该停止播放")
            AudioManager.AUDIOFOCUS_LOSS_TRANSIENT -> log("暂时丢失焦点,如来电,此时应该暂停播放")
            AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> log("暂时丢失焦点,但可以 duck,此时可以降低音量")
        }
    }

    // 创建音频属性
    private val audioAttributes: AudioAttributes = AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_VOICE_COMMUNICATION) // USAGE_VOICE_COMMUNICATION: 当用途为语音通信(例如电话或 VoIP)时使用的使用值。
        .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH) // CONTENT_TYPE_SPEECH:当内容类型为语音时使用的内容类型值。
        .build()

    // 创建焦点请求对象
    private val audioFocusRequest: AudioFocusRequest = AudioFocusRequest
        .Builder(AudioManager.AUDIOFOCUS_GAIN_TRANSIENT)
        .setOnAudioFocusChangeListener(audioFocusChangedListener)
        .setAudioAttributes(audioAttributes)
        .build()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(binding.root)
        binding.requestAudioFocus.setOnClickListener { requestAudioFocus() }
        binding.releaseAudioFocus.setOnClickListener { releaseAudioFocus() }
    }

    /** 请求音频焦点 */
    private fun requestAudioFocus() {
        // 请求音频焦点
        when (audioManager.requestAudioFocus(audioFocusRequest)) {
            AudioManager.AUDIOFOCUS_REQUEST_GRANTED -> log("请求焦点成功")
            AudioManager.AUDIOFOCUS_REQUEST_FAILED -> log("请求焦点失败")
            AudioManager.AUDIOFOCUS_REQUEST_DELAYED -> log("请求焦点失败,但一会可能会成功(通过监听器通知结果)")
        }
    }

    /** 释放音频焦点 */
    private fun releaseAudioFocus() {
        audioManager.abandonAudioFocusRequest(audioFocusRequest)
    }

}

注:上面音频焦点API使用的是新出的API,在API 26才出的,也有过时的API可用,但是不推荐。

相关推荐
ta叫我小白1 年前
【Android Audio Focus 音频焦点】
android·audio focus·音频焦点