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