codecamp

多音频播放的并发策略

音频打断策略

多音频并发,即多个音频流同时播放。此场景下,如果系统不加管控,会造成多个音频流混音播放,容易让用户感到嘈杂,造成不好的用户体验。为了解决这个问题,系统预设了音频打断策略,对多音频播放的并发进行管控,只有持有音频焦点的音频流才可以正常播放,避免多个音频流无序并发播放的现象出现。

当应用开始播放音频时,系统首先为相应的音频流申请音频焦点,获得焦点的音频流可以播放;若焦点申请被拒绝,则不能播放。在音频流播放的过程中,若被其他音频流打断,则会失去音频焦点。当音频流失去音频焦点时,只能暂停播放。在应用播放音频的过程中,这些动作均由系统自行完成,无需应用主动触发。但为了维持应用和系统的状态一致性,保证良好的用户体验,推荐应用监听音频打断事件,并在收到音频打断事件(InterruptEvent)时做出相应处理。

为满足应用对多音频并发策略的不同需求,音频打断策略预设了两种焦点模式,针对同一应用创建的多个音频流,应用可通过设置焦点模式,选择由应用自主管控或由系统统一管控。

音频打断策略决定了应该对音频流采取何种操作,如暂停播放、继续播放、降低音量播放、恢复音量播放等,这些操作可能由系统或应用来执行。音频打断策略预置了两种打断类型,用于区分音频打断事件(InterruptEvent)的执行者。

焦点模式

音频打断策略预设了两种焦点模式(InterruptMode):

  • 共享焦点模式(SHARE_MODE):由同一应用创建的多个音频流,共享一个音频焦点。这些音频流之间的并发规则由应用自主决定,音频打断策略不会介入。当其他应用创建的音频流与该应用的音频流并发播放时,才会触发音频打断策略的管控。
  • 独立焦点模式(INDEPENDENT_MODE):应用创建的每一个音频流均会独立拥有一个音频焦点,当多个音频流并发播放时,会触发音频打断策略的管控。

应用可以按需选择合适的焦点模式,在创建音频流时,系统默认采用共享焦点模式,应用可主动设置所需的模式。

设置焦点模式的方法:

打断类型

音频打断策略(包括两种焦点模式)决定了应该对各个音频流采取何种操作,如暂停播放、继续播放、降低音量播放、恢复音量播放等。而针对这些操作的执行过程,根据执行者的不同,可以分为两种打断类型(InterruptForceType):

  • 强制打断类型(INTERRUPT_FORCE):由系统进行操作,强制打断音频播放。
  • 共享打断类型(INTERRUPT_SHARE):由应用进行操作,可以选择打断或忽略。

对于音频打断策略的执行,系统默认采用强制打断类型(INTERRUPT_FORCE),应用无法更改。但对于一些策略(如继续播放等),系统无法强制执行,所以这两种打断类型均可能出现。应用可根据音频打断事件(InterruptEvent)的成员变量forceType的值,获取该事件采用的打断类型。

在应用播放音频的过程中,系统自动为音频流执行申请焦点、持有焦点、释放焦点等动作,当发生音频打断事件时,系统强制对音频流执行暂停、停止、降低音量、恢复音量等操作,并向应用发送音频打断事件(InterruptEvent)回调。由于系统会强制改变音频流状态,为了维持应用和系统的状态一致性,保证良好的用户体验,推荐应用监听音频打断事件,并在收到音频打断事件(InterruptEvent)时做出相应处理。

对于一些系统无法强制执行的操作(例如音频流继续播放的场景),会向应用发送包含了共享打断类型的音频打断事件,由应用自行执行相应操作,此时应用可以选择执行或忽略,系统不会干涉。

监听音频打断事件

在应用播放音频时,推荐应用监听音频打断事件,当音频打断事件发生时,系统会根据预设策略,对音频流做出相应的操作,并针对状态发生改变的音频流,向所属的应用发送音频打断事件。

应用收到音频打断事件后,需根据其内容提示,做出相应的处理,避免出现应用状态与预期效果不一致的问题。

监听音频打断事件的方法:

为了带给用户更好的体验,针对不同的音频打断事件内容,应用需要做出相应的处理操作。此处以使用AudioRenderer开发音频播放功能为例,展示推荐应用采取的处理方法,提供伪代码供开发者参考(若使用AVPlayer开发音频播放功能,处理方法类似),具体的代码实现,开发者可结合实际情况编写,处理方法也可自行调整。
  1. let isPlay; // 是否正在播放,实际开发中,对应与音频播放状态相关的模块
  2. let isDucked; //是否降低音量,实际开发中,对应与音频音量相关的模块
  3. let started; // 标识符,记录“开始播放(start)”操作是否成功
  4. async function onAudioInterrupt(){
  5. // 此处以使用AudioRenderer开发音频播放功能举例,变量audioRenderer即为播放时创建的AudioRenderer实例。
  6. audioRenderer.on('audioInterrupt', async(interruptEvent) => {
  7. // 在发生音频打断事件时,audioRenderer收到interruptEvent回调,此处根据其内容做相应处理
  8. // 先读取interruptEvent.forceType的类型,判断系统是否已强制执行相应操作
  9. // 再读取interruptEvent.hintType的类型,做出相应的处理
  10. if (interruptEvent.forceType === audio.InterruptForceType.INTERRUPT_FORCE) {
  11. // 强制打断类型(INTERRUPT_FORCE):音频相关处理已由系统执行,应用需更新自身状态,做相应调整
  12. switch (interruptEvent.hintType) {
  13. case audio.InterruptHint.INTERRUPT_HINT_PAUSE:
  14. // 此分支表示系统已将音频流暂停(临时失去焦点),为保持状态一致,应用需切换至音频暂停状态
  15. // 临时失去焦点:待其他音频流释放音频焦点后,本音频流会收到resume对应的音频打断事件,到时可自行继续播放
  16. isPlay = false; // 此句为简化处理,代表应用切换至音频暂停状态的若干操作
  17. break;
  18. case audio.InterruptHint.INTERRUPT_HINT_STOP:
  19. // 此分支表示系统已将音频流停止(永久失去焦点),为保持状态一致,应用需切换至音频暂停状态
  20. // 永久失去焦点:后续不会再收到任何音频打断事件,若想恢复播放,需要用户主动触发。
  21. isPlay = false; // 此句为简化处理,代表应用切换至音频暂停状态的若干操作
  22. break;
  23. case audio.InterruptHint.INTERRUPT_HINT_DUCK:
  24. // 此分支表示系统已将音频音量降低(默认降到正常音量的20%),为保持状态一致,应用需切换至降低音量播放状态
  25. // 若应用不接受降低音量播放,可在此处选择其他处理方式,如主动暂停等
  26. isDucked = true; // 此句为简化处理,代表应用切换至降低音量播放状态的若干操作
  27. break;
  28. case audio.InterruptHint.INTERRUPT_HINT_UNDUCK:
  29. // 此分支表示系统已将音频音量恢复正常,为保持状态一致,应用需切换至正常音量播放状态
  30. isDucked = false; // 此句为简化处理,代表应用切换至正常音量播放状态的若干操作
  31. break;
  32. default:
  33. break;
  34. }
  35. } else if (interruptEvent.forceType === audio.InterruptForceType.INTERRUPT_SHARE) {
  36. // 共享打断类型(INTERRUPT_SHARE):应用可自主选择执行相关操作或忽略音频打断事件
  37. switch (interruptEvent.hintType) {
  38. case audio.InterruptHint.INTERRUPT_HINT_RESUME:
  39. // 此分支表示临时失去焦点后被暂停的音频流此时可以继续播放,建议应用继续播放,切换至音频播放状态
  40. // 若应用此时不想继续播放,可以忽略此音频打断事件,不进行处理即可
  41. // 继续播放,此处主动执行start(),以标识符变量started记录start()的执行结果
  42. await audioRenderer.start().then(async function () {
  43. started = true; // start()执行成功
  44. }).catch((err) => {
  45. started = false; // start()执行失败
  46. });
  47. // 若start()执行成功,则切换至音频播放状态
  48. if (started) {
  49. isPlay = true; // 此句为简化处理,代表应用切换至音频播放状态的若干操作
  50. } else {
  51. // 音频继续播放执行失败
  52. }
  53. break;
  54. default:
  55. break;
  56. }
  57. }
  58. });
  59. }
使用OpenSL ES开发音频播放功能
播放音量管理
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录
HAR

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }