本文主要是介绍Android音频焦点,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
什么是音频焦点?
音频焦点是 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
,此时就可以恢复播放之间暂停的音乐了。
示例代码如下:
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可用,但是不推荐。
这篇关于Android音频焦点的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!