什么是音频焦点?
音频焦点是 API 8 中引入的一个概念。它用于传达这样一个事实:用户一次只能专注于一个音频流,例如收听音乐或播客,但不能同时关注两者。在某些情况下,多个音频流可以同时播放,但只有一个是用户真正会听的(专注于),而另一个在后台播放。一个例子是,在播放音乐时,会播报行车路线,而音乐的音量会降低(又称为闪避)。
官方连接:https://developer.android.google.cn/reference/android/media/AudioFocusRequest?hl=en 在该文档解释了什么是音频焦点,也展示了一个播放有声读物的App如何处理音频焦点。
对于AudioAttributes
中的setUsage
和setContentType
的含义,文档中也有对应说明: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可用,但是不推荐。