tencent cloud

Video on Demand

ドキュメントVideo on Demand開発ガイドメディアアップロードサーバーからのアップロードC# SDK

C# SDK

PDF
フォーカスモード
フォントサイズ
最終更新日: 2023-10-26 17:32:09
サーバーでのビデオアップロードのシナリオを実現させるために、VODでは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を同時にインストールする必要があります。
Tencent Cloud API SDK
Cloud Object Storage SDK

シンプルなアップロード

アップロードクライアントオブジェクトの初期化

Tencent Cloud 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
属性名
属性説明
タイプ
入力必須
secretId
Tencent Cloud APIキーID。
String
はい
secretKey
Tencent Cloud API Key。
String
はい
アップロードリクエストクラスVodUploadRequest
属性名
属性説明
タイプ
入力必須
MediaFilePath
アップロード予定のメディアファイルパス。ローカルパスにする必要があります。URLはサポートしていません。
String
はい
SubAppId
VOD サブアプリケーションID。サブアプリケーションの中のリソースにアクセスしたい場合は、このフィールドにサブアプリケーションIDを入力します。アクセスしない場合、このフィールドは入力不要です。
Integer
いいえ
MediaType
アップロード予定のメディアファイルタイプ。選択可能なタイプの詳細は、ビデオアップロードの概要をご参照ください。MediaFilePathに拡張子が付いている場合は入力不要です。
String
いいえ
MediaName
アップロード後のメディアの名前。入力しない場合は、デフォルトでMediaFilePathのファイル名を採用します。
String
いいえ
CoverFilePath
アップロード予定のカバーファイルパス。ローカルパスにする必要があります。URLはサポートしていません。
String
いいえ
CoverType
アップロード予定のメディアファイルタイプ。選択可能なタイプの詳細は、ビデオアップロードの概要をご参照ください。CoverFilePathに拡張子が付いている場合は入力不要です。
String
いいえ
Procedure
アップロード後に自動的に実行させたいタスクフロー名。このパラメータは、タスクフローの作成（API方式 またはコンソール方式）時にユーザーが指定します。具体的な内容は、タスクフロー概要をご参照ください。
String
いいえ
ExpireTime
メディアファイルの期限切れ時間。表記形式はISO 8601規格に準拠します。詳細については、ISO日時表記形式の説明をご参照ください。
String
いいえ
ClassId
カテゴリーID。メディアのカテゴリー管理に使用します。カテゴリー作成インターフェースによってカテゴリーを作成し、カテゴリーIDを取得することができます。
Integer
いいえ
SourceContext
ソースコンテキスト。ユーザーリクエスト情報のパススルーに使用します。アップロードコールバックインターフェースは、このフィールドの値を戻します。最長250文字。
String
いいえ
StorageRegion
ストレージリージョン。ストレージを予定/希望するリージョンを指定します。このフィールドにはストレージリージョンの英語の略称を入力します。
String
いいえ
アップロードレスポンスクラスVodUploadResponse
属性名
属性説明
タイプ
FileId
メディアファイルの一意の標識。
String
MediaUrl
メディア再生アドレス。
String
CoverUrl
メディアカバーアドレス。
String
RequestId
一意のリクエストID。リクエストごとに返されます。問題を特定する時はその回のリクエストのRequestIdを提供する必要があります。
String
アップロードメソッドVodUploadClient.Upload(String region, VodUploadRequest request)
パラメータ名
パラメータの説明
タイプ
入力必須
region
アクセスポイントリージョン。どのリージョンのVODサーバーにリクエストするかであり、ストレージリージョンとは異なります。具体的な内容は、サポートするリージョンリストをご参照ください。
String
はい
request
アップロードリクエスト。
VodUploadRequest
はい

エラーコードリスト

ステータスコード
意味
InternalError
内部エラー。
InvalidParameter.ExpireTime
パラメータ値のエラー：期限切れ時間。
InvalidParameterValue.CoverType
パラメータ値のエラー：カバーのタイプ。
InvalidParameterValue.MediaType
パラメータ値のエラー：メディアタイプ。
InvalidParameterValue.SubAppId
パラメータ値のエラー：サブアプリケーションID。
InvalidParameterValue.VodSessionKey
パラメータ値のエラー：VODセッション。
ResourceNotFound
リソースがありません。
前の記事へ: Java SDK次の記事へ: PHP SDK

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック