tencent cloud

操作シナリオ

サーバーからのビデオアップロードとは、AppバックエンドがビデオをVODプラットフォームにアップロードすることを指します。ここでは、サーバーAPIを使用してビデオを アップロードする方法を紹介します。

前提条件

1. サービスのアクティブ化

VODサービスをアクティブ化します。詳細については、購入ガイドラインをご参照ください。

2. Tencent Cloud APIキーの取得

サーバーAPIの呼び出しに必要なセキュリティ証明（SecretIdとSecretKey）を取得します。具体的な手順は次のとおりです。

1. コンソールにログインし、【クラウド製品】>【CAM】>【APIキー管理】を選択し、「APIキー管理」ページに進みます。
2. Tencent Cloud APIキーを取得します。キーを作成していない場合は、【キーの作成】をクリックして、SecretIdとSecretKeyのペアを作成することができます。

操作手順

1. アップロードの開始

アップロードの開始方式は、SDKによるアップロード開始とAPIによるアップロード開始に分かれます。

SDKから開始するアップロード方法

ユーザー開発サイドでアップロード機能を扱いやすくするため、VODでは多様な言語のプラットフォームによるSDKを提供しています。各言語のSDKにはいずれも対応するDemoが含まれています。詳細については、以下をご参照ください。

• PHP SDK
• Java SDK
• Python SDK
• Node.js SDK
• Go SDK
• C# SDK

APIから開始するアップロード方法

VODが提供するアップロードSDKにおいて、Appバックエンドの使用言語がカバーされていない場合は、Appバックエンドで自分でVODのサーバーAPIを呼び出し、ビデオのアップロードを行なう必要があります（この方式は複雑なため、推奨しません）。APIによるアップロードの作業フローチャートは次のとおりです。

SDK方式のアップロードと比べ、API方式によるアップロードは、アップロードの申請やファイルのアップロードなどの手順を自分で実行する必要があります。またファイルのアップロードもSDKの方式ほど便利ではありません。大きなファイルについては、パートアップロードなどのロジックを自分で実行する必要があります。詳細については、以下をご参照ください。

• サーバーAPI - アップロードの申請
• サーバーAPI - ファイルのアップロード
• サーバーAPI - アップロードの確認

高度な機能

• アップロード時のタスクフローの指定
  ビデオのアップロードが完了した後、 ビデオ処理タスクフロー（トランスコード、スクリーンキャプチャなど）を自動的に開始したい場合は、サーバーAPI アップロードの申請を呼び出す時に、Procedureパラメータによって実現することができ、このパラメータの値をタスクフローテンプレート名にします。VODでは、タスクフローテンプレートの作成し、テンプレートに命名する機能をサポートしており、タスクフローの開始時に、タスクフローテンプレート名によって開始したいタスクを表すことができます。VODが提供する多言語のSDKはいずれもタスクフローパラメータの指定が可能です。詳細については以下をご参照ください。
  • PHP SDK
  • Java SDK
  • Python SDK
  • Node.js SDKSDK
  • Go SDK
  • C# SDK
• アップロード時にストレージリージョンを指定
  VODが提供するストレージリージョンは、デフォルトでシンガポール に設定されています。他のリージョンに保存する必要がある場合は、コンソールで他のストレージリージョンを自分で追加できます。詳細については、アップロードストレージ設定をご参照ください。設定が完了すると、サーバーAPI アップロードの申請 を呼び出す時に、StorageRegionパラメータによって実現でき、このパラメータの値をストレージリージョンの英語の略称にします。VODが提供する多言語 SDKはいずれもアップロード時のストレージリージョンの指定をサポートしています。詳細については以下をご参照ください。

  • PHP SDK

  • Java SDK

  • Python SDK

  • Node.js SDKSDK

  • Go SDK

  • C# SDK

    2. イベント通知

ビデオのアップロードが完了すると、VODはAppバックエンドに イベント通知 - ビデオアップロード完了 を開始します。Appバックエンドは、このイベントを通じてビデオのアップロード動作を認識することができます。イベント通知を受信するには、Appは コンソール - コールバック設定 に移動してイベント通知を有効にする必要があります。イベント通知 - ビデオアップロード完了 には、主に次の情報が含まれています。

• 新しいビデオファイルのFileIdとURL。
• VODは、ビデオアップロード時のパススルーフィールドの指定をサポートしており、イベントが完了すると、パススルーフィールドはAppバックエンドに送信されます。イベント通知には、次のフィールドが含まれています。
  • SourceType：このフィールドはTencent CloudによってServerUploadと定められており、アップロードがサーバーからであることを表しています。
  • SourceContext：ユーザー定義のパススルーフィールドです。署名の配布中にAppバックエンドに指定されます。これは署名のsourceContextパラメータに対応します。
• VODでは、ビデオアップロード完了時にビデオ処理を自動的に開始する機能をサポートしています。アップロード時にビデオ処理タスクフローを指定すると、イベント通知の内容にタスクID、すなわちイベント通知の中のdata.procedureTaskIdフィールドが添付されてきます。

詳細については、以下をご参照ください。

• タスク管理とイベント通知
• イベント通知 - ビデオアップロード完了