quPaiModule

来自于:开发者立即使用

微视频云接入(使用该模块特别需要注意安卓的65k异常导致的不能编译打包)

开发者在使用quPaiModule模块时,需要开发者自行到趣拍的微视频云申请账号,具体流程请参考如下介绍。

申请步骤

1、登录趣拍帐号

访问微视频云控制台页面,若您未登录账号,将会进入账号登录页面, 登录地址:http://vcs.qupai.me/dq.html#/login 如下图:

描述

2、登陆趣拍云控制台,具体如下图: 描述

3、创建应用 点击"创建应用",系统将为您弹出需要填写应用的相关信息,具体如下图: 描述

概述

1、quPaiModule模块,实现了IOS、 Android 平台集成趣拍SDK标准版本模块。可以设置录制时长、视频码率、美颜参数等丰富了app视频录制相关功能;

2、最新版本趣拍拍摄模块取消验证授权和视频上传功能。 (趣拍授权新规则如下:)

a. 申请并开通阿里云oss服务。

b. 联系趣拍商务进行趣拍标准版授权。

c. 趣拍官方授权绑定的app包名请不要随便修改,否则会造成授权失效。

setMusic

设置音乐库地址

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

params

musicPath:

  • 类型:字符串
  • 描述:(可选项)设置音乐配置json文件路径;支持widget://。
  • 默认值:widget://res/music.json
  • music.json内容值:
    {
      "music": [{
          "resourceUrl": "widget://res/music/Athena",
          "id": 1,
          "name": "Athena"
      },
      {
          "resourceUrl": "widget://res/music/Box Clever",
          "id": 2,
          "name": "Box Clever"
      }],
    }
    备注:
    resourceUrl :为音乐文件夹路径(内容规则参考music音乐文件包规则,支持widget://)
    name:手机显示该音乐名称
    
  • music音乐文件包规则:
--Athena(文件夹)
--Athena/audio.mp3(音乐文件,固定名称)
--Athena/icon_without_name.png(android显示图片,固定名称)
--Athena/icon.png(iOS显示图片,固定名称)

示例代码

var obj = api.require('quPaiModule');
obj.setMusic({
    musicPath: "widget://res/music.json"
},
function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

record

录制视频

record({params}, callback(ret, err))

params

minDuration:

  • 类型:数字类型
  • 描述:(必填项)允许拍摄的最小时长;
  • 默认值:2

maxDuration:

  • 类型:数字类型
  • 描述:(必填项)允许拍摄的最大时长,时长越大,产生的视频文件越大;
  • 默认值:8

bitRate:

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

videoWidth:

  • 类型:数字类型
  • 描述:(必填项)输出视频的尺寸>宽(仅安卓有效);
  • 默认值:480

videoHeight:

  • 类型:数字类型
  • 描述:(必填项)输出视频的尺寸>高(仅安卓有效);
  • 默认值:480

watermarkImage:

  • 类型:字符串
  • 描述:(可选项)视频水印图片,传空则不加水印,支持widget://

enableBeautySkinOn:

  • 类型:布尔型
  • 描述:(可选项)美颜是否显示
  • 默认值:false

enableImport:

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

enableVideoEffect:

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

beautySkinProgress:

  • 类型:数字类型
  • 描述:(可选项)美颜参数(仅安卓有效);
  • 默认值:80

isBackCamera:

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

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,
    //布尔型;true||false
    data: {
        videoPath: "",
        //视频存放路径 
        thumbnailPath: "" //缩略图路径
        duration: 1233 //视频时长(仅Android有)
    }
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg: ""
}

示例代码

var param = {
    minDuration: 1,
    maxDuration: 16,
    videoWidth: 480,
    videoHeight: 480,
    bitRate: 2000000,
    watermarkImage: 'widget://res/watermask.png',
    watermarkPosition: 2,
    enableImport: true,
    enableVideoEffect: true,
    enableBeautySkinOn: true,
    beautySkinProgress: 50,
    isBackCamera:false
};
var demo = api.require('quPaiModule');
demo.record(param,
function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getCacheSize

获取视频存放文件夹大小

getCacheSize(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,   //布尔型;true||false
    cacheSize : "",//文件夹大小
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg: ""
}

示例代码


var demo = api.require('quPaiModule');
demo.getCacheSize(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

clearCache

清除存放视频文件夹所有视频

clearCache(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,   //布尔型;true||false
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg: ""
}

示例代码


var demo = api.require('quPaiModule');
demo.clearCache(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本