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:硬编:提升速度、牺牲视频质量

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编码格式 
                     videoFlipH:false,//镜像输出
                     beautyType:0,//美颜类型
                     videoOutputWidth:360,//分辨率
                     videoOutputRatio:1,//视频比例
                
    }, function(ret) {
        if (ret) {
           api.alert({msg: 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) {
           api.alert({msg: 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) {
           api.alert({msg: JSON.stringify(ret)});
        }
    });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/11/18