【愚公系列】2022年02月 微信小程序-app.json配置属性之requiredBackgroundModes

举报
愚公搬代码 发表于 2022/02/22 17:30:23 2022/02/22
【摘要】 一、app.json配置属性之requiredBackgroundModes申明需要后台运行的能力,类型为数组。目前支持以下项目:audio: 后台音乐播放location: 后台定位如:{ "pages": ["pages/index/index"], "requiredBackgroundModes": ["audio", "location"]}注:在此处申明了后台运行的接口,开...

一、app.json配置属性之requiredBackgroundModes

申明需要后台运行的能力,类型为数组。目前支持以下项目:

audio: 后台音乐播放
location: 后台定位
如:

{
  "pages": ["pages/index/index"],
  "requiredBackgroundModes": ["audio", "location"]
}

注:在此处申明了后台运行的接口,开发版和体验版上可以直接生效,正式版还需通过审核。

二、audio

1.启用后台播放配置

app.json 配置requiredBackgroundModes音频后台播放,在小程序被手机切换为后台应用的时候,小程序中的音频还可以正常播放。

{
  "pages": ["pages/index/index"],
  "requiredBackgroundModes": ["audio"]
}

2.添加调用代码

注意:getBackgroundAudioManager() 目前只能够播放网络音频链接!不可以播放本地文件、还有工程内的音频文件。测试音频链接,可以去网友的网站,获取音乐平台的音频直链:https://music.liuzhijin.cn/

clkme:function(){
  const backgroundAudioManager = wx.getBackgroundAudioManager()
  backgroundAudioManager.title = '折子戏';
  backgroundAudioManager.epname = '折子戏';
  backgroundAudioManager.singer = '许巍';
  backgroundAudioManager.coverImgUrl = '';
  // 设置了 src 之后会自动播放
  backgroundAudioManager.src = 'http://music.163.com/song/media/outer/url?id=97325.mp3';
  backgroundAudioManager.play();//不要加这个!!!设置了SRC即可播放,不要再行play()
  //播放开始触发onEnded方法
  backgroundAudioManager.onPlay(() => {
        console.log("音乐播放开始");
  })
  //播放结束触发onEnded方法
  backgroundAudioManager.onEnded(() => {
        console.log("音乐播放结束");
  })
  backgroundAudioManager.onError(() => {
      console.log("音乐播放错误");
  })
},

3.注意点

  • getBackgroundAudioManager 一旦设置了src就开始播放了,不要再次调用play()

三、location

1.启用后台定位功能

在app.json中新增:

"requiredBackgroundModes":["location"],
"permission": {
	"scope.userLocationBackground": {
		"desc": "你的位置信息将用于小程序位置接口的效果展示"
	}
},

小程序后台定位的使用相关文档:https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.onLocationChange.html

下面列举详细功能:
1.wx.onLocationChange//监听位置实时变化

2.wx.stopLocationUpdate//关闭监听实时位置变化,前后台都停止消息接收

3.wx.startLocationUpdate//开启小程序进入前台时接收位置消息

4.wx.startLocationUpdataBackground//开启小程序进入前后台时均接收位置消息

首先我们需要开启小程序进入前后台时均接收位置消息

const _locationChangeFn = function(res) {
  console.log('location change', res)
 }
 wx.onLocationChange(_locationChangeFn)
 wx.offLocationChange(_locationChangeFn)

注意这个API无法在开发者工具上调试,只能用真机来进行

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。