UIQiniuShortVideo

来自于:AC模块工作室立即使用

概述

UIQiniuShortVideo 采用带有UI界面的方案,封装了七牛的短视频 SDK ,提供了包括美颜、滤镜、水印、断点录制、分段回删、视频编辑、混音特效、MV 特效、本地/云端存储在内的多种功能。

七牛开发者中心

iOS授权

  • 1.0.5版本后不用添加附加模块

七牛短视频 SDK需授权方可使用,开发者需要自己从七牛官方获取短视频 SDK,然后将短视频 SDK打包成一个附加自定义模块上传 APICloud 平台。制作方法如下:下载 UIQiniuShortVideoAppendix 模块 zip 包并解压,把 zip 包内 target 目录下的 PLShortVideoKit.framework 文件替换为自己从七牛官方获取的短视频 SDK。然后重新压缩为 zip 包文件上传自定义模块,云编译时勾选该模块。

android SDK授权

由于七牛短视频SDK是付费项目,未经授权的app录制时会提示“无法录制视频”,需要联系七牛商务进行授权(注意:1.0.4之后需要七牛官方授权)

使用此模块贴图功能之前需先配置 config.xml 文件,方法如下

  • 配置示例:
  • 1.0.5版本后不用配置此config文件
<feature name="UIQiniuShortVideo">
    <param  name="iOSAppKey" value="25662805"/>
    <!-- 模块版本1.0.4之后不需要该参数 --!>
    <param  name="androidLicense" value="25662805"/>
</feature>

android编译及注意事项

  • android使用升级环境编译
  • android编译需在Android 4.3 (API 18) 及其以上
  • android从1.0.3版本开始不需要上传自定义模块了

open

打开短视频界面。 注意:如果要将视频上传至七牛云,需要配置appKey,uploadToken,domain 参数

open({params})

params

token:

  • 类型:字符串类型
  • 描述:上传视频空间 token
  • 默认:无

appKey:

  • 类型:字符串类型
  • 描述:七牛云存储appKey(该参数暂仅支持Android,iOS不需要传此参数)

uploadToken:

  • 类型:字符串类型
  • 描述:七牛云存储token

domain:

  • 类型:字符串类型
  • 描述:七牛云存储域名

storageDir:

  • 类型:字符串类型
  • 描述:视频保存路径(仅支持fs:// & 本地路径)(该参数暂仅支持Android)
  • 默认:Android系统默认保存在sdcard下的 ShortVideo目录下

cacheDir:

  • 类型:字符串类型
  • 描述:首帧缓存路径(仅支持fs:// & 本地路径)
  • 默认:fs://ShortVideo

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:,   // 布尔类型;上传是否成功
    msg:'',    // 字符串类型;上传失败的错误信息
    path:'',   // 字符串类型;保存在七牛云的存储路径
    firstFrameImgPath:'' ,// 字符串类型;视频首帧图片路径
    key:'',  //
    hash:'', //
    ext:'', //字符串类型;首帧图片的格式
    imageWidth:'', //数字类型;首帧图片的宽
    imageHeight:'', //数字类型;首帧图片的高
    fileSize:'', //数字类型;首帧图片的内存大小
}

示例代码

var UIQiniuShortVideo = api.require('UIQiniuShortVideo');
UIQiniuShortVideo.open({
                    token : ''
                        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

clearCache

清除保存在本地的所有视频文件。

clearCache()

示例代码

var UIQiniuShortVideo = api.require('UIQiniuShortVideo');
UIQiniuShortVideo.clearCache();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭录制页面

close()

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:,   //布尔类型;关闭是否成功
}

示例代码

var UIQiniuShortVideo = api.require('UIQiniuShortVideo');
UIQiniuShortVideo.close();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本