分类： 视频

wx.chooseVideo(Object object)

从基础库 2.21.0 开始，本接口停止维护，请使用 wx.chooseMedia 代替

以 Promise 风格 调用：支持

微信小程序插件：支持，需要微信小程序基础库版本不低于 1.9.6

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

拍摄视频或从手机相册中选视频。

参数

Object object

属性 类型 默认值 必填 说明 最低版本
sourceType Array.<string> [‘album’, ‘camera’] 否 视频选择的来源
合法值 说明
album 从相册选择视频
camera 使用相机拍摄视频
compressed boolean true 否 是否压缩所选择的视频文件 1.6.0
maxDuration number 60 否 拍摄视频最长拍摄时间，单位秒
camera string ‘back’ 否 默认拉起的是前置或者后置摄像头。部分 Android 手机下由于系统 ROM 不支持无法生效
合法值 说明
back 默认拉起后置摄像头
front 默认拉起前置摄像头
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数
Object res
属性 类型 说明
tempFilePath string 选定视频的临时文件路径 (本地路径)
duration number 选定视频的时间长度
size number 选定视频的数据量大小
height number 返回选定视频的高度
width number 返回选定视频的宽度

示例代码

wx.chooseVideo({
  sourceType: ['album','camera'],
  maxDuration: 60,
  camera: 'back',
  success(res) {
    console.log(res.tempFilePath)
  }
})

wx.compressVideo(Object object)

基础库 2.11.0 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 鸿蒙 OS 版：支持

功能描述

压缩视频接口。开发者可指定压缩质量 quality 进行压缩。当需要更精细的控制时，可指定 bitrate、fps、和 resolution，当 quality 传入时，这三个参数将被忽略。原视频的相关信息可通过 getVideoInfo 获取。

参数

Object object

属性 类型 默认值 必填 说明
src string 是 视频文件路径，可以是临时文件路径也可以是永久文件路径
quality string 否 压缩质量
合法值 说明
low 低
medium 中
high 高
bitrate number 是 码率，单位 kbps
fps number 是 帧率
resolution number 是 相对于原视频的分辨率比例，取值范围(0, 1]
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数
Object res
属性 类型 说明
tempFilePath string 压缩后的临时文件地址
size number 压缩后的大小，单位 kB

微信小程序 wx.createVideoContext(string id, Object this)

微信小程序插件：支持，需要微信小程序基础库版本不低于 1.9.6

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: video 组件

功能描述

创建 video 上下文 VideoContext 对象。建议使用 wx.createSelectorQuery 获取 context 对象。

参数

string id

video 组件的 id

Object this

在自定义组件下，当前组件实例的this，以操作组件内 video 组件

返回值

VideoContext

wx.getVideoInfo(Object object)

基础库 2.11.0 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

微信小程序插件：支持

微信 鸿蒙 OS 版：支持

功能描述

获取视频详细信息。

参数

Object object

属性 类型 默认值 必填 说明
src string 是 视频文件路径，可以是临时文件路径也可以是永久文件路径
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数
Object res
属性 类型 说明
orientation string 画面方向
合法值 说明
up 默认
down 180度旋转
left 逆时针旋转90度
right 顺时针旋转90度
up-mirrored 同up，但水平翻转
down-mirrored 同down，但水平翻转
left-mirrored 同left，但垂直翻转
right-mirrored 同right，但垂直翻转
type string 视频格式
duration number 视频长度
size number 视频大小，单位 kB
height number 视频的长，单位 px
width number 视频的宽，单位 px
fps number 视频帧率
bitrate number 视频码率，单位 kbps

打开视频编辑器

基础库 2.12.0 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：不支持

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.15.0

功能描述

打开视频编辑器

参数

Object object

属性 类型 默认值 必填 说明 最低版本
filePath string 是 视频源的路径，只支持本地路径
minDuration string 是 视频裁剪的最小长度 2.16.1
maxDuration string 是 视频裁剪的最大长度 2.16.1
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数
Object res
属性 类型 说明
duration number 剪辑后生成的视频文件的时长，单位毫秒（ms）
size number 剪辑后生成的视频文件大小，单位字节数（byte）
tempFilePath string 编辑后生成的视频文件的临时路径
tempThumbPath string 编辑后生成的缩略图文件的临时路径

wx.saveMediaToPhotosAlbum(Object object)

基础库 3.17.2 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

用户授权：需要 scope.writePhotosAlbum

微信小程序插件：支持，需要微信小程序基础库版本不低于 3.17.2

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

保存图片或视频到系统相册。支持同时保存图片或视频。其中视频支持 mp4 视频格式。

参数

Object object

属性 类型 默认值 必填 说明
filePaths Array.<String> 否 图片或视频的路径数组，可以是临时文件路径或本地路径
mediaTypes Array.<String> 否 指定保存的媒体类型数组，仅支持 ‘image’ 和 ‘video’
合法值 说明
image 图片
video 视频
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

wx.saveMediaToPhotosAlbum({
  filePaths: ['wxfile://xxx'],
  mediaTypes: ['image', 'video'],
  success (res) {
    console.log(res.errMsg)
  }
})

保存视频到系统相册

基础库 1.2.0 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

用户授权：需要 scope.writePhotosAlbum

微信小程序插件：支持，需要微信小程序基础库版本不低于 1.9.6

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

保存视频到系统相册。支持mp4视频格式。

参数

Object object

属性 类型 默认值 必填 说明
filePath string 是 视频文件路径，可以是临时文件路径也可以是永久文件路径 (本地路径)
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

wx.saveVideoToPhotosAlbum({
  filePath: 'wxfile://xxx',
  success (res) {
    console.log(res.errMsg)
  }
})