操作シナリオ
サーバーからのビデオアップロードとは、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が含まれています。詳細については、以下をご参照ください。
APIから開始するアップロード方法
VODが提供するアップロードSDKにおいて、Appバックエンドの使用言語がカバーされていない場合は、Appバックエンドで自分でVODのサーバーAPIを呼び出し、ビデオのアップロードを行なう必要があります(この方式は複雑なため、推奨しません)。APIによるアップロードの作業フローチャートは次のとおりです。
SDK方式のアップロードと比べ、API方式によるアップロードは、アップロードの申請やファイルのアップロードなどの手順を自分で実行する必要があります。またファイルのアップロードもSDKの方式ほど便利ではありません。大きなファイルについては、パートアップロードなどのロジックを自分で実行する必要があります。詳細については、以下をご参照ください。 高度な機能
アップロード時のタスクフローの指定
ビデオのアップロードが完了した後、 ビデオ処理タスクフロー(トランスコード、スクリーンキャプチャなど)を自動的に開始したい場合は、サーバーAPI アップロードの申請を呼び出す時に、Procedure
パラメータによって実現することができ、このパラメータの値をタスクフローテンプレート名にします。VODでは、タスクフローテンプレートの作成し、テンプレートに命名する機能をサポートしており、タスクフローの開始時に、タスクフローテンプレート名によって開始したいタスクを表すことができます。VODが提供する多言語のSDKはいずれもタスクフローパラメータの指定が可能です。詳細については以下をご参照ください。 アップロード時にストレージリージョンを指定
VODが提供するストレージリージョンは、デフォルトでシンガポール に設定されています。他のリージョンに保存する必要がある場合は、コンソールで他のストレージリージョンを自分で追加できます。詳細については、アップロードストレージ設定をご参照ください。設定が完了すると、サーバーAPI アップロードの申請 を呼び出す時に、StorageRegion
パラメータによって実現でき、このパラメータの値をストレージリージョンの英語の略称にします。VODが提供する多言語 SDKはいずれもアップロード時のストレージリージョンの指定をサポートしています。詳細については以下をご参照ください。 2. イベント通知
新しいビデオファイルのFileIdとURL。
VODは、ビデオアップロード時のパススルーフィールドの指定をサポートしており、イベントが完了すると、パススルーフィールドはAppバックエンドに送信されます。イベント通知には、次のフィールドが含まれています。
SourceType
:このフィールドはTencent CloudによってServerUpload
と定められており、アップロードがサーバーからであることを表しています。
SourceContext
:ユーザー定義のパススルーフィールドです。署名の配布中にAppバックエンドに指定されます。これは署名のsourceContext
パラメータに対応します。
VODでは、ビデオアップロード完了時にビデオ処理を自動的に開始する機能をサポートしています。アップロード時にビデオ処理タスクフローを指定すると、イベント通知の内容にタスクID、すなわちイベント通知の中のdata.procedureTaskId
フィールドが添付されてきます。 詳細については、以下をご参照ください。
この記事はお役に立ちましたか?