videoClipsRecord

initRecord setMusic record

videoClipsRecord采用趣拍云(qupai)的短视频录制SDK，实现了短视频录制功能，可以设置滤镜和背景音乐。需要到趣拍云注册应用。如果没有注册，在录制的时候会弹出提示"License无效"。注册好后，不用在config.xml里面 填配置信息，趣拍网会在代码里校验签名和包名。

先要注册趣拍云帐号，并登录。

填写应用相关资料：

注册好应用后，申请试用license。

这个插件和quPaiModule差不多，开发它主要是为了压缩代码，这个插件只有quPaiModule的一半多一点大小。视频的保存路径为：内存卡/Android/data/包名/files/qupai_workspace

initRecord

设置视频参数。

initRecord({params}, callback(ret))

params

minDuration：

  • 类型：数字
  • 描述：（可选项）允许拍摄的最小时长
  • 默认值：2

maxDuration：

  • 类型：数字
  • 描述：（可选项）允许拍摄的最大时长，时长越大，产生的视频文件越大；
  • 默认值：8

bitRate：

  • 类型：数字
  • 描述：（可选项）视频码率，建议8001000-50001000,码率越大，视频越清析，视频文件也会越大。参考：8秒的视频以2000*1000的码率压缩，文件大小1.5M-2M。请开发者根据自己的业务场景设置时长和码率；
  • 默认值：800 * 1024

videoWidth：

  • 类型：数字
  • 描述：（可选项）输出视频的尺寸>宽。输出视频宽高目前只能设置1：1的宽高，建议设置为480（默认值）。
  • 默认值：480

videoHeight：

  • 类型：数字
  • 描述：（可选项）输出视频的尺寸>高。输出视频宽高目前只能设置1：1的宽高，建议设置为480（默认值）。
  • 默认值：480

watermarkImage：

  • 类型：字符串
  • 描述：（可选项）视频水印图片,传空则不加水印，支持widget://。需要透明的png图片。

waterMarkPosition：

  • 类型：数字
  • 描述：（可选项）水印的位置。右上角=1，右下角=2，默认是右上角。拍摄过程中看不到，最后导出的视频里有。（保证watermarkImage设置了图片才有效）

enableBeautySkinOn：

  • 类型：布尔
  • 描述：（可选项）美颜是否显示
  • 默认值：false

enableImport：

  • 类型：布尔
  • 描述：（可选项）是否开启本地视频导入。不开启只能用该SDK拍摄视频，开启可以导入手机中用系统相机拍摄的视频或者外部导入手机中的视频
  • 默认值：false

enableVideoEffect：

  • 类型：布尔
  • 描述：（可选项）是否开启视频编辑功能
  • 默认值：false

beautySkinProgress：

  • 类型：数字
  • 描述：（可选项）美颜参数
  • 默认值：80

isBackCamera：

  • 类型：布尔
  • 描述：（可选项）默认打开摄像头(true后置|false前置)
  • 默认值：false

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    code: -1 ,   //失败=-1，成功=0
    msg : ""   //提示信息
}

示例代码

var videoClipsRecord = api.require('videoClipsRecord');
videoClipsRecord.initRecord({
    "enableVideoEffect": true
},function(ret){
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

setMusic

设置背景音乐库，提供给用户选择。

setMusic({params}, callback(ret));

params

music：

  • 类型：对象数组
  • 描述：（必填）背景音乐信息。音乐对象有三个属性，分别是id、name和resourceUrl。id表示编码，name表示名字，resourceUrl表示音乐文件存放位置。建议是把资源文件放到res目录下。官方demo给的资源文件http://pan.baidu.com/s/1boC6NlP
music音乐文件包规则：

--Athena（文件夹）
--Athena/audio.mp3（音乐文件，固定名称）
--Athena/icon_without_name.png（android显示图片，固定名称）

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    code: -1 ,   //失败=-1，成功=0
    msg : ""   //提示信息
}

示例代码

var videoClipsRecord = api.require('videoClipsRecord');
videoClipsRecord.setMusic({
    "music": [{
          "resourceUrl": "widget://res/music/Athena",
          "id": 1,
          "name": "Athena"
      },{
        "resourceUrl": "widget://res/music/Box Clever",
        "id": 2,
        "name": "Box Clever"
      }],
},function(ret){
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

record

开始录像。

record(callback(ret));

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    code: -1 ,   //失败=-1，取消录像=0，录像成功=1
    msg : "" ,  //提示信息
    data: {  //成功才返回这个字段
        videoPath: "",  //视频存放路径
        thumbnailPath: ["","",""], //缩略图路径
        duration: 1233 //视频时长
    }
}

示例代码

var videoClipsRecord = api.require('videoClipsRecord');
videoClipsRecord.record(function(ret){
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15