签名派发

最近更新时间:2020-10-19 15:43:31

客户端视频上传,是指 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({})
        }
    });
}
目录