txShortVideo

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

概述

短视频

近年来,短视频行业发展极为迅速,凭借其创意玩法以及新鲜的视频内容成为继直播之后的新风口。为了满足开发者快速创建短视频应用的需求,腾讯云点播推出了短视频一站式解决方案,覆盖了视频生成、上传、处理、分发和播放在内的各个环节,帮助用户以最快速度实现短视频应用的上线。

短视频(UserGeneratedShortVideo)服务:基于快速上传、转码、存储等强大云端能力,集成采集、剪接、特效、分享、播放等客户端组件,再整合腾讯的 IM、社交、用户画像等数据,令开发者可以聚焦于业务本身,轻松制作出基于移动端的短视频内容业务。

购买说明 腾讯云短视频 SDK,推荐配合腾讯云点播服务使用,您需要开通腾讯云点播服务,并购买点播加速资源包精简版、旗舰版-2或旗舰版-3,获得短视频 SDK License为期一年的使用权限。具体信息请查看:产品简介 购买流程

txShortVideo 模块概述

本模块封装了腾讯短视频SDK中的录制、编辑、美颜、特效等功能。使用模块之前请先申请License。License申请 注意:该模块只封装了精简版和基础版的SDK,若长期使用该模块的话,请申请Licence为精简版和基础版的,因为不同版本SDK需要搭配不同版本的License才能使用

小视频样式如下:

模块接口

setLicence

设置授权

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

params

licenceURL:

licenceKey:

callback(ret, err)(android无返回信息)

ret:

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

err:

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

示例代码

var txShortVideo = api.require('txShortVideo');
txShortVideo.setLicence({
    licenceURL : 'http://license.vod2.myqcloud.com/license/v1/TXUgcSDK.licence',
    licenceKey : '0a8ee791929052b2dce775c308e'
},function(ret, err){
    alert(JSON.stringify(ret) +" "+ JSON.stringify(err));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getLicence

获取授权信息

getLicence(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,   //布尔型;true
    licence : '',  //sdk返回的授权信息字符串
}

示例代码

var txShortVideo = api.require('txShortVideo');
txShortVideo.getLicence(function(ret, err){
    alert(JSON.stringify(ret));
});

可用性

iOS

可提供的1.0.0及更高版本

videoRecord

短视频录制

videoRecord({params}, callback(ret))

params

videoResolution:

  • 类型:数字
  • 描述:(可选项)录制分辨率
  • 默认值:2
  • 取值范围:
    • 0 表示 360P 分辨率
    • 1 表示 540P 分辨率
    • 2 表示 720P 分辨率

videoBitratePIN:

  • 类型:数字
  • 描述:(可选项)自定义码率 建议值:600~12000 (SDK上限不再做限制) 单位kbps/s,这里需要注意的是,这里设置的码率只是给编码器一个参考值,实际出来视频的码率是会在这个参考值上下波动的(
  • 默认值:9600

videoFPS:

  • 类型:数字
  • 描述:(可选项)帧率 (范围:15-30)。
  • 默认值:20

gop:

  • 类型:数字
  • 描述:(可选项)关键帧间隔 (范围:1-10)。
  • 默认值:3

logo:

  • 类型:字符串
  • 描述:(可选项)视频尾部水印logo( ios视频拍摄完成后,预览以及保存后的水印会一直存在)(支持fs:// widget://路径)。

minDuration:

  • 类型:数字
  • 描述:(可选项)视频最短时长(秒)。
  • 默认值:2

maxDuration:

  • 类型:数字
  • 描述:(可选项)视频最长时间(秒)。
  • 默认值:16

isFront:

  • 类型:布尔
  • 描述:(可选项)是否前置摄像头 (true 前置 fasle 后置)
  • 默认值:true

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true,      //布尔型;true
    filePath : '' ,    //字符串类型;视频路径
    imagePath : '',    //字符串类型;视频封面
    duration:15        //数字类型;视频时间
    photoPath:'',      //字符串类型:拍照图片路径
}

示例代码

var txShortVideo = api.require('txShortVideo');
txShortVideo.videoRecord({
    recordResolution : 2,
    videoBitratePIN : 9600,
    videoFPS : 20,
    gop : 5,
    minDuration : 2,
    maxDuration : 16,
    isFront : true,
}, function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本