"官方文檔" 前言 所謂視頻上傳,是指開發者或其用戶將視頻文件上傳到點播的視頻存儲中,以便進行視頻處理、分發等。 一、簡介 騰訊雲點播支持如下幾種視頻上傳方式: 1. 控制臺上傳:在點播控制臺上進行操作,將本地視頻上傳到雲點播,適用於直接管理少量視頻的場景,具有方便快捷、無技術門檻的優點; 2. 服 ...
前言
所謂視頻上傳,是指開發者或其用戶將視頻文件上傳到點播的視頻存儲中,以便進行視頻處理、分發等。
一、簡介
騰訊雲點播支持如下幾種視頻上傳方式:
- 控制臺上傳:在點播控制臺上進行操作,將本地視頻上傳到雲點播,適用於直接管理少量視頻的場景,具有方便快捷、無技術門檻的優點;
- 服務端上傳:開發者將存儲在其後臺伺服器中的視頻上傳到雲點播,適用於自動化、系統化的運營場景;
- 客戶端上傳:終端用戶將客戶端本地視頻上傳到雲點播,適用於 UGC、PGC 等場景,支持如下三端:
本文將介紹第三種視頻上傳方式: Web客戶端上傳
所謂客戶端視頻上傳,是指 App 的最終用戶將本地視頻上傳到點播平臺。客戶端上傳的整體流程如下圖所示:
二、思路
- 開通服務
- 獲取雲 API 密鑰
- 服務端派發簽名
- 客戶端集成
說明: 前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 += "¤tTimeStamp=" + 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);
即可
結語: 本文通過參考騰訊雲點播官方文檔, 實現了對視頻上傳和載入功能的封裝, 最終能夠通過調用一行代碼實現功能, 由於每個項目不同, 小伙伴需要根據自己實際情況修改進行代碼適配, 謝謝