更新记录

1.3(2020-10-13)

更新ios版本库

1.2(2020-09-11)

增加ios版本。

1.1(2020-08-26)

1、新增水印设置 2、视频录制回调 3、视频上传等接口

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 适用版本区间:9 - 16

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


阿里云短视频SDK(标准版)插件接口说明

注意:阿里云申请的licence不需要设置,确保app的包名和签名和申请licence时保持一致。

1. 插件对象

//插件对象
var sdkwx = uni.requireNativePlugin('Ali-SVSdkWX');

2. 设置录制回调,在onLoad调用一次即可

sdkwx.setEventCallback({
    autoPublish:false/*,参数可选
    BASE_URL:"自定义域名",//默认阿里云提供的业务服务器,可自己配置域名
    effectImagePath:"/store/xxx/xx.png",//图片平台绝对路径,记得不是uniapp的路径需要转换平台的绝对路径
    effectImageX:10,
    effectImageY:10,
    effectImageWidth:100,
    effectImageHeight:30//*/
}, function(res) {
    console.log(res);
    if (res.type == "onPublish") {
        var videoPath = res.data.video_path;
        var videoThumbnail = res.data.video_thumbnail;
        //上传
    }
});

3. 视频拍摄

sdkwx.startRecord({
    minDuration:2000,//最小时长,大于0
    maxDuration:15000,//最大时长,不超过300000即300s
    gop:250,//关键帧间隔,建议1-300
    videoQuality:1,//视频质量,取值0-5,分别表示SSD, HD, SD, LD, PD, EPD
    ratioMode:2,//视频比例,取值0-2,分别表示3:4,1:1,9:16
    resolutionMode:3,//分辨率,取值0-3,分别表示360P,480P,540P,720P
    videoCodecs:0,//视频编码方式,取值0-2,分别表示H264_HARDWARE(硬编),H264_SOFT_OPENH264(软编),H264_SOFT_FFMPEG(软编)
    videoRenderingMode:0,//高级美颜,取值0-1,分别表示FaceUnity,Race
    isUseFlip:false,//是否镜像输出
    shootMode:0//拍摄方式,取值0-1,分别表示普通,合拍               
});

4. 视频编辑

sdkwx.startImport({
    frameRate:30,//帧率,建议20-30
    gop:250,//关键帧间隔,建议1-300
    videoQuality:1,//视频质量,取值0-5,分别表示SSD, HD, SD, LD, PD, EPD
    ratioMode:2,//视频比例,取值0-2,分别表示3:4,1:1,9:16
    resolutionMode:3,//分辨率,取值0-3,分别表示360P,480P,540P,720P
    scaleMode:1,//裁剪模式,取值0-1,分别表示画面裁剪,画面填充
    hasTailAnimation:false,//是否添加片尾水印
    videoCodecs:0//视频编码方式,取值0-2,分别表示H264_HARDWARE(硬编),H264_SOFT_OPENH264(软编),H264_SOFT_FFMPEG(软编)               
});

5. 视频裁剪

sdkwx.startCrop({
    frameRate:30,//帧率,建议20-30
    gop:250,//关键帧间隔,建议1-300
    videoQuality:1,//视频质量,取值0-5,分别表示SSD, HD, SD, LD, PD, EPD
    ratioMode:2,//视频比例,取值0-2,分别表示3:4,1:1,9:16
    resolutionMode:3,//分辨率,取值0-3,分别表示360P,480P,540P,720P
    scaleMode:1,//裁剪模式,取值0-1,分别表示画面裁剪,画面填充
    videoCodecs:0//视频编码方式,取值0-2,分别表示H264_HARDWARE(硬编),H264_SOFT_OPENH264(软编),H264_SOFT_FFMPEG(软编)                   
});

6. 上传视频封面图片

var videoThumbnail = "";//视频图片封面路径
var uploadAddress = "";//阿里云上传凭证
var uploadAuth = "";//阿里云上传凭证
sdkwx.uploadImageWithVod(videoThumbnail, uploadAddress, uploadAuth, function(res){
    if (res.type == "onUploadSucceed") {
        console.log("上传图片成功");
    }
});

7. 上传视频

var videoPath = "";//视频路径
var uploadAddress = "";//阿里云上传凭证
var uploadAuth = "";//阿里云上传凭证
sdkwx.uploadVideoWithVod(videoPath, uploadAddress, uploadAuth, function(res){
    if (res.type == "onUploadSucceed") {
        console.log("上传图片成功");
    }
});

隐私、权限声明

1. 本插件需要申请的系统权限列表:

相机 麦克风 相册 储存卡读写

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件自身不采集任何数据,插件使用的阿里云短视频 SDK采集数据请参考其官方说明:https://promotion.aliyun.com/ntms/act/shortvideo.html

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问