aliShortVideo
概述
aliShortVideo简介
aliShortVideo模块封装了带UI的阿里短视频的视频功能,包括视频录制,视频编辑,视频剪裁等功能
模块使用攻略
短视频SDK服务需要开通License,开通方式请参考
固件要求
iOS:8.0及以上
模块接口
videoRecord
视频录制
videoRecord({params}, callback(ret))
params
minDuration:
- 类型:数字类型
- 描述:(可选项)最小时长,单位秒。
- 默认值: 2
maxDuration:
- 类型:数字类型
- 描述:(可选项)最大时长,单位秒 。
- 默认值:15
gop
- 类型:数字类型
- 描述:(可选项)关键帧。
- 默认值:30
videoQuality
- 类型:数字类型
- 描述:(可选项)视频清晰度。
- 默认值:2
- 0:超高清 - 1:高清 - 2:普通 - 3:低 - 4:很低 - 5:差
encodeMode
- 类型:数字类型
- 描述:(可选项)编码格式。
- 默认值:1
- 0:软编:提升质量、牺牲速度 - 1:硬编:提升速度、牺牲视频质量
recordType
- 类型:数字类型
- 描述:(可选项)拍摄方式。(仅iOS支持)
- 默认值:1
- 1:普通 - 2:合拍
videoFlipH:
- 类型:布尔类型
- 描述:(可选项)镜像输出 。
- 默认值:false
beautyType
- 类型:数字类型
- 描述:(可选项)美颜类型。
- 默认值:1
- 0:Race - 1:FaceUnity
videoOutputWidth
- 类型:数字类型
- 描述:(可选项)分辨率。(仅iOS支持)
- 默认值:360
- 360 - 480 - 540
resolutionMode
- 类型:数字类型
- 描述:(可选项)分辨率基数(仅android支持)
- 默认值:0
- 内部字段:
0:360P 1:480P 2:540P 3:720P
beautyLevel
- 类型:数字类型
- 描述:(可选项)美颜级别(仅android支持)
- 取值范围:【0-100】
cameraType
- 类型:数字类型
- 描述:(可选项)前后摄像头设置(仅android支持)
- 取值范围:0:前摄像头,1:后摄像头
videoOutputRatio
- 类型:数字类型
- 描述:(可选项)视频比例。
- 默认值:0
- 0: 9:16 - 1: 3:4 - 2: 1:1
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:'success', //字符串类型
- 'fail'
- 'success'
- 'uploading' //仅iOS支持
- 'cancel' //仅iOS支持
- 'pause' //仅iOS支持
outputPath:'', //视频路径
}
示例代码
var name = api.require('aliShortVideo');
name.videoRecord({
minDuration:2, //最小时长
maxDuration:15,//最大时长
gop:30,//关键帧间隔
videoQuality:1,//视频清晰度
encodeMode:1,//b编码格式
recordType:0,//拍摄方式
videoFlipH:false,//镜像输出
beautyType:0,//美颜类型
videoOutputWidth:360,//分辨率
videoOutputRatio:1,//视频比例
}, function(ret) {
if (ret) {
alert(JSON.stringify(ret));
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
videoeEdit
视频编辑(仅iOS支持)
videoeEdit({params}, callback(ret))
params
fps:
- 类型:数字类型
- 描述:(可选项)帧率。
- 默认值: 30
gop
- 类型:数字类型
- 描述:(可选项)关键帧。
- 默认值:30
videoQuality
- 类型:数字类型
- 描述:(可选项)视频清晰度。
- 默认值:2
- 0:超高清 - 1:高清 - 2:普通 - 3:低 - 4:很低 - 5:差
encodeMode
- 类型:数字类型
- 描述:(可选项)编码格式。
- 默认值:1
- 0:软编:提升质量、牺牲速度 - 1:硬编:提升速度、牺牲视频质量 -
videoOutputWidth
- 类型:数字类型
- 描述:(可选项)分辨率。
- 默认值:360
- 360 - 480 - 540
videoOutputRatio
- 类型:数字类型
- 描述:(可选项)视频比例。
- 默认值:0
- 0: 9:16 - 1: 3:4 - 2: 1:1
cutMode
- 类型:数字类型
- 描述:(可选项)裁剪模式。
- 默认值:1
- 0: 填充 - 1: 裁剪
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:'success', //字符串类型
- 'fail'
- 'success'
- 'uploading'
- 'cancel'
- 'pause'
outputPath:'', //视频路径
}
示例代码
var name = api.require('aliShortVideo');
name.videoeEdit({
fps:30, //帧率
gop:30,//关键帧间隔
videoQuality:1,//视频清晰度
encodeMode:1,//b编码格式
videoOutputWidth:360,//分辨率
videoOutputRatio:1,//视频比例
cutMode:1,//裁剪模式
hasEnd:false,//是否有片尾
}, function(ret) {
if (ret) {
alert(JSON.stringify(ret));
}
});
可用性
iOS系统
可提供的1.0.0及更高版本
videoClip
视频剪裁
videoClip({params}, callback(ret))
params
fps:
- 类型:数字类型
- 描述:(可选项)帧率。
- 默认值: 30
gop
- 类型:数字类型
- 描述:(可选项)关键帧。
- 默认值:30
videoQuality
- 类型:数字类型
- 描述:(可选项)视频清晰度。
- 默认值:2
- 0:超高清 - 1:高清 - 2:普通 - 3:低 - 4:很低 - 5:差
encodeMode
- 类型:数字类型
- 描述:(可选项)编码格式。
- 默认值:1
- 0:软编:提升质量、牺牲速度 - 1:硬编:提升速度、牺牲视频质量 -
videoOutputWidth
- 类型:数字类型
- 描述:(可选项)分辨率。(仅iOS支持)
- 默认值:360
- 360 - 480 - 540
resolutionMode
- 类型:数字类型
- 描述:(可选项)分辨率基数(仅android支持)
- 默认值:0
- 内部字段:
0:360P 1:480P 2:540P 3:720P
videoOutputRatio
- 类型:数字类型
- 描述:(可选项)视频比例。
- 默认值:0
- 0: 9:16 - 1: 3:4 - 2: 1:1
cutMode
- 类型:数字类型
- 描述:(可选项)裁剪模式。
- 默认值:1
- 0: 填充 - 1: 裁剪
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:, //布尔类型
sourcePath:'', //视频路径;此参数当status为true时返回
}
示例代码
var name = api.require('aliShortVideo');
name.videoClip({
fps:30, //帧率
gop:30,//关键帧间隔
videoQuality:1,//视频清晰度
encodeMode:0,//b编码格式
videoOutputWidth:360,//分辨率
videoOutputRatio:1,//视频比例
cutMode:0,//裁剪模式
}, function(ret) {
if (ret) {
alert(JSON.stringify(ret));
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本