讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app怎么禁止手机锁屏后关闭音频

夜萱同学_9018

夜萱同学_9018

发布时间:2026-08-25 10:19:07

|

732人浏览过

|

来源于php中文网

原创

微信小程序锁屏音频需用uni.getBackgroundAudioManager()而非uni.createInnerAudioContext(),并正确配置manifest.json中iOS的UIBackgroundModes和Android的background.mode及Audio模块,且必须真机云打包验证。

uni-app怎么禁止手机锁屏后关闭音频

不能“禁止锁屏”,只能让音频在锁屏后继续播放——这取决于平台能力、原生配置和 API 选型,不是 JS 层面能开关的。

微信小程序必须用 uni.getBackgroundAudioManager()

切后台或锁屏后音频中断,99% 是误用了 uni.createInnerAudioContext()。它在微信里本质是 InnerAudioContext,生命周期绑定页面,一 onHide 就销毁或暂停,iOS 甚至直接释放实例。

  • uni.getBackgroundAudioManager() 是微信原生提供的单例服务,独立于页面,支持锁屏控制、耳机键响应、通知栏操作
  • 必须在用户点击等交互中调用 play(),不能在 onLoad 或 onShow 自动触发(iOS 会静默拒绝)
  • title、singer、epname 至少填两个,否则 iOS 锁屏界面只显示“未知”,控制条不出现
  • coverImgUrl 必须是 HTTPS 地址,建议 ≥ 300×300,Android 微信通知栏才显示清晰缩略图
  • 赋值 src 后必须显式调用 play(),光设 src 不会加载也不播放

App 端必须配 manifest.json + uni.getBackgroundAudioManager()

iOS 和 Android 后台音频不是靠 JS 调用就能开启的,系统需要明确“报备”。漏掉任一配置,锁屏几秒后必停,且无错误提示。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • iOS:在 manifest.json 的 app-plus.distribute.ios.UIBackgroundModes 中填 ["audio"](必须是数组,不能是字符串或空)
  • Android:在 app-plus.background.mode 设为 "audio",同时确保 app-plus.modules.Audio 为 {}
  • 改完必须重新云打包,热更新和本地调试无法生效;真机测试前确认打包日志有 “background audio enabled” 提示
  • uni.createInnerAudioContext() 在 App 端锁屏下也无效——它没声明后台意图,系统默认挂起,iOS 尤其严格

支付宝/字节/快应用等平台根本没后台音频能力

这些平台未提供类似微信 BackgroundAudioManager 的稳定接口。uni.createInnerAudioContext() 切后台必停,且无法通过 manifest 配置、权限声明或事件监听恢复。

  • 别在非微信平台硬套微信方案:uni.getBackgroundAudioManager() 在支付宝里返回 undefined 或空对象,调用 play() 会直接报错
  • 降级策略只能是:切后台时主动 pause(),前台恢复时提示“继续播放”,或直接隐藏控制条
  • 不要尝试在 onHide 里手动 pause() 再 onShow 恢复——用户从锁屏点播放,完全无响应

锁屏控制信息只对原生渲染模式生效

封面、标题、进度条能否在锁屏界面显示,不仅取决于 JS 设置,还受渲染模式限制。

  • 必须使用原生渲染模式(vue.config.js 或 HBuilderX 中关闭“使用 webview 渲染”)
  • coverImgUrl 必须是本地绝对路径(如 /static/cover.jpg),不能是相对路径或未打包资源
  • iOS 上需额外调用 plus.audio.setLockScreenControl(),但必须包裹在 #ifdef APP-PLUS 中,H5 和小程序不支持
  • 循环播放不能只设 loop = true,需监听 onEnded 手动 seek(0) + play(),并加 try/catch 兜底

最易被忽略的点:iOS 锁屏控件不显示,往往不是代码问题,而是 manifest.json 配置位置错了——必须嵌套在 app-plus → distribute 下,iOS 和 Android 配置不能混写,也不能漏掉 Audio 模块启用。真机测试前,务必确认云打包日志里有对应提示。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2123

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4543

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5690

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5138

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

723

2024.05.22

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

20

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

20

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

20

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn