微信小程序常用的api（1）

背景音频API

先在app.json中配置"requiredBackgroundModes": [“audio”] 再通过wx.getBackgroundAudioManage绑定方法

注意：开启微信小程序的背景音频播放功能，需要在app.json文件中配置 “requiredBackgroundModes”: [“audio”]

背景音频的属性

1.src 背景音频的数据源，默认为空字符串，当设置了新的src时，会自动开始播放， 目前支持的格式有M4A、AAC、MP3、WAV

2.startTime 背景音频开始播放的时间（单位：秒）

3.title 背景音频标题，用于原生音频播放器的背景音频标题

4.playbackRate 播放速率，范围0.5-2.0倍，默认1倍

5.duration 当前背景音频的长度（单位：秒），只有在合法src时有效（只读）

6.currentTime 当前背景音频的播放时间（单位：秒），只有在合法src时有效（只读）

7.paused 当前是否暂停或停止（只读）

背景音频的方法

使用：getBackgroundAudioManage.方法名

1.play（） 播放音频

2.pause（） 暂停背景音频

3.seek（） 跳转到指定位置

4.stop（） 停止背景音频

5.onCanplay（） 背景音频进入可以播放状态的事件（参数为回调函数）

6.onWaiting（） 监听背景音频加载中事件，当背景音频因为数据不足需要停下来加载时会 触发

7.onError（） 监听背景音频播放错误事件

8.onPlay（） 监听背景音频播放事件

9.onPause（） 监听背景音频暂停事件

10.onSeeking（） 监听背景音频开始跳转操作事件

11.onSeeked（） 监听背景音频完成跳转操作事件

12.onEnded（） 监听背景音频自然播放结束事件

13.onStop（） 监听背景音频停止事件

14.onTimeUpdate（） 监听背景音频播放进度更新事件，只有微信小程序在前台时会调用

音频 API

音频通过wx.createInnerAudioContext()方法获取到。注意它没有title属性

区别：背景音频API：背景音乐，支持后台播放；音频API：微信语音。

InnerAudioContext实例常用的属性和方法与BackgroundAudioManager实例常用的属性和方法相同，但是InnerAudioContext实例没有title属性。

音频的属性

1.src 音频的数据源

2.startTime 音频开始播放的时间（单位：s）

3.autoplay 是否自动播放

4.loop 是否循环播放

5.obeyMuteSwitch 是否遵循系统静音开关。当此参数为 false 时，即使用户打开了微信的静音 开关，音频也会继续播放。

6.volume 音量，范围0-1

7.duration 当前音频的长度（单位：s），只读。

8.currentTime 当前音频的播放时间（单位：s），只读。

9.paused 当前是否暂停或停止（只读）

10.buffered 音频已缓冲的时间，只读

11.srcType 设置音频的来源类型。有效值：‘inner’（表示使用内置的音频管理 器），‘network’（表示网络上的音频资源）。

音频的方法

使用：createInnerAudioContext.方法名

（方法和背景音频的方法一样）

1.play（） 播放音频

2.pause（） 暂停音频

3.stop（） 停止音频

4.destroy（） 释放音频资源

5.seek(position) 跳转到指定位置播放

6.onCanplay（） 背景音频进入可以播放状态的事件（参数为回调函数）

7.onWaiting（） 监听背景音频加载中事件，当背景音频因为数据不足需要停下来加载时会触发

8.onError（） 监听音频播放错误事件

9.onPlay（） 监听音频暂停事件

10.onPause（） 监听音频暂停事件

// 创建InnerAudioContext实例

var audioCtx = wx.createInnerAudioContext()

// 设置音频资源地址

audioCtx.src='xxxxxxx.mp3'

// 开始播放

audioCtx.play()

选择媒体 API

选择媒体通过wx.chooseMedia（）方法获取到

作用：微信小程序的媒体API用于选择图片或视频。一般用于上传头像、上传照片和视频等功能

常用属性

1.count 【number型】 最多可以选择的文件个数，默认值为9

2.mediaType 【Array.字符串数组】文件类型，默认值[’image‘，’video‘]

3.sourceType 【Array.字符串数组】图片和视频选择的来源。默认值为 [’album‘，’camera‘],也就是图库，相机

4.maxDuration 【number型】 拍摄视频最长拍摄时间，单位秒。时间范围为3-60秒之间。不限 制相册，默认值为10

5.camera 【string型】 仅在sourceType为camera时生效，可设置使用前置或后置

6.success 【function】 接口调用成功的回调函数

7.fail 【function】 接口调用失败的回调函数

8.complete 【function】 接口调用结束的回调函数（成功、失败都会执行）

文件上传 API

文件上传通过wx.unploadFile()方法获取到

常用属性

1.url 【string型】 必填项。开发者服务器地址（上传接口路径）

2.header 【object型】 http请求的header。header中不能设置referer

3.timeout 【number型】 超时时间（单位：毫秒）

4.name 【string型】必填项。文件对应的key，开发者在服务器端可以通过这个key获取文件的二进制内容

5.filePath 【string型】必填项。要上传的文件资源的路径（是指本地路径，可以通过输出res来查看。注意不是上传接口路径）

6.success 【function】 接口调用成功的回调函数

7.fail 【function】 接口调用失败的回调函数

8.complete 【function】 接口调用结束的回调函数（成功、失败都会执行）

图片预览 API

图片预览体通过wx.previewImage（）方法获取到

常用属性

1.urls 【Array.】 需要预览的图片链接列表

2.current 【string】 表示当前显示图片的链接，不填则默认为urls的第一张