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。

相关文章

如何用java对接微信小程序下单后的发货接口

如何用java对接微信小程序下单后的发货接口

《如何用java对接微信小程序下单后的发货接口》：本文主要介绍在微信小程序后台实现发货通知的步骤,包括获取Access_token、使用RestTemplate调用发货接口、处理AccessTok... 目录配置参数 调用代码获取Access_token调用发货的接口类注意点总结配置参数 首先需要获取Ac
阅读更多...
Java的volatile和sychronized底层实现原理解析

Java的volatile和sychronized底层实现原理解析

《Java的volatile和sychronized底层实现原理解析》文章详细介绍了Java中的synchronized和volatile关键字的底层实现原理,包括字节码层面、JVM层面的实现细节,以... 目录1. 概览2. Synchronized2.1 字节码层面2.2 JVM层面2.2.1 ente
阅读更多...
讯飞webapi语音识别接口调用示例代码(python)

讯飞webapi语音识别接口调用示例代码(python)

《讯飞webapi语音识别接口调用示例代码(python)》：本文主要介绍如何使用Python3调用讯飞WebAPI语音识别接口,重点解决了在处理语音识别结果时判断是否为最后一帧的问题,通过运行代... 目录前言一、环境二、引入库三、代码实例四、运行结果五、总结前言基于python3 讯飞webAPI语音
阅读更多...
MyBatis-Plus中Service接口的lambdaUpdate用法及实例分析

MyBatis-Plus中Service接口的lambdaUpdate用法及实例分析

《MyBatis-Plus中Service接口的lambdaUpdate用法及实例分析》本文将详细讲解MyBatis-Plus中的lambdaUpdate用法,并提供丰富的案例来帮助读者更好地理解和应... 目录深入探索MyBATis-Plus中Service接口的lambdaUpdate用法及示例案例背景
阅读更多...
Linux下修改hostname的三种实现方式

Linux下修改hostname的三种实现方式

《Linux下修改hostname的三种实现方式》：本文主要介绍Linux下修改hostname的三种实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录linux下修改ho编程stname三种方式方法1：修改配置文件方法2：hFvEWEostnamectl命
阅读更多...
Java实现数据库图片上传功能详解

Java实现数据库图片上传功能详解

《Java实现数据库图片上传功能详解》这篇文章主要为大家详细介绍了如何使用Java实现数据库图片上传功能,包含从数据库拿图片传递前端渲染,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1、前言2、数据库搭建&nbsChina编程p; 3、后端实现将图片存储进数据库4、后端实现从数据库取出图片给前端5、前端拿到
阅读更多...
Java实现将byte[]转换为File对象

Java实现将byte[]转换为File对象

《Java实现将byte[]转换为File对象》这篇文章将通过一个简单的例子为大家演示Java如何实现byte[]转换为File对象,并将其上传到外部服务器,感兴趣的小伙伴可以跟随小编一起学习一下... 目录前言1. 问题背景2. 环境准备3. 实现步骤3.1 从 URL 获取图片字节数据3.2 将字节数组
阅读更多...
Win32下C++实现快速获取硬盘分区信息

Win32下C++实现快速获取硬盘分区信息

《Win32下C++实现快速获取硬盘分区信息》这篇文章主要为大家详细介绍了Win32下C++如何实现快速获取硬盘分区信息,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 实现代码CDiskDriveUtils.h#pragma once #include <wtypesbase
阅读更多...
Nginx实现前端灰度发布

Nginx实现前端灰度发布

《Nginx实现前端灰度发布》灰度发布是一种重要的策略,它允许我们在不影响所有用户的情况下,逐步推出新功能或更新,通过灰度发布,我们可以测试新版本的稳定性和性能,下面就来介绍一下前端灰度发布的使用,感... 目录前言一、基于权重的流量分配二、基于 Cookie 的分流三、基于请求头的分流四、基于请求参数的分
阅读更多...
Python Excel实现自动添加编号

Python Excel实现自动添加编号

《PythonExcel实现自动添加编号》这篇文章主要为大家详细介绍了如何使用Python在Excel中实现自动添加编号效果,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1、背景介绍2、库的安装3、核心代码4、完整代码1、背景介绍简单的说，就是在Excel中有一列h=会有重复
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2