UIPLShortVideo

loadRes

概述

UIPLShortVideo 封装了七牛的短视频 SDK，同时集成了抖音的美颜等功能。

使用本模块需要先跟抖音和七牛注册账号并开通相关权限，获取相关参数和文件。

本模块是一套完整的短视频录制器，自带UI，只需一个接口即可开发出完整的短视频录制功能。简单快捷。

注意：iOS端授权文件和包名（bundle ID）是绑定的，否则运行闪退。

Android需要如下配置

  • 下载自定义模块qiniuShortvideoRes
  • 解压后将 qiniushortvideores-release.aar->assets->resource下相应的bundle目录替换为自己的重新打包，自定义模块编译即可

Android调用流程如下

  • 调用auth进行授权，返回authorized表示授权成功，unAuthorized授权失败联系七牛商务
  • 授权成功，调用loadRes加载/检测是否加载美颜，特效资源
  • 资源加载成功后open即可

auth

授权 （暂仅支持Android）

ret：

  • 类型：JSON 对象
  • 内部字段：

示例代码

  1. PLShortVideo.auth(function(ret){
  2.     alert(JSON.stringify(ret));
  3. });

loadRes

加载资源（第一次使用的时候会加载资源，耗时较长） （暂仅支持Android）

loadRes(callback(ret))

ret：

  • 类型：JSON 对象
  • 内部字段：

示例代码

  1. var PLShortVideo = api.require('UIPLShortVideo');
  2. PLShortVideo.loadRes(function(ret){
  4. });

open

打开视频录像机

open({params},callback(ret))

modelFileDirPath：

  • 类型：字符串
  • 描述：算法模型文件所在目录路径，要求本地路径。如：widget://res/ModelResource.bundle

licenseFilePath：

  • 类型：字符串
  • 描述：授权文件路径，要求本地路径。如：widget://res/LicenseBag.bundle/qiniu_20200214_20210213_com.qbox.PLShortVideoKit.ByteDance.Demo_qiniu_v3.4.2.licbag
  • 类型：数字类型
  • 描述：（可选项）视频录制的最大时长，单位为秒
  • 默认：10

minDuration：

  • 类型：数字类型
  • 描述：（可选项）视频录制的最短时间，单位为秒；
  • 默认：2

beautifyModeOn：

  • 描述：（可选项）是否开启美颜
  • 默认：true

bgmPath:

  • 类型：字符串
  • 描述：背景音乐路径，要求本地路径（fs://、widget://）

token:

  • 类型：字符串
  • 描述：七牛云存储上传token

domain：

  • 类型：字符串
  • 描述：七牛云存储上传域名

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. var UIPLShortVideo = api.require('UIPLShortVideo');
  2. UIPLShortVideo.open({
  3.     modelFileDirPath:"widget://res/ModelResource.bundle",
  4. licenseFilePath:"widget://res/LicenseBag.bundle/qiniu_20200214_20210213_com.qbox.PLShortVideoKit.ByteDance.Demo_qiniu_v3.4.2.licbag",
  6.     beautifyModeOn:true,
  7.     minDuration:10,
  8.     maxDuration:60
  9. },function(ret){

可用性

iOS 系统，Android 系统

可提供的 1.0.0 及更高版本