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

uni-app使用backgroundAudio实现锁屏控制

风瑶姑娘_8596

风瑶姑娘_8596

发布时间:2026-08-08 10:17:26

|

871人浏览过

|

来源于php中文网

原创

uni.getBackgroundAudioManager()是微信小程序锁屏音频控制唯一有效API,需填title/singer/coverImgUrl三字段且coverImgUrl必须HTTPS,播放须用户手势触发,App端需manifest.json正确配置后台音频权限。

uni-app使用backgroundaudio实现锁屏控制

uni.getBackgroundAudioManager() 是锁屏控制的唯一入口

微信小程序里,uni.createInnerAudioContext() 切后台就停,iOS 上甚至实例直接销毁;只有 uni.getBackgroundAudioManager() 是微信原生提供的独立音频服务,它不依赖页面生命周期,能响应锁屏、耳机键、通知栏操作。其他平台(支付宝、字节、快应用)压根没这个 API,调用返回 undefined 或空对象,别硬套。

title/singer/coverImgUrl 缺一不可,否则锁屏界面不显示

iOS 微信锁屏界面只认 titlesingerepname 这三个字段,至少填两个,否则显示“未知”;coverImgUrl 必须是 HTTPS 地址,尺寸 ≥ 300×300,Android 微信通知栏才显示清晰缩略图。常见错误是只设了 titlesrc,结果锁屏一片空白。

uni-app
uni-app

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

下载
  • titlesinger 是强制项,漏掉任一,iOS 直接不渲染控件
  • coverImgUrl 填了但用 HTTP 协议,iOS 会拒绝加载封面
  • 本地路径如 /static/cover.jpg 在小程序里无效,必须走 HTTPS CDN

播放必须由用户手势触发,且不能在 onLoad 里自动调用

赋值 src 后不会自动加载,必须显式调用 manager.play();而这个调用必须发生在用户点击、tap 等交互之后,否则 iOS 直接静音或拒绝播放。很多项目卡在“点了没反应”,其实是把 play() 放在了 onLoadonShow 里,系统直接拦截。

  • 正确做法:绑定 button 的 @click,里面先设 manager.src,再调 manager.play()
  • 不要在 onHide 里手动 pause()onShow 恢复——用户从锁屏点播放,完全无响应
  • 监听要用 manager.onPlay/manager.onPause,不是页面的 onShow/onHide

App 端配置错一个字段,后台播放就失效

uni.getBackgroundAudioManager() 在 App 端也生效,但必须配对 manifest.json —— iOS 要 UIBackgroundModes: ["audio"],Android 要 background.mode: "audio",且 app-plus.modules.Audio 必须为 {}。改完必须重新云打包,热更新和本地调试不生效。

  • iOS 配置写成 "UIBackgroundModes": "audio"(字符串)或拼错成 "audion",后台播放直接被系统拒
  • Android 的 permissions 字段要带转义 XML 标签:"<uses-permission android:name=\"android.permission.WAKE_LOCK\" />"
  • 真机测试前看打包日志有没有 background audio enabled 提示,没有就是配置没生效
最常被忽略的是平台硬边界:微信有 BackgroundAudioManager,其他小程序没有;App 端靠 manifest 配置,H5 根本不存在“后台”概念。跨端时别指望一套代码通吃。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

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

墨刀AI
墨刀AI Hot

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

Laper
Laper Hot

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

2043

2023.08.11

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

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

4343

2023.10.09

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

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

5450

2024.03.19

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

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

4898

2024.03.22

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

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

683

2024.05.22

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

20

2026.09.20

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

0

2026.09.20

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

180

2026.09.16

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单,涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异,助您快速选择合适工具开启AI视频创作。

100

2026.09.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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