apsaraShortVideoBase

openRecordView

openEditorView

概述

本插件封装了阿里云视频点播的短视频基础版的相关功能，短视频基础版SDK提供短视频录制、导入和编辑的高级功能，支持多种分辨率选择、实时美颜、实时滤镜、摄像头切换、闪光灯切换等多样的录制功能。

短视频SDK license 开通

  • 购买套餐后请提供应用名、订单号、bundleID、包名和签名（MD5格式小写无冒号），并发送至videosdk@service.aliyun.com，以便为您开通短视频SDK License。
  • license不需要集成到SDK里面，只需确保提交申请的bundleID、包名、签名和自己工程中的完全一致。测试时可以直接使用demo提供的bundleID、包名、签名来体验。
  • 基础版和标准版购买1个套餐最多支持1个app（最多支持10个马甲包），专业版1次购买最多支持3个app（最多支持10个马甲包）。

关于SDK试用

  • 请发送公司名称、应用名称、申请试用的SDK版本、联系人、联系电话、应用bundleID、包名和签名信息（MD5格式小写无冒号）、阿里云的账号/UID（若没有账号请注册）至videosdk@service.aliyun.com，申请开通试用（以上资料请保证齐全、格式规范）。2个工作日之内处理完开通申请。
  • 试用期默认为一个月。

注意：本插件 iOS 平台上最低适配系统版本为 iOS 9.0

openRecordView

打开视频录制页面

openRecordView(params,callback(ret))

params

recordConfig：

  • 类型：JSON 对象
  • 描述：录制视频参数
  • 内部字段：
{
    position:0,           //数字类型；摄像头方向；0：前摄像头，1：后摄像头；默认：0
    torchMode:0,          //数字类型；闪光灯模式；0：关闭，1：开启，2：自动；默认：2
    beautifyStatus:true,  //布尔类型；美颜状态；默认：true
    beautifyValue:60,     //数字类型；美颜度；取值范围：0-100；默认：60
    outputPath:'',        //字符类型；输出路径；仅支持fs；注意输出路径含文件及后缀名称；默认：'fs://apsaraShortVideoBase/video.mp4'
    size:3,               //数字类型；视频分辨率；0：360P，1：480P，2：540P，3：720P；默认：3
    ratio:0,              //数字类型；视频比例；0：3:4，1：9:16，2：1:1；默认：0
    minDuration:5,        //数字类型；最小时长；默认：5
    maxDuration:30,       //数字类型；最大时长；默认：30
    videoQuality:0,       //数字类型；视频质量；0：极高，1：高，2：中等，3：低，4：较低，5：极低；默认：0
    encodeMode:0,         //数字类型；编码方式；0：软编，1：硬编；默认：0
    fps:20,               //数字类型；帧率；默认：20
    gop:5,                //数字类型；关键帧间隔；默认：5
}

UIConfig：

  • 类型：JSON 对象
  • 描述：UI配置
  • 内部字段：
{
    backgroundColor:'',             //字符类型；背景颜色，支持rgb、rgba、#；默认：'#232A42'
    timelineTintColor:'',           //字符类型；录制进度条 已录制颜色，支持rgb、rgba、#；默认：'#EF4B81'
    timelineBackgroundColor:'',    //字符类型；录制进度条 背景颜色，支持rgb、rgba、#；默认：'#232A42'
    timelineDeleteColor:'',         //字符类型；录制进度条 视频删除部分选中颜色，支持rgb、rgba、#；默认：'#FF0000'
    durationLabelTextColor:'',      //字符类型；制时间提示框 字体颜色，支持rgb、rgba、#；默认：'#FF0000'
    cutBottomLineColor:'',          //字符类型；裁剪页裁剪条下边框颜色，支持rgb、rgba、#；默认：'#FF0000'(IOS)
    cutTopLineColor:'',             //字符类型；裁剪页裁剪条上边框颜色，支持rgb、rgba、#；默认：'#FF0000'(IOS)
    cutLineColor:'',             //字符类型；裁剪页裁剪条边框颜色，支持rgb、rgba、#；默认：'#FF0000'(android)
    hiddenDurationLabel: false,     //布尔类型；隐藏已录制时间提示框；默认：false
    hiddenBeautyButton: false,      //布尔类型；隐藏美颜按钮；默认：false
    hiddenCameraButton: false,      //布尔类型；隐藏切换摄像头按钮；默认：false
    hiddenFlashButton: false,       //布尔类型；隐藏闪光灯按钮；默认：false
    hiddenImportButton: false,      //布尔类型；隐藏相册导入按钮；默认：false
    hiddenDeleteButton: false,      //布尔类型；隐藏删除视频片段按钮；默认：false
    hiddenFinishButton: false,      //布尔类型；隐藏录制完成按钮；默认：false
    recordOnePart: false,           //布尔类型；是否录制单段视频；默认：false  (IOS)
    showCameraButton: true,         //布尔类型；相册界面是否显示跳转相机按钮；默认：true (1.0.2遗弃)
    recordType:0,                   //数字类型；录制模式；默认：0(IOS)
                                    //0：混合模式（短按自动录制，再次短按停止录制+长按录制，松开停止录制）
                                    //1：短按模式（短按自动录制，再次短按停止录制）
                                    //2：长按模式（长按录制，松开停止录制）
    noneFilterText:'',              //字符类型；录制切换为无滤镜选项时提示文字；默认：'无滤镜' (IOS)   
}

callback(ret)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status:true,     //布尔类型；是否录制成功
    path:'',         //字符类型；视频保存路径
    imagePath:''     //字符类型；图片保存路径
    msg:''           //字符类型；失败原因

}

示例代码

var apsaraShortVideoBase = api.require('apsaraShortVideoBase');
apsaraShortVideoBase.openRecordView({
   recordConfig:{
    position:0,          
    torchMode:0,         
    beautifyStatus:true,   
    beautifyValue:60,     
    outputPath:'fs://apsaraShortVideoBase/video.mp4',        
    size:3,               
    ratio:0,             
    minDuration:5,        
    maxDuration:30,       
    videoQuality:0,       
    encodeMode:0,         
    fps:20,               
    gop:5,                
},
UIConfig:{
    backgroundColor:'',           
    timelineTintColor:'',      
    timelineBackgroundCollor:'',    
    timelineDeleteColor:'',        
    durationLabelTextColor:'',      
    cutBottomLineColor:'',          
    cutTopLineColor:'',            
    hiddenDurationLabel: false,  
    hiddenBeautyButton: false,    
    hiddenCameraButton: false,    
    hiddenFlashButton: false,      
    hiddenImportButton: false,     
    hiddenDeleteButton: false,      
    hiddenFinishButton: false,     
    recordOnePart: false,           
    recordType:0,               
    noneFilterText:'',      
}
}, function(ret){
     api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

openEditorView

打开视频编辑页面

openEditorView(params,callback(ret,err))

params

outputPath：

  • 类型：字符串
  • 描述：（可选项）视频输出路径
  • 默认：'fs://apsaraShortVideoBase/video.mp4'

outputSize:(IOS)

  • 类型：JSON对象
  • 描述：(可选项）输出大小
{
      w: 320,  //（可选项）数字类型；编辑视频宽；默认值：屏幕宽度
      h: 300,  //（可选项）数字类型；编辑视频高；默认值：屏幕高度
}

minDuration：

  • 类型：数字
  • 描述：（可选项）过滤相册视频最小时长
  • 默认：0

maxDuration：

  • 类型：数字
  • 描述：（可选项）过滤相册视频最大时长
  • 默认：60

cutMode：

  • 类型：数字
  • 描述：（可选项）裁剪模式；0：填充，1：裁剪
  • 默认：0

videoQuality：

  • 类型：数字
  • 描述：（可选项）视频质量；；0：极高，1：高，2：中等，3：低，4：较低，5：极低；
  • 默认：0

encodeMode：

  • 类型：数字
  • 描述：（可选项）编码方式；0：软编，1：硬编；
  • 默认：0

fps：

  • 类型：数字
  • 描述：（可选项）帧率
  • 默认：20

gop：

  • 类型：数字
  • 描述：（可选项）关键帧间隔
  • 默认：5

bitrate：

  • 类型：数字
  • 描述：（可选项） 裁剪码率 (1.0.2遗弃)
  • 默认：10

videoOnly：

  • 类型：布尔
  • 描述：（可选项）是否仅展示视频
  • 默认：true

fillBackgroundColor：(IOS)

  • 类型：字符串
  • 描述：（可选项）填充的背景颜色
  • 默认：'#232A42'

gpuCrop：

  • 类型：布尔
  • 描述：（可选项）是否使用gpu裁剪
  • 默认：false

callback(ret)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status:true,     //布尔类型；是否录制成功
    path:'',         //字符类型；视频保存路径
    imagePath:''     //字符类型；图片保存路径
    msg:''           //字符类型；失败原因

}

示例代码

var apsaraShortVideoBase = api.require('apsaraShortVideoBase');
apsaraShortVideoBase.openEditorView({                                               
    outputPath:'fs://res/video.mp4',                                              
    outputSize:{
        w: 320, 
        h:300                                
    }, 
    minDuration:0,
    maxDuration:10,
    cutMode:1,
    videoQuality:5,
    encodeMode:1, 
    fps:50,
    gop:10,
    bitrate:10,
    videoOnly:false,
    fillBackgroundColor:'#0000FF',
    gpuCrop:true
},function(ret){
     api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/07/22