tencent cloud

VOD provides an SDK for C# for uploading videos from a server. For more information on the upload process, please see Upload Videos from Server.

Integration Steps

Installing via NuGet

1. Install on the command line:

   dotnet add package VodSDK --version 1.0.1
   

2. Search for VodSDK in Visual Studio's NuGet package manager and install it.

Installing using source package

If your project does not have NuGet, you can directly download the source code and import it into the project:

• Access from GitHub
• Click here to download the SDK for C#

Download the latest code, decompress and install it in your project's working directory, and open it with Visual Studio 2017 for compiling. As this SDK also depends on external packages, the following SDKs need to be installed too:

• TencentCloud API SDK
• COS SDK

Simple Upload

Initializing upload client object

Initialize a VodUploadClient instance with a TencentCloud API key.

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

Constructing upload request object

Set the local media upload path.

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

Calling upload

Call the upload method and pass in the access point region and upload request.

try 
{
   VodUploadResponse response = client.Upload("ap-guangzhou", request);
   // Print the media FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // The business team performs troubleshooting
   Console.WriteLine(e);
}

Note：

The upload method automatically selects simple upload or multipart upload based on the file size, eliminating your need to take care of every step in multipart upload.

Advanced Features

Uploading a cover

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);
   // Print the media FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // The business team performs troubleshooting
   Console.WriteLine(e);
}

Specifying a task flow

First, create a task flow template and name it. When initiating the task flow, you can set the Procedure parameter with the task flow template name, and the task flow will be executed automatically upon upload success.

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);
   // Print the media FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // The business team performs troubleshooting
   Console.WriteLine(e);
}

Uploading to a subapplication

Pass in a subapplication ID. After the upload is successful, the resource will belong only to the specified subapplication.

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);
   // Print the media FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // The business team performs troubleshooting
   Console.WriteLine(e);
}

Specifying a storage region

In the console, confirm that the target storage region has been activated. If not, you can do so as instructed in Upload Storage Settings and then set the abbreviation of the storage region through the StorageRegion attribute.

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);
   // Print the media FileId
   Console.WriteLine(response.FileId);
} 
catch (Exception e) 
{
   // The business team performs troubleshooting
   Console.WriteLine(e);
}

API Description

Upload client class VodUploadClient

Upload request class VodUploadRequest

Upload response class VodUploadResponse

Upload method VodUploadClient.Upload(String region, VodUploadRequest request)

Error Codes