ApsaraVideo VOD:media filesのダウンロード

メディアファイル

ApsaraVideo VODは、メザニンファイル、トランスコードされたストリームファイル、ビデオスナップショットファイル、アップロードされた画像ファイルなど、複数の種類のメディアファイルを生成できます。 ApsaraVideo VODでは、次の種類のメディアファイルを照会およびダウンロードできます。

• オーディオまたはビデオ

  • ApsaraVideo VODにアップロードされたメザニンファイル

  • 指定された定義内のトランスコードされたストリームファイル

• イメージ

  • ApsaraVideo VODにアップロードされた画像ファイル

  • スナップショット処理中にApsaraVideo VODによって自動的に生成されたサムネイルスナップショットおよびイメージスプライトスナップショットのイメージファイル

  • SubmitSnapshotJob操作を呼び出した後に生成されたスプライトスナップショットを構成する通常のスナップショット、イメージスプライトスナップショット、および元のスナップショットのイメージファイル。 詳細については、「SubmitSnapshotJob」をご参照ください。

ダウンロードURLタイプ

取得できるメディアファイルのダウンロードURLには、ストレージアドレスとCDN URLが含まれます。 OSSソースURLからのダウンロードに対して、メディアアセット管理料金が課金されます。 これらの料金は、OSSアウトバウンドトラフィックの結果です。 CDN URLからのダウンロードに対してCDNトラフィック料金が課金されます。 これらの料金は、CDNアクセラレーションの結果です。

• ストレージアドレス

  • デフォルトでは、各メディアファイルのダウンロードURLはOSS URLです。 詳細については、「ストレージバケットの管理」をご参照ください。

  • CDNのドメイン名が設定されている場合、各メディアファイルのダウンロードURLはCDN URLです。 メザニンファイルまたはトランスコードされたストリームファイルのOSS URLをダウンロードURLとして強制的に返すことができます。 OSS URLを取得するには、OutputTypeパラメーターをossに設定してダウンロードURLを取得します。 詳細については、「GetMezzanineInfo」および「GetPlayInfo」をご参照ください。 CDNのドメイン名が設定されている場合でも、入力バケットに保存されているメザニンファイルのダウンロードURLはOSS URLです。 入力バケットの名前はin- で始まります。

• CDN URL

  CDNのドメイン名が設定されている場合、各メディアファイルのダウンロードURLはCDN URLです。 詳細については、「CDN のドメイン名を追加する」をご参照ください。

制限事項

ホットリンク保護やビデオ暗号化などのメディアセキュリティサービスが設定されている場合、ダウンロードURLを取得してもメディアファイルのダウンロードは制限されます。

• アクセス制御サービスが設定されている場合、CDN URLからのダウンロードは、リファラーベースのホットリンク保護、IPアドレスブラックリストまたはホワイトリストなどのポリシーによって制限されます。 制限はオンライン再生の制限と同じです。 ただし、ストレージアドレスからのダウンロードには制限が適用されません。

• ビデオ暗号化が設定されている場合、ダウンロードされるすべてのトランスコードされたストリームファイルは、OSS URLまたはCDN URLからダウンロードされるかどうかに関係なく暗号化されます。 トランスコードされたストリームファイルを復号して再生する必要があります。 詳細については、「概要」トピックの「ビデオ暗号化」セクションをご参照ください。

• プライベートOSSストレージを使用する場合、ダウンロードURLには有効期間があります。 ダウンロードURLの有効期限が切れた場合は、再度取得する必要があります。 ダウンロードURLの有効期間を長く設定することを推奨します。

• CDNのドメイン名に対してURL署名が有効になっている場合、ダウンロードURLには有効期間があります。 ダウンロードURLの有効期限が切れた場合は、再度取得する必要があります。 ダウンロードURLの有効期間を長く設定することを推奨します。

コンソールを使用してダウンロードURLを取得する

• ダウンロードURLの表示

  ApsaraVideo VOD コンソールにログインします。 左側のナビゲーションウィンドウで、[メディアファイル] > [オーディオ /ビデオ] または [画像] を選択します。 表示されるページで、管理するファイルを見つけて、[操作] 列の [管理] をクリックします。 詳細ページで、ダウンロードURLを取得します。

• ダウンロードURLのエクスポート

  • オーディオとビデオのトランスコードされたストリームファイル:

    ApsaraVideo VOD コンソールにログインします。 左側のナビゲーションウィンドウで、[メディアファイル] > [オーディオ /ビデオ] を選択します。 オーディオ /ビデオページで、右上隅のアイコンをクリックします。 システムは、指定されたフィルタ条件に基づいて、各定義でトランスコードされた最初の200のビデオおよびオーディオファイルのダウンロードURLをエクスポートします。

  • ApsaraVideo VODにアップロードされた画像ファイル:

    ApsaraVideo VOD コンソールにログインします。 左側のナビゲーションウィンドウで、[メディアファイル] > [画像] を選択します。 画像ページで、右上隅のアイコンをクリックします。 指定されたフィルター条件に基づいて、最初の100イメージのダウンロードURLをエクスポートします。

APIまたはSDKを使用してダウンロードURLを取得する

オーディオおよびビデオメザニンファイル、トランスコードされたストリームファイル、自動的に生成されるスナップショットファイル、および画像ファイルをダウンロードできます。 次の操作で必要なファイルのダウンロードURLを取得し, ダウンロードできます。

使用法ノート:

• ApsaraVideo VOD SDKを使用してAPI操作を呼び出すことを推奨します。 これにより、メディアアセット情報を効率的に取得できます。 ApsaraVideo VOD SDKの詳細については、「使用法ノート」をご参照ください。 API操作の詳細については、「APIリファレンスのSDKの例」をご参照ください。

• HTTPまたはHTTPSでリクエストを送信することもできます。 詳細については、「リクエスト構文」をご参照ください。

クライアントのダウンロード

ApsaraVideo Player SDKにはダウンロード機能があり、ユーザーはモバイル端末にオーディオおよびビデオストリームファイルをキャッシュし、オフラインでストリームを視聴できます。 この機能を有効または無効にできます。 通常および暗号化ダウンロードモードがサポートされています。

ダウンロード設定

ApsaraVideo VOD コンソールにログインします。 左側のナビゲーションウィンドウで、[設定管理] > [CDN設定] > [ダウンロード] を選択します。 [ダウンロード] ページで、パラメーターを設定します。 詳細については、「ダウンロード設定の構成」をご参照ください。

• 通常のダウンロード: このモードでは、ダウンロードしたオーディオおよびビデオファイルは暗号化されません。 ファイルはコピーでき、プレーヤーを使用して再生できます。 ダウンロードモードを [通常] に設定するときは注意してください。

• 安全なダウンロード: このモードでは、ダウンロードしたオーディオおよびビデオファイルはキーファイルを使用して暗号化されます。 ファイルは、同じキーファイルを使用してのみ復号化できます。 これはビデオの著作権を保護します。 ダウンロードしたオーディオおよびビデオファイルを復号化して再生するには、ApsaraVideo Player SDKを使用する必要があります。 ApsaraVideo VODコンソールは、暗号化用の秘密鍵を生成するためのツールを提供します。

ApsaraVideo Player SDK

ApsaraVideo Player SDK for iOSとApsaraVideo Player SDK for Androidはどちらも安全なダウンロード機能をサポートしています。 詳細については、iOS用ApsaraVideo Player SDKの「実装」およびAndroid用ApsaraVideo Player SDKの「実装」をご参照ください。