tencent cloud

对于在服务端上传视频的场景，云点播提供 C# SDK 来实现。上传流程请参见 服务端上传指引。

集成方式

通过 nuget 安装

1. 通过命令行安装：

   dotnet add package VodSDK --version 1.0.1
   

2. 通过 Visual Studio 的 nuget 包管理工具，搜索 VodSDK 并安装。

通过源码包安装

如果项目中没有使用 nuget 工具，可以直接下载源码导入项目中使用：

• 从 Github 访问
• 单击下载 C# SDK

下载最新代码，解压后安装到项目工作目录下，使用 Visual Studio 2017 打开编译。因为此 SDK 还依赖外部的包，所以需要同时安装如下 SDK：

• 云 API SDK
• 对象存储 SDK

简单上传

初始化一个上传客户端对象

使用云 API 密钥初始化 VodUploadClient 实例。

using System;
using VodSDK;
VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");

构造上传请求对象

设置媒体本地上传路径。

VodUploadRequest request = new VodUploadRequest();
request.MediaFilePath = "/data/videos/Wildlife.wmv";

调用上传

调用上传方法，传入接入点地域及上传请求。

try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // 打印媒体 FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // 业务方进行异常处理
   Console.WriteLine(e);
}

说明：

上传方法根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。

高级功能

携带封面

using System;
using VodSDK;
VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");
VodUploadRequest request = new VodUploadRequest();
request.MediaFilePath = "/data/videos/Wildlife.wmv";
request.CoverFilePath = "/data/videos/Wildlife.jpg";
try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // 打印媒体 FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // 业务方进行异常处理
   Console.WriteLine(e);
}

指定任务流

首先 创建任务流模板 并为模板命名，发起任务流时，可以使用任务流模板名设置Procedure参数，上传成功后会自动执行任务流。

using System;
using VodSDK;
VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");
VodUploadRequest request = new VodUploadRequest();
request.MediaFilePath = "/data/videos/Wildlife.wmv";
request.Procedure = "Your Procedure Name";
try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // 打印媒体 FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // 业务方进行异常处理
   Console.WriteLine(e);
}

子应用上传

传入 子应用 ID，上传成功后资源只属于具体的子应用。

using System;
using VodSDK;
VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");
VodUploadRequest request = new VodUploadRequest();
request.MediaFilePath = "/data/videos/Wildlife.wmv";
request.SubAppId = 101;
try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // 打印媒体 FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // 业务方进行异常处理
   Console.WriteLine(e);
}

指定存储地域

在 控制台 确认已经开通目标存储地域，若没有开通可以参考 上传存储设置，最后通过StorageRegion属性设置存储地域的 英文简称。

using System;
using VodSDK;
VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");
VodUploadRequest request = new VodUploadRequest();
request.MediaFilePath = "/data/videos/Wildlife.wmv";
request.StorageRegion = "ap-chongqing";
try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // 打印媒体 FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // 业务方进行异常处理
   Console.WriteLine(e);
}

接口描述

上传客户端类VodUploadClient

上传请求类VodUploadRequest

上传响应类VodUploadResponse

上传方法VodUploadClient.Upload(String region, VodUploadRequest request)

错误码表