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

初九之潜龙勿用

发布于 2024-06-20 05:31:46

30100

代码可运行

文章被收录于专栏：技术文章技术文章

运行总次数：0

代码可运行

关于腾讯云点播媒体管理

腾讯云点播（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

实现代码如下：

public string ApplyUpload(string MediaType, string MediaName)
{
                string medianame = "";
                if (MediaName != "")
                {
                    medianame = "&MediaName=" + MediaName;
                }
                TCAcount tca = new TCAcount("");
                //请求地址
                string settingUrl = "https://vod.tencentcloudapi.com/";
                //应用ID
                string secretId = tca.secretId;
                //应用key
                string secretKey = tca.secretKey;
                //时间戳
                string timesTamp = GetTimeStamp();
                //Nonce
                var 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/";
                //应用ID
                string secretId = tca.secretId;
                //应用key
                string secretKey = tca.secretKey;
                //时间戳
                string timesTamp = GetTimeStamp();
                //Nonce
                var 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

实现代码如下：

public string PullUpload(string MediaUrl)
{
                TCAcount tca = new TCAcount("");
                //请求地址
                string settingUrl = "https://vod.tencentcloudapi.com/";
                //应用ID
                string secretId = tca.secretId;
                //应用key
                string secretKey = tca.secretKey;
                //时间戳
                string timesTamp = GetTimeStamp();
                //Nonce
                var 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