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

uni-app锁屏控制权限申请教程

风芳吖_4931

风芳吖_4931

发布时间:2026-08-10 10:23:07

|

424人浏览过

|

来源于php中文网

原创

锁屏音频需用uni.getBackgroundAudioManager()并配全manifest权限,否则静音;H5不支持;iOS/Android配置不同且必须云打包;缺WAKE_LOCK权限安卓会暂停;用户拒绝后无法重申请。

uni-app锁屏控制权限申请教程

锁屏控制本身不需单独申请权限,但实现锁屏后持续播放音频必须走后台音频通道,而这个通道的启用依赖系统级权限声明与 API 配合——漏掉任一环,锁屏就静音。

uni.getBackgroundAudioManager() 是唯一能触发锁屏控制的 API

别用 uni.createInnerAudioContext() 尝试锁屏播放,它在切后台后会被系统强制静音或中断,iOS 上尤其明显。只有 uni.getBackgroundAudioManager() 能注册系统媒体会话,让锁屏界面显示封面、标题、进度条,并响应物理按键(如耳机单击暂停)。

  • 调用前必须先设置 titlesingercoverImgUrl,否则 iOS 锁屏无信息展示
  • src 必须是有效 URL:本地资源用 /static/xxx.mp3,不能用相对路径或未打包的 ./assets/xxx.mp3
  • H5 端完全不支持该 API,调用无报错也无效果,务必用条件编译隔离:#ifdef APP-PLUS

manifest.json 中 iOS 和 Android 后台权限必须分别配对

iOS 和 Android 对“后台音频”的启用机制完全不同,不能混写、不能省略、不能靠猜。

uni-app
uni-app

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

下载
  • iOS:必须在 app-plus.distribute.ios.UIBackgroundModes 中填 ["audio"](注意是字符串数组,不是 "audio"["playback"]
  • Android:必须在 app-plus.background.mode 中设为 "audio"(不是 "location",也不是空字符串)
  • 两者都依赖 app-plus.modules.Audio{}(即启用音频模块),缺一不可
  • 改完 manifest 后必须重新云打包,热更新和本地调试无法生效

Android WAKE_LOCK 权限不是可选,而是保底刚需

即使用了 uni.getBackgroundAudioManager(),部分安卓机型(华为、小米、OPPO)在锁屏几秒后仍会暂停播放——这不是代码问题,是系统休眠策略导致的。必须显式申请 WAKE_LOCK 权限才能维持 CPU 活跃。

  • manifest.json → app-plus → distribute → android → permissions 中添加:"<uses-permission android:name=\"android.permission.WAKE_LOCK\" />"
  • 注意 XML 标签必须带转义,且结尾斜杠不能省略
  • 若已在 AndroidManifest.xml 手动加过该权限,也要同步删掉,避免冲突
  • 不加此权限时,uni.setKeepScreenOn(true) 可能失效,但音频暂停与屏幕是否常亮无关,这是两个独立问题

用户拒绝后台音频权限后,没有“再次申请”入口

iOS 用户一旦在系统弹窗点「不允许」并勾选「不再询问」,后续所有 uni.getBackgroundAudioManager().play() 调用都不会触发弹窗,也不会报错,只是无声。Android 上虽不会永久封禁,但用户拒绝后,uni.getBackgroundAudioManager() 的状态事件(如 onError)可能不触发,行为不可靠。

  • 无法用 uni.authorize({ scope: 'scope.backgroundAudio' }) —— 这个 scope 在 App 端根本不存在,会静默失败
  • 检测不到明确拒绝状态时,应默认引导用户去设置页:调用 uni.openSetting(),并在弹窗中说明“需开启后台音频权限”
  • 注意:iOS 的设置页无法跳转到具体开关项,只能打开通用设置;Android 可精准跳转,前提是 manifest 已正确声明

最常被忽略的点是:后台音频能力不是 JS 层能“调用即生效”的功能,它是原生层的契约。manifest 配错、没云打包、没设 coverImgUrl、没用对 API——任意一个环节断掉,锁屏就失效,而且往往没有任何错误提示,只表现为“无声”。

热门AI工具

更多
豆包大模型

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

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

Atoms
Atoms Hot

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

音述AI
音述AI Hot

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

WorkBuddy

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

DeepSeek

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

讯飞绘文

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

墨刀AI
墨刀AI Hot

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

相关专题

更多
Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

0

2026.09.21

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

0

2026.09.21

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

0

2026.09.21

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

0

2026.09.21

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视频生成工具。

200

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