C# 实现腾讯云点播之媒体上传常用接口

关于腾讯云点播媒体管理

开发前准备

范例运行环境

常用上传API

申请上传

确认上传

拉取上传

小结

关于腾讯云点播媒体管理

腾讯云点播（Video On Demand）服务基于多年技术积累与基础设施建设，为有音视频应用相关需求的客户提供包括音视频存储管理、音视频转码处理、音视频加速播放、音视频加密、音视频AI能力的一站式解决方案，可通过云平台进行上传后的媒资管理。

目前云点播服务使用的是 API 3.0 版本，要使用腾讯云点播 API，需要先执行以下步骤：

在腾讯云云点播控制台开通腾讯云点播（VOD）服务。
在访问管理控制台中的云 API 密钥页面里获取 appid、secretid、secretkey 内容。
调用 API 执行操作。

本文将主要介绍如何使用云点播服务之媒体上传的常用接口实现。

开发前准备

(1）调用 API 之前，需要生成 HMAC-SHA1加密返回签名，请参考如下代码：

/// HMAC-SHA1加密返回签名
<param name="secret">密钥</param>
<param name="strOrgData">源文</param>
public static string GetHmacSha1Sign(string secret, string strOrgData)
{var hmacsha1 = new HMACSHA1(Encoding.UTF8.GetBytes(secret));var dataBuffer = Encoding.UTF8.GetBytes(strOrgData);var hashBytes = hmacsha1.ComputeHash(dataBuffer);return Convert.ToBase64String(hashBytes);
}

(2）secretId 及 secretKey 的获取在后续范例中均封装为 TCAcount 类，创建及访问示例如下：

TCAcount tca = new TCAcount();
//应用ID
string secretId = tca.secretId;
//应用key
string secretKey = tca.secretKey;

(3) 用到两个时间戳函数，代码如下:

public string getTimestamp(int seconds)
{TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);return Convert.ToInt64(ts.TotalSeconds + seconds).ToString();
}
public string GetTimeStamp(DateTime dtime)
{TimeSpan tspan = dtime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, 0);return Convert.ToInt64(tspan.TotalSeconds).ToString();
}

(4) SendRequest 方法实现访问 API URL 地址并 POST 数据，以获取返回结果 Json 的功能，参考代码如下：

public static string SendRequest(string url, string completeUrl)
{ServicePointManager.SecurityProtocol = (SecurityProtocolType)192 | (SecurityProtocolType)768 | (SecurityProtocolType)3072;HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);request.Method = "POST";request.ContentType = "application/x-www-form-urlencoded";request.ProtocolVersion = HttpVersion.Version10;request.Host = url.Replace("https://", "").Replace("/", "");byte[] data = Encoding.UTF8.GetBytes(completeUrl);request.ContentLength = data.Length;Stream newStream = request.GetRequestStream();newStream.Write(data, 0, data.Length);newStream.Close();HttpWebResponse response = null;string content;try{response = (HttpWebResponse)request.GetResponse();StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);content = reader.ReadToEnd();}catch (WebException e){response = (HttpWebResponse)e.Response;using (Stream errData = response.GetResponseStream()){using (StreamReader reader = new StreamReader(errData)){content = reader.ReadToEnd();}}}return content;
}

（5）需要引用 Newtonsoft.Json.dll 动态链接库。

范例运行环境

操作系统： Windows Server 2019 DataCenter

.net版本： .netFramework4.0 或以上

开发工具：VS2019 C#

常用上传API

申请上传

ApplyUpload 方法用于申请媒体文件的上传，获取文件上传到云点播的元信息（包括上传路径、上传签名等），用于后续上传接口。其关键属性方法说明如下：

序号	参数	类型	说明
1	MediaType	string	媒体格式，包括：视频：WMV、RM、MOV、MPEG、MP4、3GP、FLV、AVI、RMVB、TS、ASF、MPG、WEBM、MKV 、M3U8、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT、OGG。音频：MP3、M4A、FLAC、OGG、WAV、RA、AAC、AMR。
2	MediaName	string	媒体名称，如 test.mp4

序号

参数

类型

说明

MediaType

string

媒体格式，包括：

视频：WMV、RM、MOV、MPEG、MP4、3GP、FLV、AVI、RMVB、TS、ASF、MPG、WEBM、MKV 、M3U8、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT、OGG。

音频：MP3、M4A、FLAC、OGG、WAV、RA、AAC、AMR。

MediaName

string

媒体名称，如 test.mp4

实现代码如下：

public string ApplyUpload(string MediaType, string MediaName)
{string medianame = "";if (MediaName != ""){medianame = "&MediaName=" + MediaName;}TCAcount tca = new TCAcount("");//请求地址string settingUrl = "https://vod.tencentcloudapi.com/";//应用IDstring secretId = tca.secretId;//应用keystring secretKey = tca.secretKey;//时间戳string timesTamp = GetTimeStamp();//Noncevar nonce = new Random().Next(10000, 99999);//拼接参数string paramsStr = string.Format(@"Action=ApplyUpload{4}&MediaType={3}&Nonce={0}&Region=ap-beijing&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp, MediaType,medianame);//生成签名参数//                      string requestText = settingUrl + "?" + paramsStr;string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);paramsStr = string.Format(@"Action=ApplyUpload{5}&MediaType={4}&Nonce={0}&Region=ap-beijing&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp, MediaType,medianame);string resultStr = SendRequest(settingUrl, paramsStr);if (resultStr.IndexOf("VodSessionKey") != -1){Newtonsoft.Json.Linq.JObject jsonObj = Newtonsoft.Json.Linq.JObject.Parse(resultStr);return jsonObj["Response"]["VodSessionKey"].ToString();}return "";
} //applyupload

确认上传

CommitUpload 方法用于确认媒体文件上传到腾讯云点播的结果，并存储媒体信息，返回文件的播放地址和文件 ID，其关键属性方法说明如下：

序号	参数	类型	说明
1	VodSessionKey	string	点播会话，取申请上传接口的 ApplyUpload 方法返回值 VodSessionKey。

实现代码如下：

public string CommitUpload(string VodSessionKey)
{TCAcount tca = new TCAcount("");//请求地址string settingUrl = "https://vod.tencentcloudapi.com/";//应用IDstring secretId = tca.secretId;//应用keystring secretKey = tca.secretKey;//时间戳string timesTamp = GetTimeStamp();//Noncevar nonce = new Random().Next(10000, 99999);//拼接参数string paramsStr = string.Format(@"Action=CommitUpload&Nonce={0}&Region=ap-beijing&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17&VodSessionKey={3}",nonce, secretId, timesTamp, VodSessionKey);//生成签名参数//                      string requestText = settingUrl + "?" + paramsStr;string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);paramsStr = string.Format(@"Action=CommitUpload&Nonce={0}&Region=ap-beijing&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17&VodSessionKey={4}",nonce, secretId, signText, timesTamp, VodSessionKey);string resultStr = SendRequest(settingUrl, paramsStr);return resultStr;
} //CommitUpload

拉取上传

PullUpload 方法用于将一个网络上的视频拉取到云点播平台，其关键属性方法说明如下：

序号	参数	类型	说明
1	MediaUrl	string	要拉取的媒体 URL，暂不支持拉取 Dash 格式（可以支持 HLS）。支持的扩展名如下：视频：WMV、RM、MOV、MPEG、MP4、3GP、FLV、AVI、RMVB、TS、ASF、MPG、WEBM、MKV 、M3U8、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT、OGG。音频：MP3、M4A、FLAC、OGG、WAV、RA、AAC、AMR。请确保媒体 URL 可以访问，示例：http://www.test.com/test.mp4

序号

参数

类型

说明

MediaUrl

string

要拉取的媒体 URL，暂不支持拉取 Dash 格式（可以支持 HLS）。
支持的扩展名如下：

视频：WMV、RM、MOV、MPEG、MP4、3GP、FLV、AVI、RMVB、TS、ASF、MPG、WEBM、MKV 、M3U8、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT、OGG。

音频：MP3、M4A、FLAC、OGG、WAV、RA、AAC、AMR。

请确保媒体 URL 可以访问，示例：http://www.test.com/test.mp4

实现代码如下：

public string PullUpload(string MediaUrl)
{TCAcount tca = new TCAcount("");//请求地址string settingUrl = "https://vod.tencentcloudapi.com/";//应用IDstring secretId = tca.secretId;//应用keystring secretKey = tca.secretKey;//时间戳string timesTamp = GetTimeStamp();//Noncevar nonce = new Random().Next(10000, 99999);//拼接参数string paramsStr = string.Format(@"Action=PullUpload&MediaUrl={3}&Nonce={0}&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp, MediaUrl);//生成签名参数//                      string requestText = settingUrl + "?" + paramsStr;string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);paramsStr = string.Format(@"Action=PullUpload&MediaUrl={4}&Nonce={0}&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp, MediaUrl);string resultStr = SendRequest(settingUrl, paramsStr);if (resultStr.IndexOf("TaskId") != -1){Newtonsoft.Json.Linq.JObject jsonObj = Newtonsoft.Json.Linq.JObject.Parse(resultStr);return jsonObj["Response"]["TaskId"].ToString();}return "";
} //pullupload