签名派发

最近更新时间:2019-04-18 17:49:55

客户端视频上传,是指 App 的最终用户将本地视频直接上传到腾讯云点播。客户端上传的详细介绍请参考点播客户端上传指引,本文将以最简洁的方式介绍客户端上传的签名生成方法。

总体介绍

客户端上传的整体流程如下图所示:

图片描述

为了支持客户端上传,开发者需要搭建两个后台服务:签名派发服务和事件通知接收服务。

  • 客户端首先向签名派发服务请求上传签名;
  • 签名派发服务校验该用户是否有上传权限,若校验通过,则生成签名并下发;否则返回错误码,上传流程结束;
  • 客户端拿到签名后使用短视频 SDK 中集成的上传功能来上传视频;
  • 上传完成后,点播后台会发送上传完成事件通知给开发者的事件通知接收服务;
  • 如果签名派发服务在签名中指定了视频处理任务流,点播服务会在视频上传完成后根据指定流程自动进行视频处理。短视频场景下的视频处理一般为 AI 鉴黄
  • 视频处理完成之后,点播后台会发送任务流状态变更事件通知给开发者的事件通知接收服务;

至此整个视频上传-处理流程结束。

签名生成

有关客户端上传签名的详细介绍请参考点播客户端上传签名

签名派发服务实现示例

/**
 * 计算签名
 */
function createFileUploadSignature({ timeStamp = 86400, procedure = '', classId = 0, oneTimeValid = 0, sourceContext = '' }) {
    // 确定签名的当前时间和失效时间
    let current = parseInt((new Date()).getTime() / 1000)
    let expired = current + timeStamp;  // 签名有效期:1天
    // 向参数列表填入参数
    let arg_list = {
        //required
        secretId: this.conf.SecretId,
        currentTimeStamp: current,
        expireTime: expired,
        random: Math.round(Math.random() * Math.pow(2, 32)),
        //opts
        procedure,
        classId,
        oneTimeValid,
        sourceContext
    }
    // 计算签名
    let orignal = querystring.stringify(arg_list);
    let orignal_buffer = new Buffer(orignal, "utf8");
    let hmac = crypto.createHmac("sha1", this.conf.SecretKey);
    let hmac_buffer = hmac.update(orignal_buffer).digest();
    let signature = Buffer.concat([hmac_buffer, orignal_buffer]).toString("base64");
    return signature;
}
/**
 * 响应签名请求
 */
function getUploadSignature(req, res) {
    res.json({
        code: 0,
        message: 'ok',
        data: {
            //上传时指明模版参数与任务流
            signature: gVodHelper.createFileUploadSignature({ procedure: 'QCVB_SimpleProcessFile({1,1,1,1})' })
        }
    });
}