文档开发者中心
我的
|

HarmonyOS 5

别踩音频焦点的坑,来电抢音、视频不会自动暂停怎么根治

很多视频类应用都遇到过这个反馈:正在播放视频,电话打进来,两边声音混在一起,用户体验很差。不少人第一反应是去监听系统来电广播,写逻辑收到来电就暂停视频。但这套方案在鸿蒙多设备、不同系统版本上很容易翻车,广播延迟、权限限制、第三方通话场景覆盖不全。

音频焦点才是系统原生给的标准解法。系统通话、导航、其他媒体 App 抢占音频时,会下发焦点丢失回调,我们在这里暂停播放;通话结束,焦点重新拿到,再根据业务配置决定是否自动续播。它由音频服务统一调度,不用关心到底是什么来源抢占声音。

收起
自动换行
深色代码主题
复制
import { audio } from '@kit.AudioKit'

let audioManager: audio.AudioManager | null = null
let audioFocus: audio.AudioFocus | null = null

// 初始化焦点监听
function initAudioFocus() {
  audioManager = audio.getAudioManager()
  audioFocus = audioManager.createAudioFocus()
  audioFocus.on('audioFocusChange', (info: audio.AudioFocusChangeInfo) => {
    if (info.focusState === audio.AudioFocusState.FOCUS_STATE_LOSS) {
      // 失去焦点,暂停视频
      console.info('音频焦点丢失,暂停播放')
      pausePlayer()
    } else if (info.focusState === audio.AudioFocusState.FOCUS_STATE_GAIN) {
      // 重新拿到焦点,按需恢复
      console.info('重新获取音频焦点')
      // resumePlayer()
    }
  })
}

// 播放前申请焦点
async function requestFocus() {
  if (!audioFocus) return
  const req: audio.AudioFocusRequest = {
    focusType: audio.AudioFocusType.FOCUS_TYPE_MEDIA,
    durationHint: audio.AudioFocusDurationHint.DURATION_HINT_UNKNOWN
  }
  await audioFocus.requestFocus(req)
}

// 页面销毁释放
function releaseFocus() {
  audioFocus?.abandonFocus()
}

落地细节

  1. 不要依赖来电广播作为主逻辑,广播只是辅助兜底;
  2. 区分临时丢失和永久丢失,临时丢失(通话、语音助手)一般暂停,永久丢失可以直接停止;
  3. 播放器实例唯一的项目,焦点状态要全局统一管理,避免多个页面互相抢焦点;
  4. 部分短视频产品不自动恢复播放,防止用户不知情下突然出声,这个可以做成开关交给用户。
点赞
收藏
回复
5
分享
举报
浏览21 发布于3天前广东
全部评论
最多点赞
最新发布
最早发布
感谢分享,学习了
5楼回复于前天07:27 来自四川
感谢分享,学习了
4楼回复于3天前 来自四川

音频焦点比监听来电广播稳多了,我们之前靠广播判断,第三方通话一接就漏。现在失去焦点就暂停、拿回焦点再按业务决定续不续播,混音问题基本没了。记得播放前先申请焦点。

3楼回复于3天前 来自天津
学习了
2楼回复于3天前 来自浙江
学习打卡
1楼回复于3天前 来自内蒙古
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。