videoTool

来自于:开发者立即使用

概述

videoTool 模块概述

本模块通过封装系统的视频处理,提供本地录制视频文件压缩,支持格式转换成mp4格式,只能由高分辨率转成低分辨率。截取任意时间点静态图以及获取视频信息的功能,视频截取功能(仅限于手机录制的视频)。目前仅支持iOS平台。

模块接口

compressVideo

视频压缩,格式转换

compressVideo(params},callback(ret, err))

params

directories:

  • 类型:字符串
  • 描述:处理视频的绝对路径

format

  • 类型:字符串
  • 描述:处理后视频的格式
  • 取值范围:
  • mp4

presetName

  • 类型:数字类型
  • 描述:处理后视频的分辨率,默认值为1
  • 取值范围:
  • 0(low 低分辨率)
  • 1(Medium 中等分辨率)
  • 2(Highest 高分辨率)
  • 3(640x360 分辨率)
  • 4(960x540 分辨率)
  • 5(1280x720 分辨率)
  • 6(1920x1080 分别率)
  • 7(3840x2160 分辨率 支持ios9以上)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    state: 0      //数字类型;0代表视频处理成功,1代表视频处理失败。
    compressPath:""//字符串类型;视频处理后的文件路径
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    //无返回值
}

示例代码

var videoTool = api.require('videoTool');
videoTool.compressVideo({
    directories:'',
    format:'mp4',
    presetName:1
},function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

captureScreen

截取视频任意时间点静态图

captureScreen({params}, callback(ret, err))

params

path:

  • 类型:字符串
  • 描述:处理视频的绝对路径

startTime:

  • 类型:数字类型
  • 描述:(可选项)截屏时间点,数量级为秒,如0,3.5,10等。
  • 默认值:0

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
        state: 0      //数字类型;0代表视频图片截取成功,1代表视频图片截取失败。
        imgPath:''    //字符串类型;视频图片路径
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
        //无返回值
}

示例代码

var demo = api.require('videoTool');
demo.captureScreen({
    path:'',
    startTime:0
},function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

getVideoInfo

获取视频信息

getVideoInfo({params}, callback(ret, err))

params

path:

  • 类型:字符串
  • 描述:处理视频的绝对路径

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    duration: ''  //字符串类型;视频总时长,以秒为单位
    natural:''    //字符串类型;视频分辨率
    fileSize:''   //字符串类型;视频大小,单位 byte 
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
                //无返回值
}

示例代码


var videoTool = api.require('videoTool');
videoTool.getVideoInfo({
    path:''
},function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

interceptionVideo

截取视频功能

interceptionVideo({params}, callback(ret, err))

params

path:

  • 类型:字符串
  • 描述:处理视频的绝对路径,路径须正确,并有此文件

rulerLabelInterval

  • 类型:数字类型
  • 描述:标尺数字距离显示,默认值为5

maxLength

  • 类型:数字类型
  • 描述:截取视频的最长时间,单位为秒。默认值为15

minLength

  • 类型:数字类型
  • 描述:截取视频的最短时间,单位为秒。默认值为3

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    path: ''  //字符串类型;视频截取后存储的路径。
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    //无返回值
}

示例代码


var videoTool = api.require('videoTool');
videoToolinterceptionVideo({
    path:path,
    rulerLabelInterval:10,
    maxLength:8,
    minLength:2
},function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本