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 对象
  • 内部字段:
  1. {
  2. state: 0 //数字类型;0代表视频处理成功,1代表视频处理失败。
  3. compressPath:""//字符串类型;视频处理后的文件路径
  4. }

err:

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

示例代码

  1. var videoTool = api.require('videoTool');
  2. videoTool.compressVideo({
  3. directories:'',
  4. format:'mp4',
  5. presetName:1
  6. },function(ret,err){
  7. alert(JSON.stringify(ret));
  8. });

可用性

iOS系统

可提供的1.0.0及更高版本

captureScreen

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

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

params

path:

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

startTime:

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

callback(ret, err)

ret:

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

err:

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

示例代码

  1. var demo = api.require('videoTool');
  2. demo.captureScreen({
  3. path:'',
  4. startTime:0
  5. },function(ret,err){
  6. alert(JSON.stringify(ret));
  7. });

可用性

iOS系统

可提供的1.0.0及更高版本

getVideoInfo

获取视频信息

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

params

path:

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

callback(ret, err)

ret:

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

err:

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

示例代码

  1. var videoTool = api.require('videoTool');
  2. videoTool.getVideoInfo({
  3. path:''
  4. },function(ret,err){
  5. alert(JSON.stringify(ret));
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

interceptionVideo

截取视频功能

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

params

path:

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

rulerLabelInterval

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

maxLength

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

minLength

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

callback(ret, err)

ret:

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

err:

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

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本