前言
所谓视频上传，是指开发者或其用户将视频文件上传到点播的视频存储中，以便进行视频处理、分发等。

一、简介

腾讯云点播支持如下几种视频上传方式：

1. 控制台上传：在点播控制台上进行操作，将本地视频上传到云点播，适用于直接管理少量视频的场景，具有方便快捷、无技术门槛的优点；
2. 服务端上传：开发者将存储在其后台服务器中的视频上传到云点播，适用于自动化、系统化的运营场景；
3. 客户端上传：终端用户将客户端本地视频上传到云点播，适用于 ugc、pgc 等场景，支持如下三端：
   • android 端上传 sdk；
   • ios 端上传 sdk；
   • web 端上传 sdk。

本文将介绍第三种视频上传方式: web客户端上传

所谓客户端视频上传，是指 app 的最终用户将本地视频上传到点播平台。客户端上传的整体流程如下图所示:

二、思路

1. 开通服务
2. 获取云 api 密钥
3. 服务端派发签名
4. 客户端集成

说明: 前2步参照腾讯云官方文档指引自己完成, 本文着重讲解后2步代码实现

三、最终效果

四、代码实现

1、服务端派发签名

首先, 为什么要这一步, 因为, 在客户端上传场景下，客户端是直接将视频文件上传到腾讯云点播，不需要由 app 服务端进行中转。因此，腾讯云点播必须对发起请求的客户端进行鉴权。但由于 secretkey 的权限过大，app 不应该将此信息泄露到客户端，否则将会造成严重的安全问题。
因此，客户端在发起上传之前，必须要到 app 的签名派发服务申请上传签名，即流程图中的第1步。

2、获取签名代码

获取签名一共只需要两个类: signature和signaturecontroller

1)、signature

package com.cn.pinliang.admin.media.upload;

import sun.misc.base64encoder;

import javax.crypto.mac;
import javax.crypto.spec.secretkeyspec;

public class signature {
    private string secretid;
    private string secretkey;
    private long currenttime;
    private int random;
    private int signvalidduration;

    private static final string hmac_algorithm = "hmacsha1";
    private static final string content_charset = "utf-8";

    public static byte[] bytemerger(byte[] byte1, byte[] byte2) {
        byte[] byte3 = new byte[byte1.length + byte2.length];
        system.arraycopy(byte1, 0, byte3, 0, byte1.length);
        system.arraycopy(byte2, 0, byte3, byte1.length, byte2.length);
        return byte3;
    }

    public string getuploadsignature() throws exception {
        string strsign;
        string contextstr = "";

        long endtime = (currenttime + signvalidduration);
        contextstr += "secretid=" + java.net.urlencoder.encode(secretid, "utf8");
        contextstr += "&currenttimestamp=" + currenttime;
        contextstr += "&expiretime=" + endtime;
        contextstr += "&random=" + random;

        try {
            mac mac = mac.getinstance(hmac_algorithm);
            secretkeyspec secretkey = new secretkeyspec(this.secretkey.getbytes(content_charset), mac.getalgorithm());
            mac.init(secretkey);

            byte[] hash = mac.dofinal(contextstr.getbytes(content_charset));
            byte[] sigbuf = bytemerger(hash, contextstr.getbytes("utf8"));
            strsign = new string(new base64encoder().encode(sigbuf).getbytes());
            strsign = strsign.replace(" ", "").replace("\n", "").replace("\r", "");
        } catch (exception e) {
            throw e;
        }
        return strsign;
    }

    public void setsecretid(string secretid) {
        this.secretid = secretid;
    }

    public void setsecretkey(string secretkey) {
        this.secretkey = secretkey;
    }

    public void setcurrenttime(long currenttime) {
        this.currenttime = currenttime;
    }

    public void setrandom(int random) {
        this.random = random;
    }

    public void setsignvalidduration(int signvalidduration) {
        this.signvalidduration = signvalidduration;
    }
}

2)、signaturecontroller

package com.cn.pinliang.admin.controller;

import com.cn.pinliang.jsonresult;
import com.cn.pinliang.admin.media.upload.signature;
import com.ctt.framework.configutil;
import com.google.common.collect.maps;
import org.springframework.stereotype.controller;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.bind.annotation.responsebody;

import java.util.map;
import java.util.random;

@controller
@requestmapping("/signature")
public class signaturecontroller{

    @requestmapping("getugcuploadsign")
    @responsebody
    public jsonresult getugcuploadsign() {
        string secretid = "your secretid";
        string secretkey = "your secretkey";

        signature sign = new signature();
        sign.setsecretid(secretid);
        sign.setsecretkey(secretkey);
        sign.setcurrenttime(system.currenttimemillis() / 1000);
        sign.setrandom(new random().nextint(java.lang.integer.max_value));
        sign.setsignvalidduration(3600 * 24 * 2);

        try {
            string signature = sign.getuploadsignature();
            map<string, string> map = maps.newhashmap();
            map.put("signature", signature);
            return jsonresult.succeed(map);
        } catch (exception e) {
            e.printstacktrace();
            return jsonresult.fail("获取签名失败");
        }
    }

}

好了, 现在可以调用getugcuploadsign获取签名了

3、客户端集成

1)、说明

说是客户端集成, 其实就是前端js+css+html实现视频的上传, 看了官方文档和github demo, 发现有一个问题, 那就是难道每次上传视频都要copy这些代码到我们自己的页面吗, 能不能抽离出单独的js直接调用就行了? 可以, 但是:

所以, 我们不能直接剥离这些js, 还得封装一下才行

2)、封装(干货才开始)

先看下经过后面代码的封装上传视频有多么简单, 真正做到一行代码解决视频加载与上传:
loadanduploadvideo('form_id', 'teachingvideo', "uploadvideo", "videofileid", 200);

• 首先, 既然要用别人的sdk, 我们得引入相关依赖才行, 在jsp页面引入:

<%--腾讯云上传视频js依赖--%>
<script src="https://cdn.jsdelivr.net/npm/es6-promise@4/dist/es6-promise.auto.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue/2.5.21/vue.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/axios/0.18.0/axios.js"></script>
<script src="https://unpkg.com/vod-js-sdk-v6"></script>
<%--上传进度div--%>
<div class="center-in-center" id="txuploadprogress" style="display: none"></div>

说明:

a. 官方文档用的是vue.js, 虽然没学过, 但好歹有点js基础, 万变不离其宗, 不会的查下相关文档就行了

b. 与官方demo上传进度有点不一样的是, 我在上传时加了一层遮罩层, 页面中心显示上传进度, 所以引入了上传进度div, 总之, 根据自己实际项目需要来

• 然后, 在你的页面嵌入:

                        <div id="uploadvideo" style="margin-left: 40px; margin-top: 20px">
                            <input type="hidden" id="teachingvideo" value="${hotproduct.teachingvideo}"/>
                            <form ref="vexample">
                                <input type="file" style="display:none;" ref="vexamplefile" @change="vexampleupload($event)" id="videofileid" accept="video/mp4"/>
                            </form>
                            <div class="btn btn-app btn-default btn-sm pr" style="width: 160px; ">
                                <i @click="vexampleadd" class="ace-icon fa fa-cloud-upload bigger-200" style="font-size: 20px">上传视频</i>
                            </div>
                        </div>

说明:
调用时指定的id与此页面元素id一一对应

• 然后, 新建js文件, 代码:

/**
 * 腾讯云视频上传
 */

var progressid = 'txuploadprogress';// 上传进度id

/**
 * 加载和上传视频: 页面初始化时调用, 可以直接通过视频url加载视频到页面
 * 除maxsize字段非必传外, 其他字段均必传, 否则后果自负
 * @param formid form表单id
 * @param name 与后端绑定的name字段, 如shortvideo字段, 此字段必须与隐藏域id字段相同, 即id name一致
 * @param uploadvideodivid 视频上传相关的div块id
 * @param videofileid 视频文件id, 此字段作用是解决vue无法再次上传相同文件的问题, 将此id值清空即可再次上传
 * @param maxsize 文件大小, m为单位, 不传表示不限制文件大小
 */
function loadanduploadvideo(formid, name, uploadvideodivid, videofileid, maxsize) {
    loadvideo(uploadvideodivid, name);
    uploadvideo(formid, name, uploadvideodivid, videofileid, maxsize)
}

/**
 * 加载视频
 * @param uploadvideodivid 将视频追加到此id后面
 * @param name 根据name获取原视频值, 因此id与name字段必须相同才能拿到旧值
 */
function loadvideo(uploadvideodivid, name) {
    var oldvideourl = $("#" + name).val();
    if (oldvideourl != null && oldvideourl != ""){
        var str = '';
        str += '<div class="video">' ;
        str += '    <video src="'+oldvideourl+'" controls="controls" >';
        str += '</div>';
        $("#" + uploadvideodivid + " .video").remove();
        $("#" + uploadvideodivid).append(str);
    }
}

/**
 * 上传视频, 腾讯云官方demo + 改造
 * @param formid
 * @param name
 * @param uploadvideodivid
 * @param videofileid
 * @param maxsize 文件大小, m为单位, 不传表示不限制文件大小
 */
function uploadvideo(formid, name, uploadvideodivid, videofileid, maxsize) {
    // 获取签名, 腾讯云要求直接上传视频的客户端必须获取签名
    function getsignature() {
        var url = "" + ctx + "signature/getugcuploadsign.action"
        return axios.post(url).then(function (response) {
            return response.data.data.signature
        })
    };
    var app = new vue({
        el: '#' + uploadvideodivid,
        data: {
            uploaderinfos: [],
        },
        created: function () {
            this.tcvod = new tcvod.default({
                getsignature: getsignature
            })
        },
        methods: {
            vexampleadd: function () {
                this.$refs.vexamplefile.click()
            },
            vexampleupload: function (event) {
                if (!checkvideo(event, maxsize, videofileid)) {
                    return;
                }
                onvideoselected()
                var self = this;
                var videofile = this.$refs.vexamplefile.files[0]
                var uploader = this.tcvod.upload({
                    videofile: videofile,
                })
                uploader.on('video_progress', function (info) {
                    uploaderinfo.progress = info.percent;
                    // 上传进度
                    var percent = math.floor(uploaderinfo.progress * 100) + '%'
                    $("#" + progressid).text("正在上传 : " + percent)
                })
                uploader.on('video_upload', function (info) {
                    uploaderinfo.isvideouploadsuccess = true;
                })
                var uploaderinfo = {
                    videoinfo: uploader.videoinfo,
                    isvideouploadsuccess: false,
                    isvideouploadcancel: false,
                    progress: 0,
                    fileid: '',
                    videourl: '',
                    cancel: function() {
                        uploaderinfo.isvideouploadcancel = true;
                        uploader.cancel()
                    },
                }
                this.uploaderinfos.push(uploaderinfo)
                uploader.done().then(function(doneresult) {
                    uploaderinfo.fileid = doneresult.fileid;
                    return doneresult.video.url;
                }).then(function (videourl) {
                    uploaderinfo.videourl = videourl
                    onvideouploaded(formid, name, videourl, videofileid, uploadvideodivid);
                })
            }
        },
    })
}

/**
 * 选择视频后显示上传进度
 */
function onvideoselected() {
    $("#" + progressid).text("正在上传 : 0%")
    $("#" + progressid).show()
    startloadding();
}

/**
 * 视频上传完成
 * @param formid
 * @param name
 * @param videourl
 * @param videofileid
 * @param uploadvideodivid
 */
function onvideouploaded(formid, name, videourl, videofileid, uploadvideodivid) {
    endloadding();
    $("#" + progressid).hide();
    layeralert("上传完成")
    // 上传完成后清空fileid, 否则vue无法再次选择此文件
    $("#" + videofileid).val('')
    // 将上传成功后的视频url追加到表单
    formappendvideo(formid, name, videourl);

    if (videourl != ""){
        var str = '';
        str += '<div class="video">';
        str += '    <video src="'+videourl+'" controls="controls" >';
        str += '</div>';
        $("#" + uploadvideodivid + " .video").remove();
        $("#" + uploadvideodivid).append(str);
    }
}

/**
 * 删除视频, 删除页面视频只需要uploadvideodivid字段即可, 但同时还应清空form表单的videourl
 * @param formid
 * @param uploadvideodivid
 * @param name
 */
function deletevideo(formid, uploadvideodivid, name) {
    $("#" + uploadvideodivid + " .video").remove();
    formappendvideo(formid, name, null);
}

/**
 * 追加视频url到form
 * @param formid
 * @param name
 * @param videourl
 */
function formappendvideo(formid, name, videourl){
    videourl = null == videourl ? '' : videourl;
    var form = $('#' + formid);
    var tmpinput = $('<input type="hidden" name="'+name+'" value="'+videourl+'" />');
    form.append(tmpinput);
}

/**
 * 校验视频格式和大小
 * @param event
 * @param maxsize 不传表示不限制文件大小
 * @returns {boolean}
 */
function checkvideo(event, maxsize, videofileid) {
    var flag = true;
    var accept = event.target.accept;
    var file = event.target.files[0];
    var type = file.type
    if(accept.indexof(type) == -1) {
        layeralert('文件格式不正确');
        $("#" + videofileid).val('')
        flag = false;
    }
    if (maxsize != undefined) {
        if(file.size > 1024 * 1024 * maxsize) {
            layeralert('文件不能大于' + maxsize + 'm');
            $("#" + videofileid).val('')
            flag = false;
        }
    }
    return flag
}

说明:
a. 代码注释足够详细了
b. 视频上传核心代码在uploadvideo方法
稍微解释下uploadvideo方法:

• 先调用signaturecontroller里面的getugcuploadsign方法获取签名
• 再通过vue定义视频文件点击、选择、上传后的事件

c. 有人会问不是上传视频吗, 为什么还有loadvideo, 因为, 编辑时进入页面不可能之前的视频就不显示吧, 所以, 初始化调用loadanduploadvideo方法时就会将原视频嵌入到页面中了
d. 本文还加了上传视频的一些限制, 比如格式、大小之类的
e. formappendvideo方法需要说明一下, 这个方法作用是上传视频后直接将视频url以name形式追加到表单元素, 这样就不用再form submit的时候再获取videourl了, 直接提交到后端, 这也是一行代码搞定视频上传的必要方法

3)、使用

上述代码就可以实现一行代码搞定视频上传加载了, 通过在页面初始化时调用loadanduploadvideo方法即可, 具体如下:
a: jsp页面引入相关vue js
b: jsp页面嵌入html
c: 新建js, 将上述js代码copy进去
d: 页面加载完毕初始化时调用:
loadanduploadvideo('form_id', 'teachingvideo', "uploadvideo", "videofileid", 200);即可

结语: 本文通过参考腾讯云点播官方文档, 实现了对视频上传和加载功能的封装, 最终能够通过调用一行代码实现功能, 由于每个项目不同, 小伙伴需要根据自己实际情况修改进行代码适配, 谢谢

如对本文有疑问， 点击进行留言回复！！