ch06小程序媒体API

使用该值。
封面图url，用于做原生音频播放器背景图。原生音频播放器中的分 否
享功能，分享出去的卡片配图及背景也将使用该图。
webUrl protocol
String String
页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也 否 将使用该值。 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直 否 播音频
Number Number Number String Number
audioSource
String
必填 否
否 否 否 否 否
否
说明
支持版本
指定录音的时长，单位 ms ，如果传入了合法的 duration ，在到达指定的 duration 1.6.0
后会自动停止录音，最大值 600000（10 分钟）,默认值 60000（1 分钟）
最低版本
1.9.90 1.9.90
01 图片管理
03 获取图片信息
orientation参数说明说明如表所示。
枚举值 up down left right up-mirrored
down-mirrored
left-mirrored
right-mirrored
说明 默认 180度旋转 逆时针旋转90度 顺时针旋转90度 同up，但水平翻转
03
音频管理
03 音频管理
音频根据其播放性质可以分为背景音频和前台音频。 背景音频在小程序最小化之后还可以继续在后台播放。
03 音频管理
属性 duration
类型
说明
Number 当前音频的长度（单位：s），只有在当前有合法的 src 时返回
只读 最低版本 是
currentTime Number 当前音频的播放位置（单位：s），只有在当前有合法的 src 时返回 是
01 背景音频管理
paused src
Boolean String
小程序使用
startTime
wx.getBackgroundAudioManager() buffered title
获取全局唯一的背景音频管理器
backgroundAudioManager。
epname
Number Number String
01 图片管理
04 保存图片
小程序使用wx.saveImageToPhotosAlbum(OBJECT) 保存图片到系统相册，需要用户授权 scope.writePhotosAlbum。该接口从基础库 1.2.0 开始支持，低版本需做兼容处理。 OBJECT参数说明如表所示。
参数名 filePath success fail complete
1.9.94
03 音频管理
01 背景音频管理
backgroundAudioManager 对象的 方法说明如表所示。
方法 play pause stop seek onCanplay onPlay onPause onStop onEnded onTimeUpdate onPrev onNext onError onWaiting
音频开始播放的位置（单位：s）
否
音频缓冲的时间点，仅保证当前播放时间点到此时间点内容已缓冲。 是
音频标题，用于做原生音频播放器音频标题。原生音频播放器中的分 否
享功能，分享出去的卡片标题，也将使用该值。
专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将 否
使用该值。
歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将 否
01 图片管理
03 获取图片信息
success返回参数说明如表所示。
参数 width height path orientation type
类型 Number Number String String String
说明 图片宽度，单位px 图片高度，单位px 返回图片的本地路径 返回图片的方向 返回图片的格式
《微信小程序开发零基础入门》
第06章 小程序媒体API
• 主讲老师：XXX • 学校名称：XXX
01 图片管理 02 录音管理 03 音频管理 04 视频管理 05 相机管理
01 图片管理
01 图片管理
01 选择图片
小程序使用wx.chooseImage(OBJECT)从本地相册选择图片或使用相机拍照获得图片，图 片将被存放在设备的临时路径，在小程序本次启动期间可以正常使用。
02 录音管理
audioSource有效值如表所示。
值 auto
buildInMic headsetMic mic camcorder
说明 自动设置，默认使用手机麦克风，插上耳麦后自动切换使用耳机麦克风
手机麦克风 耳机麦克风 麦克风（没插耳麦时是手机麦克风，插耳麦时是耳机麦克风 摄像头的麦克风
支持平台 iOS/Android/devtools
01 图片管理
【例6-1】小程序媒体API图片管理的简单应用
02 录音管理
02 录音管理
小程序使用wx.getRecorderManager()获取全局唯一的录音管理器 recorderManager， 该接口从基础库 1.6.0 开始支持，低版本需做兼容处理。
方法 start pause resume stop onStart onPause onStop
iOS iOS Android Android
onFrameRecorded(callback)回调结果说明如表所示。
属性 frameBuffer isLastFrame
类型 ArrayBuffer Boolean
说明 录音分片结果数据 当前帧是否正常录音结束前的最后一帧
02 录音管理
【例6-2】小程序媒体API录音管理的简单应用
指定音频输入源，默认值为 'auto'
2.1.0
02 录音管理
采样率和码率关系如表所示。
采样率 8000 11025 12000 16000 22050 24000 32000 44100 48000
编码码率 16000 ~ 48000 16000 ~ 48000 24000 ~ 64000 24000 ~ 96000 32000 ~ 128000 32000 ~ 128000 48000 ~ 192000 64000 ~ 320000 64000 ~ 320000
success返回参数说明如下： tempFilePaths：StringArray类型，表示图片的本地文件路径列表； tempFiles：ObjectArray类型，表示图片的本地文件列表，每项是一个File对象，最低版本1.2.0开始支持。
01 图片管理
01 选择图片
File 对象结构说明如下： • path：String类型，表示本地文件路径； • size：Number类型，表示本地文件大小，单位：B。 需要注意是，wx.chooseImage获得的图片仅能在小程序启动期间临时使用。如需持久保存， 需在主动调用 wx.saveFile进行保存，在小程序下次启动时才能访问得到。
01 图片管理
01 选择图片
参数 count sizeType sourceType success fail complete
类型 Number StringArray StringArray Function Function Function
必填 否 否 否 是 否 否
说明 最多可以选择的图片张数，默认9 original 原图，compressed 压缩图，默认二者都有 album 从相册选图，camera 使用相机，默认二者都有 成功则返回图片的本地文件路径列表 tempFilePaths 接口调用失败的回调函数 接口调用结束的回调函数（调用成功与否都执行）
String
backgroundAudioManager对象的 singer
String
属性说明如表所示。
coverImgUrl String
当前是是否暂停或停止状态，true 表示暂停或停止，false 表示正在 是
播放
音频的数据源，默认为空字符串，当设置了新的 src 时，会自动开始 否
播放 ，目前支持的格式有 m4a, aac, mp3, wav
类型 String Function Function Function
必填 是 否 否 否
说明 图片文件路径，可以是临时文件路径也可以是永久文件路径，不支持网络图片路径 接口调用成功的回调函数，返回String类型参数errMsg，表示调用结果 接口调用失败的回调函数 接口调用结束的回调函数（调用成功与否都执行）
参数 src
success fail complete
类型 String
Function Function Function
必填 是
否 否 否
说明 图片的路径，可以是相对路径，临时文件路径，存储文件路径，网络图片路径
接口调用成功的回调函数 接口调用失败的回调函数 接口调用结束的回调函数（调用成功与否都执行）
方法参数说明最低版本play播放pause暂停stop停止seekposition跳转到指定位置单位sdestroy销毁当前实例oncanplaycallback音频进入可以播放状态但丌保证后面可以流畅播放onplaycallback音频播放事件onpausecallback音频暂停事件onstopcallback音频停止事件onendedcallback音频自然播放结束事件ontimeupdatecallback音频播放进度更新事件onerrorcallback音频播放错诨事件onwaitingcallback音频加载中事件当音频因为数据丌足需要停下来加载时会触发onseekingcallback音频进行seek操作事件onseekedcallback音频完成seek操作事件offcanplaycallback取消监听oncanplay事件190offplaycallback取消监听onplay事件190offpausecallback取消监听onpause事件190offstopcallback取消监听onstop事件190offendedcallback取消监听onended事件190offtimeupdatecallback取消监听ontimeupdate事件190offerrorcallback取消监听onerror事件并返回errcode190offwaitingcallback取消监听onwaiting事件190offseekingcallback取消监听onseeking事件190offseekedcallback取消监听onseeked事件190音频组件控制0203音频管理例64小程序媒体api音频组件控制的简单应用音频组件控制0204视频管理04视频管理选择视频01小程序使用wxchoosevideoobject拍摄视频或从手机相册中选视频返回视频的临时文件路径
01 图片管理
02 预览图片
小程序使用wx.previewImage(OBJECT) 预览图片，OBJECT参数说明如表所示。
参数 current
urls success fail complete
类型 String
StringArray Function Function Function
必填 否
参数
position callback callback callback callback callback callback callback callback callback callback
说明 播放 暂停 停止 跳转到指定位置，单位 s 背景音频进入可以播放状态，但不保证后面可以流畅播放 背景音频播放事件 背景音频暂停事件 背景音频停止事件 背景音频自然播放结束事件 背景音频播放进度更新事件 用户在系统音乐播放面板点击上一曲事件（iOS only） 用户在系统音乐播放面板点击下一曲事件（iOS only） 背景音频播放错误事件，返回errCode 音频加载中事件，当音频因为数据不足需要停下来加载时会触发
采样率，有效值 8000/16000/44100
1.6.0
录音通道数，有效值 1/2
1.6.0
编码码率，有效值见下表格
1.6.0
音频格式，有效值 aac/mp3
1.6.0
指定帧大小，单位 KB。传入 frameSize 后，每录制指定帧大小的内容后，会回调录 1.6.0
制的文件内容，不指定则不会回调。暂仅支持 mp3 格式
同down，但水平翻转
同left，但垂直翻转
同right，但垂直翻转
ห้องสมุดไป่ตู้
01 图片管理
03 获取图片信息
小程序使用wx.saveImageToPhotosAlbum(OBJECT) 保存图片到系统相册，需要用户授权 scope.writePhotosAlbum。该接口从基础库 1.2.0 开始支持，低版本需做兼容处理。
是 否 否 否
说明 当前显示图片的链接，不填则默认为 urls 的第一张
需要预览的图片链接列表 接口调用成功的回调函数 接口调用失败的回调函数 接口调用结束的回调函数（调用成功与否都执行）
01 图片管理
03 获取图片信息
小程序使用wx.getImageInfo(OBJECT) 获取图片信息，OBJECT参数说明如表所示。
onFrameRecorded onError
参数 options
callback callback callback callback callback
说明 开始录音 暂停录音 继续录音 停止录音 录音开始事件 录音暂停事件 录音停止事件，返回String类型参数tempFilePath表示录音文件的临时路径
已录制完指定帧大小的文件，会回调录音分片结果数据。如果设置了frameSize，则会回调此事件。 录音错误事件，返回String类型参数errMsg表示错误信息
02 录音管理
其中start(options)方法的参数说明如表所示。
属性 duration
类型 Number
sampleRate numberOfChannels encodeBitRate format frameSize
参数名 filePath
success fail complete
类型 String
Function Function Function
必填 是
否 否 否
说明 图片文件路径，可以是临时文件路径也可以是永久文件路径，不支持网络图片路径
接口调用成功的回调函数，返回String类型参数errMsg，表示调用结果 接口调用失败的回调函数 接口调用结束的回调函数（调用成功与否都执行）