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

2024-05-27 14:44
文章标签 c# 实现 接口 媒体 管理 常用 .net 腾讯 netcore 点播

本文主要是介绍C# 实现腾讯云点播之媒体管理常用接口，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

目录

关于腾讯云点播媒体管理

开发前准备

范例运行环境

常用媒体管理API

删除媒体

禁播媒体

获取媒体详细信息

查询媒体

小结

关于腾讯云点播媒体管理

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

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

  1. 在腾讯云 云点播控制台 开通腾讯云点播（VOD）服务。
  2. 在访问管理控制台中的 云 API 密钥 页面里获取 appid、secretid、secretkey 内容。
  3. 调用 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

删除媒体

DeleteMedia 方法用于删除媒体及其对应的视频处理文件（原始文件、如转码视频、雪碧图、截图、微信发布视频等），可单独删除指定 ID 的视频文件下的原文件、转码视频、微信发布视频等（注意：原文件删除后，无法发起转码、微信发布等任何视频处理操作），方法返回字符串，为空则表示成功，否则返回 “Error”，其关键属性方法说明如下：

序号参数类型说明
1FileIdstring媒体文件的唯一标识。如：7447398156998994860

实现代码如下：

public string DeleteMedia(string FileId)
{ArrayList data = new ArrayList();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=DeleteMedia&FileId={3}&Nonce={0}&Region=ap-guangzhou&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp, FileId);//生成签名参数string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);string text = HttpUtility.UrlEncode(FileId, Encoding.UTF8);paramsStr = string.Format(@"Action=DeleteMedia&FileId={4}&Nonce={0}&Region=ap-guangzhou&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp, text);string resultStr = SendRequest(settingUrl, paramsStr);if (resultStr.IndexOf("Error") != -1){return "Error";}return "";
} //delete media

禁播媒体

ForbidMediaDistribution 方法对媒体禁播，除了点播控制台可以预览，其他场景访问视频各种资源的 URL（原始文件、转码输出文件、截图等）均会返回 403，禁播/解禁操作全网生效时间约 5~10 分钟，该方法返回 ArrayList，列表返回的是不成功或不存在的fileid，如果为0则表示禁播都已成功，其关键属性方法说明如下：

序号参数类型说明
1FileIdsstring要提交的禁播或恢复播放的 FileId 列表，每次最多可提交 20 个，以逗号进行分隔
示例值："7447398156998994860，7447398156998994861"
2Stopbool为 true 则表示禁播，为 false 则表示恢复播放

实现代码如下：

//禁播媒体，列表以逗号分隔，stop为true,则禁播，反之恢复，该操作可能有5到10分钟延迟，列表返回的是不成功或不存在的fileid，如果为0则都成功
public ArrayList ForbidMediaDistribution(string FileIds,bool Stop)
{ArrayList data = new ArrayList();string Operation = Stop == true ? "forbid" : "recover";if (FileIds == ""){return data;}string[] fs = FileIds.Split(',');string paras = "";for (int p = 0; p < fs.Length; p++){paras += "&FileIds." + p + "=" + fs[p];}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=ForbidMediaDistribution{3}&Nonce={0}&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp, paras);//生成签名参数string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);paramsStr = string.Format(@"Action=ForbidMediaDistribution{4}&Nonce={0}&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp, paras);string resultStr = SendRequest(settingUrl, paramsStr);if (resultStr.IndexOf("NotExistFileIdSet") != -1){Newtonsoft.Json.Linq.JObject jsonObj = Newtonsoft.Json.Linq.JObject.Parse(resultStr);int total = jsonObj["Response"]["NotExistFileIdSet"].Count();for (int i = 0; i < total; i++){data.Add(jsonObj["Response"]["NotExistFileIdSet"][i].ToString());}return data;}return data;
} //stop media

获取媒体详细信息

DescribeMediaInfos 方法可以获取多个媒体文件的多种信息，每一个媒体文件表示一个MediaFile 类，该类的说明和实现代码如下：

public  class MediaFile
{public string FileId = "";    //FileIDpublic string MediaUrl = "";  //媒体播放URLpublic string Name = "";     //媒体名称public string Type = "";     //媒体分类public string CreateTime = "";   //媒体创建时间public string ExpireTime = "";   //媒体有效时间public string Vid = "";    //媒体Vidpublic string Size="";   //媒体文件尺寸public string Duration="";   //媒体时间public string Bitrate="";   //媒体比特率public string Height="";   //媒体高像素public string Width="";   //媒体宽像素public string Rotate = "";  //媒体旋转角度public MediaFile(){}
}

DescribeMediaInfos方法的关键属性方法说明如下：

序号参数类型说明
1FileIdsstring

要获以详情的 FileId 列表，每次最多可提交 20 个，以逗号进行分隔
示例值："7447398156998994860，7447398156998994861"

实现代码如下：

public ArrayList DescribeMediaInfos(string FileIds)
{ArrayList data = new ArrayList();if (FileIds == ""){return data;}string[] fs=FileIds.Split(',');string paras = "";for(int p=0;p<fs.Length;p++){paras += "&FileIds."+p+"=" + fs[p];}TCAcount tca = new TCAcount("turing");//请求地址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=DescribeMediaInfos{3}&Nonce={0}&Region=ap-guangzhou&SecretId={1}&SignatureMethod=HmacSHA1&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp, paras);//生成签名参数string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);paramsStr = string.Format(@"Action=DescribeMediaInfos{4}&Nonce={0}&Region=ap-guangzhou&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp,paras);string resultStr = SendRequest(settingUrl, paramsStr);if (resultStr.IndexOf("MetaData") != -1){Newtonsoft.Json.Linq.JObject jsonObj = Newtonsoft.Json.Linq.JObject.Parse(resultStr);//"Response":{"MediaInfoSet":[],"TotalCount":0, "RequestId":"85f181fc-d76f-42bb-82d8-7ac4d5ff432a"}}int total = jsonObj["Response"]["MediaInfoSet"].Count();for (int i = 0; i < total; i++){MediaFile mf = new MediaFile();try{mf.FileId = jsonObj["Response"]["MediaInfoSet"][i]["FileId"].ToString();mf.MediaUrl = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["MediaUrl"].ToString();mf.Name = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Name"].ToString();mf.Type = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Type"].ToString();mf.Vid = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Vid"].ToString();mf.CreateTime = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["CreateTime"].ToString();mf.ExpireTime = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["ExpireTime"].ToString();mf.Size = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Size"].ToString();mf.Duration = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Duration"].ToString();mf.Bitrate = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Bitrate"].ToString();mf.Height = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Height"].ToString();mf.Width = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Width"].ToString();mf.Rotate = jsonObj["Response"]["MediaInfoSet"][i]["MetaData"]["Rotate"].ToString();data.Add(mf);}catch (Exception e) { }}return data;}return data;
} //detail media

查询媒体

SearchMedia 方法可对已上传的媒体列表进行查询，可以获取多个媒体文件的多种信息，每一个媒体文件表示一个MediaFile 类，类的设计请参照上节获取媒体详细信息，SearchMedia 方法返回 ArrayList，列表返回的查询到的 MediaFile 类，其关键属性方法说明如下：

序号参数类型说明
1SearchTextstring搜索文本，模糊匹配媒体文件名称或描述信息，匹配项越多，匹配度越高，排序越优先。长度限制：64个字符。
2StartTimestring创建时间的开始时间，大于等于开始时间。格式按照 ISO 8601标准表示，示例值：2020-09-07T00:00:00+08:00
3EndTimestring创建时间的结束时间，小于等于结束时间。格式按照 ISO 8601标准表示，示例值：2020-09-09T00:00:00+08:00

实现代码如下：

public ArrayList SearchMedia(string SearchText)
{return SearchMedia(SearchText, "", "");
}
public ArrayList SearchMedia(string SearchText, string StartTime,string EndTime)
{string starttime = "";if (StartTime != ""){starttime = "&StartTime=" + StartTime;}string endtime = "";if (EndTime != ""){endtime = "&EndTime=" + EndTime;}ArrayList data = new ArrayList();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=SearchMedia{4}&Limit=5000&Nonce={0}&Region=ap-guangzhou&SecretId={1}&SignatureMethod=HmacSHA1{5}&Text={3}&Timestamp={2}&Version=2018-07-17",nonce, secretId, timesTamp,SearchText,endtime,starttime);//生成签名参数string requestText = "POST" + settingUrl.Replace("https://", "") + "?" + paramsStr;//获得请求签名string signText = GetHmacSha1Sign(secretKey, requestText);//这里一定要进行URL编码，不然调用API会报错signText = HttpUtility.UrlEncode(signText, Encoding.UTF8);string  text = HttpUtility.UrlEncode(SearchText, Encoding.UTF8);paramsStr = string.Format(@"Action=SearchMedia{5}&Limit=5000&Nonce={0}&Region=ap-guangzhou&SecretId={1}&Signature={2}&SignatureMethod=HmacSHA1{6}&Text={4}&Timestamp={3}&Version=2018-07-17",nonce, secretId, signText, timesTamp, text,endtime,starttime);string resultStr = SendRequest(settingUrl, paramsStr);ResultJson = resultStr;if (resultStr.IndexOf("TotalCount") != -1){Newtonsoft.Json.Linq.JObject jsonObj = Newtonsoft.Json.Linq.JObject.Parse(resultStr);int total = int.Parse(jsonObj["Response"]["TotalCount"].ToString());for (int i = 0; i < total; i++){MediaFile mf = new MediaFile();try{mf.FileId = jsonObj["Response"]["MediaInfoSet"][i]["FileId"].ToString();mf.MediaUrl = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["MediaUrl"].ToString();mf.Name = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Name"].ToString();mf.Type = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Type"].ToString();mf.Vid = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["Vid"].ToString();mf.CreateTime = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["CreateTime"].ToString();mf.ExpireTime = jsonObj["Response"]["MediaInfoSet"][i]["BasicInfo"]["ExpireTime"].ToString();data.Add(mf);}catch (Exception e){   }}return data;}return data;
} //search media

请注意 SearchMedia 方法 最多返回5000个查询结果，而且在查询时请尽量提供查询关键字。开始时间和结束时间可以为空字符串，这里用到了一次重载。 

小结

腾讯云点播服务 API 提供了非常丰富与完善的管理功能列表，在这里我们仅是以满足自身应用需要而提取的常用媒体上传管理功能，更多详情请参照如下链接：

https://cloud.tencent.com/document/product/266/31753

本文代码仅供您参考使用，您可以参照官方文档开发出更加贴合自身需求的应用，感谢您的阅读，希望本文能够对您有所帮助。

这篇关于C# 实现腾讯云点播之媒体管理常用接口的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1007772。

相关文章

python使用watchdog实现文件资源监控

python使用watchdog实现文件资源监控

《python使用watchdog实现文件资源监控》watchdog支持跨平台文件资源监控,可以检测指定文件夹下文件及文件夹变动,下面我们来看看Python如何使用watchdog实现文件资源监控吧... python文件监控库watchdogs简介随着Python在各种应用领域中的广泛使用，其生态环境也
阅读更多...
el-select下拉选择缓存的实现

el-select下拉选择缓存的实现

《el-select下拉选择缓存的实现》本文主要介绍了在使用el-select实现下拉选择缓存时遇到的问题及解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的... 目录项目场景：问题描述解决方案：项目场景：从左侧列表中选取字段填入右侧下拉多选框，用户可以对右侧
阅读更多...
Python pyinstaller实现图形化打包工具

Python pyinstaller实现图形化打包工具

《Pythonpyinstaller实现图形化打包工具》：本文主要介绍一个使用PythonPYQT5制作的关于pyinstaller打包工具,代替传统的cmd黑窗口模式打包页面,实现更快捷方便的... 目录1.简介2.运行效果3.相关源码1.简介一个使用python PYQT5制作的关于pyinstall
阅读更多...
使用Python实现大文件切片上传及断点续传的方法

使用Python实现大文件切片上传及断点续传的方法

《使用Python实现大文件切片上传及断点续传的方法》本文介绍了使用Python实现大文件切片上传及断点续传的方法,包括功能模块划分（获取上传文件接口状态、临时文件夹状态信息、切片上传、切片合并）、整... 目录概要整体架构流程技术细节获取上传文件状态接口获取临时文件夹状态信息接口切片上传功能文件合并功能小
阅读更多...
python实现自动登录12306自动抢票功能

python实现自动登录12306自动抢票功能

《python实现自动登录12306自动抢票功能》随着互联网技术的发展,越来越多的人选择通过网络平台购票,特别是在中国,12306作为官方火车票预订平台,承担了巨大的访问量,对于热门线路或者节假日出行... 目录一、遇到的问题？二、改进三、进阶–展望总结一、遇到的问题？1.url-正确的表头：就是首先ur
阅读更多...
C#实现文件读写到SQLite数据库

C#实现文件读写到SQLite数据库

《C#实现文件读写到SQLite数据库》这篇文章主要为大家详细介绍了使用C#将文件读写到SQLite数据库的几种方法,文中的示例代码讲解详细,感兴趣的小伙伴可以参考一下... 目录1. 使用 BLOB 存储文件2. 存储文件路径3. 分块存储文件《文件读写到SQLite数据库China编程的方法》博客中，介绍了文
阅读更多...
Redis主从复制实现原理分析

Redis主从复制实现原理分析

《Redis主从复制实现原理分析》Redis主从复制通过Sync和CommandPropagate阶段实现数据同步,2.8版本后引入Psync指令,根据复制偏移量进行全量或部分同步,优化了数据传输效率... 目录Redis主DodMIK从复制实现原理实现原理Psync: 2.8版本后总结Redis主从复制实
阅读更多...
JAVA利用顺序表实现“杨辉三角”的思路及代码示例

JAVA利用顺序表实现“杨辉三角”的思路及代码示例

《JAVA利用顺序表实现“杨辉三角”的思路及代码示例》杨辉三角形是中国古代数学的杰出研究成果之一,是我国北宋数学家贾宪于1050年首先发现并使用的,：本文主要介绍JAVA利用顺序表实现杨辉三角的思... 目录一：“杨辉三角”题目链接二：题解代码：三：题解思路：总结一：“杨辉三角”题目链接题目链接：点击这里
阅读更多...
基于Python实现PDF动画翻页效果的阅读器

基于Python实现PDF动画翻页效果的阅读器

《基于Python实现PDF动画翻页效果的阅读器》在这篇博客中,我们将深入分析一个基于wxPython实现的PDF阅读器程序,该程序支持加载PDF文件并显示页面内容,同时支持页面切换动画效果,文中有详... 目录全部代码代码结构初始化 UI 界面加载 PDF 文件显示 PDF 页面页面切换动画运行效果总结主
阅读更多...
使用C#如何创建人名或其他物体随机分组

使用C#如何创建人名或其他物体随机分组

《使用C#如何创建人名或其他物体随机分组》文章描述了一个随机分配人员到多个团队的代码示例,包括将人员列表随机化并根据组数分配到不同组,最后按组号排序显示结果... 目录C#创建人名或其他物体随机分组此示例使用以下代码将人员分配到组代码首先将lstPeople ListBox总结C#创建人名或其他物体随机分组
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2