videoTool

来自于：开发者立即使用

compressVideo captureScreen getVideoInfo interceptionVideo

概述

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及更高版本