DCloud_App_Array
DCloud_App_Array
  • 发布:2014-08-03 00:53
  • 更新:2022-08-31 17:30
  • 阅读:49605

iOS后台运行权限配置

分类:HTML5+

此文档不再维护,请参考新文档地址:https://uniapp.dcloud.io/tutorial/app-ios-uibackgroundmodes

应用切换到后台继续音乐播放

iOS平台应用切换到后台会停止运行,通常情况当应用切换到后台时音乐将暂停播放,下次切换到前台继续播放。如果要支持应用切换到后台后继续播放音乐功能需要进行配置后台播放音乐的能力。

可视化配置

打开项目的manifest.json文件,在“(App)常用其它设置”项的“iOS设置”下“后台运行能力”的输入框中填入audio

如果可视化界面中没有此项配置,请参考下面“源码视图配置”。

注意:如果提示“暂不支持数组格式的查看和修改,请在源码视图中查看和修改”,说应用之前通过源码视图配置过,请参考下面源码视图配置

源码视图配置

打开项目的manifest.json文件,选择“源码视图”项

  • 5+ App项目
    在 "plus" -> "distribute" -> "apple" 下添加 "UIBackgroundModes"字段
  • uni-app项目
    在 "app-plus" -> "distribute" -> "ios" 下添加 "UIBackgroundModes"字段

UIBackgroundModes字段值为字符串数组类型,输入audio表示支持后台播放音乐:

        // ...  
        "UIBackgroundModes": ["audio"],  
        // ...

如果需要同时支持后台定位和后台播放音乐,UIBackgroundModes字段值可配置为["audio","location"]

如果您是开发插件,需要配置其他后台权限,请参考这篇 文档

注意事项

真机运行不支持此功能,需要提交到打App云端打包才生效

应用切换到后台播放音乐时,会导致应用持续在后台运行,此时需要避免调用同步5+ API(调用直接返回数据的API),在后台运行时此类API将无法同步返回数据

iOS切换到后台支持获取位置信息功能
iOS更多后台能力可参考苹果官方文档

3 关注 分享
redrum Trust 纸老虎

要回复文章请先登录注册

y***@163.com

y***@163.com

uniapp怎么添加??
2018-08-12 14:43
1***@qq.com

1***@qq.com

试了配置里"UIBackgroundModes":["audio"],我打包一个测试版本安装到苹果手机还是不行,这个播放文件必须是本地文件吗,还是一个线上网址,我的是线上网址,用的是html5的audio标签
2018-06-14 13:52
我的地盘

我的地盘

回复 我的地盘 :
貌似解决了。看下长期有没有问题。
2018-03-04 23:07
我的地盘

我的地盘

请问ios文字转语音怎样在后台也能继续播报? 切换到后台后,语音播报就停止了。manifest里加"UIBackgroundModes":["audio"] 没用
2018-03-04 22:15
newtom

newtom

在后台播放时,如果启动其它app播放音乐,它会受到影响,怎么才能让它不受影响?
2017-10-10 09:18
7***@qq.com

7***@qq.com

为啥我加了这句还是不行呢
2017-06-16 08:54
Bonfiy

Bonfiy

需要用5+audio html5的不行
2017-05-22 10:18
Lqliang

Lqliang

回复 Bonfiy :
按这个,增加一下: "UIBackgroundModes":["audio"], 可以后台播放!
2017-05-17 23:42
Bonfiy

Bonfiy

回复 Lqliang :
解决了吗?
2017-04-22 09:19
Lqliang

Lqliang

App云端打包后,还是不行呀
2017-04-18 15:31