ApsaraVideo VODに保存されているメディアファイルは、オンプレミスディスクまたはその他のストレージデバイスにダウンロードできます。 ApsaraVideo VODコンソール、クライアント、またはAPI操作を使用して、さまざまなメディアファイルのダウンロードURLを照会できます。 このトピックでは、メディアファイル、ダウンロードURLタイプ、ダウンロード制限、およびクエリ方法について説明します。
メディアファイル
ApsaraVideo VODは、メザニンファイル、トランスコードされたストリームファイル、ビデオスナップショットファイル、アップロードされた画像ファイルなど、複数の種類のメディアファイルを生成できます。 ApsaraVideo VODでは、次の種類のメディアファイルを照会およびダウンロードできます。
オーディオとビデオ
ApsaraVideo VODにアップロードされたメザニンファイル
指定された定義内のトランスコードされたストリームファイル
画像
ApsaraVideo VODにアップロードされた画像ファイル
スナップショット処理中にApsaraVideo VODによって自動的に生成されたサムネイルスナップショットおよびイメージスプライトスナップショットのイメージファイル
SubmitSnapshotJob操作を呼び出した後に生成されたスプライトスナップショットを構成する通常のスナップショット、イメージスプライトスナップショット、および元のスナップショットのイメージファイル。 詳細については、「SubmitSnapshotJob」をご参照ください。
ダウンロードURLタイプ
取得できるメディアファイルのダウンロードURLには、Object Storage Service (OSS) ソースURLとAlibaba Cloud CDN URLが含まれます。 OSSソースURLからのダウンロードに対して、メディアアセット管理料金が課金されます。 これらの料金は、OSSアウトバウンドトラフィックの結果です。 CDN URLからのダウンロードに対してCDNトラフィック料金が課金されます。 これらの料金は、CDNアクセラレーションの結果です。
ストレージアドレス
デフォルトでは、各メディアファイルのダウンロードURLはOSS URLです。 詳細については、「VODリソースの管理」をご参照ください。
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からのダウンロードには適用されません。
ビデオ暗号化が設定されている場合、ダウンロードされるすべてのトランスコードされたストリームファイルは、OSS URLまたはCDN URLからダウンロードされるかどうかに関係なく暗号化されます。 トランスコードされたストリームファイルを復号して再生する必要があります。 詳細については、「概要」トピックの「ビデオ暗号化」セクションをご参照ください。
プライベートOSSストレージを使用する場合、ダウンロードURLには有効期間があります。 ダウンロードURLの有効期限が切れた場合は、再度取得する必要があります。 ダウンロードURLの有効期間を長く設定することを推奨します。
CDNのドメイン名に対してURL署名が有効になっている場合、ダウンロードURLには有効期間があります。 ダウンロードURLの有効期限が切れた場合は、再度取得する必要があります。 ダウンロードURLの有効期間を長く設定することを推奨します。
コンソールを使用してダウンロードURLを取得する
ダウンロードURLの表示
オーディオとビデオのメザニンファイルとトランスコードされたストリームファイル:
ApsaraVideo VODコンソールにログインします。左側のナビゲーションウィンドウで、[メディアファイル] を選択し、[オーディオ /ビデオ] または [画像] をクリックします。[オーディオ /ビデオまたは画像] ページで、管理するファイルを見つけ、[操作] 列の [管理] をクリックします。
[ビデオURL] タブで、[操作] 列の [コピー] をクリックして、ファイルのダウンロードURLをコピーします。 各定義のメザニンファイルまたはトランスコードされたファイルのダウンロードURLをコピーできます。
ApsaraVideo VODにアップロードされた画像ファイル:
左側のナビゲーションウィンドウで、[メディアファイル] を選択し、[オーディオ /ビデオ] をクリックします。[オーディオ /ビデオ] ページで、管理するファイルを見つけ、[操作] 列で [管理] をクリックします。
画像の詳細ページで、[コピー] をクリックして画像のURLをコピーします。
ダウンロードURLのエクスポート
オーディオとビデオのトランスコードされたストリームファイル:
左側のナビゲーションウィンドウで、[メディアファイル] を選択し、[オーディオ /ビデオ] をクリックします。[オーディオ /ビデオ] ページで、右上隅にある [メディアURLのエクスポート] アイコンをクリックし
ます。 システムは、指定されたフィルタ条件に基づいて、各定義でトランスコードされた最初の200のビデオおよびオーディオファイルのダウンロードURLをエクスポートします。 ApsaraVideo VODにアップロードされた画像ファイル:
左側のナビゲーションウィンドウで、[メディアファイル] を選択し、[画像] をクリックします。[画像] ページで、右上隅にある [
メディアURLのエクスポート] アイコンをクリックします。 指定されたフィルター条件に基づいて、最初の100イメージのダウンロードURLがエクスポートされます。
APIまたはSDKを使用してダウンロードURLを取得する
オーディオおよびビデオメザニンファイル、トランスコードされたストリームファイル、自動的に生成されるスナップショットファイル、および画像ファイルをダウンロードできます。 次の操作で必要なファイルのダウンロードURLを取得し, ダウンロードできます。
操作 | 説明 | 関連ドキュメント |
|---|---|---|
GetMezzanineInfo | メザニンファイルのダウンロードURLを照会します。 返されるメザニンオブジェクトでは、 | |
GetPlayInfo | トランスコードされたストリームファイルのストリーミングURLを照会します。 返されるPlayInfoオブジェクトでは、 | |
GetVideoInfo | ビデオ情報を照会します。 返されるビデオオブジェクトでは、 | |
GetImageInfo | イメージ情報を照会します。 返されるImageInfoオブジェクトでは、 | |
SearchMedia | メディア資産情報を照会します。 メディアアセットタイプがビデオまたはオーディオに設定されている場合、メディアアセット情報はビデオまたはオーディオオブジェクトで返されます。 オブジェクトでは、 | |
ListSnapshots | スナップショット情報を照会します。 返されるMediaSnapshotオブジェクトの |
Call methods:
クライアントのダウンロード
ApsaraVideo Player SDKにはダウンロード機能があり、ユーザーはモバイル端末にオーディオおよびビデオストリームファイルをキャッシュし、オフラインでストリームを視聴できます。 この機能を有効または無効にできます。 通常および暗号化ダウンロードモードがサポートされています。
ダウンロード設定
左側のナビゲーションウィンドウで、[設定管理] を選択します。 [CDN設定] > [ダウンロード] をクリックします。 [ダウンロード] ページで、[ダウンロードモード] パラメーターを設定できます。 詳細については、「オフラインダウンロードの設定」をご参照ください。
Normal: このモードでは、ダウンロードしたオーディオファイルとビデオファイルは暗号化されません。 ファイルはコピーでき、プレーヤーを使用して再生できます。 ダウンロードモードを [通常] に設定するときは注意してください。
暗号化: このモードでは、ダウンロードしたオーディオファイルとビデオファイルはキーファイルを使用して暗号化されます。 ファイルは、同じキーファイルを使用してのみ復号化できます。 これはビデオの著作権を保護します。 ダウンロードしたオーディオおよびビデオファイルを復号化して再生するには、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の実装」をご参照ください。