メディアアップロードは、メディアリソースを ApsaraVideo VOD に登録することで、メディアアセット管理、メディア処理、コンテンツ配信などのダウンストリームサービスを利用できるようにします。このトピックでは、サポートされているフォーマット、アップロード方法、ストレージ設定、およびアップロード後のワークフローについて説明します。
サポート対象のメディアフォーマット
ApsaraVideo VOD は、動画、オーディオ、画像、および補助メディアアセット (ウォーターマークファイル、字幕ファイル、素材ファイル) のアップロードに対応しています。ファイルは ローカルまたは オンライン (URL からのアップロード) に対応しています。
拡張子は必須です。拡張子の大文字と小文字は区別されません。MP4 と mp4 は同等です。
|
メディアタイプ |
ファイルフォーマット |
|
動画 |
|
|
オーディオ |
MP3、WMA、WAV、AAC、RA、M4A、FLAC、APE、AC3、AMR、CAF、ACM。 |
|
画像 |
PNG、JPG、JPEG、GIF、HEIC。 |
|
補助メディアアセット |
|
ApsaraVideo VOD は、記載されているファイルタイプにのみ対応しています。その他のタイプについては、「OSSへのファイルのアップロード」をご参照ください。
アップロード方法
ApsaraVideo VOD では、手動アップロードとプログラム連携によるアップロード方法が利用できます。
|
アップロード方法 |
ユースケース |
説明 |
|
|
手動アップロード |
迅速かつ簡単なメディアアセットのアップロード 説明
コンソールを使用した大容量ファイルのアップロードは、セッションの有効期限が切れると失敗する可能性があります。大容量ファイルの場合は、Windows クライアントを使用してください。 |
|
|
|
大容量ファイルのアップロードや長時間のアップロードタスク |
|
||
|
プログラム連携 |
説明
可能な限りアップロード SDK を使用してください。提供されている SDK がお使いの言語に対応していない場合は、代わりに OSS ネイティブ SDK を使用してください。 |
|
|
|
|
||
|
パブリック URL 経由でアクセス可能なファイル |
|
アップロード方法別機能比較
次の表で、方法別のアップロード機能を比較します。
|
グループ |
機能 |
|||||||
|
メディアアセット管理 |
メディアタイトル |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
メディアカテゴリ |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
|
メディアタグ |
非対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
|
動画サムネイル |
非対応 |
非対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
|
音声と動画のトランスコーディング① |
トランスコードテンプレートグループ |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
ワークフロー |
対応 |
非対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
|
トランスコードなし |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
|
アップロード制御② |
アップロードの進捗 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
対応 |
|
再開可能なアップロード |
非対応 |
非対応 |
Java 版サーバーアップロード SDK のみ対応 |
対応 |
非対応 |
Java 版 OSS SDK のみ対応 |
非対応 |
|
|
マルチパートアップロード |
デフォルトで有効 |
デフォルトで有効 |
デフォルトで有効 |
デフォルトで有効 |
デフォルトで有効 |
デフォルトで有効 |
デフォルトで有効 |
ストレージ
ストレージリージョン
ApsaraVideo VOD は、Object Storage Service (OSS) を使用して、全世界のストレージノードにメディアアセットを保存します。各ノードは、専用のストレージアドレスを持つリージョンに対応します。
ストレージアドレス
データはリージョンごとに分離され、同一アカウント内であってもリージョン間で共有されません。アップロード先のリージョンが、利用するサービスリージョンと一致していることを確認してください。
|
設定 |
説明 |
|
VODシステムストレージアドレスの有効化 |
ApsaraVideo VOD を有効化すると、各リージョンにデフォルトのストレージバケット (VOD システムバケット) が作成され、すぐに使用できます。詳細については「ストレージバケットの管理」をご参照ください。 |
|
ストレージアドレスの追加 |
お客様の OSS バケットを ApsaraVideo VOD に追加して、これらのバケット内のファイルに対して、トランスコーディング、スナップショットキャプチャ、再生を行えるようにします。詳細については「ストレージバケットの管理」をご参照ください。 |
|
デフォルトストレージアドレスの変更 |
複数のストレージアドレスを追加した後、デフォルトを変更できます。特に指定しない限り、アップロードはデフォルトのアドレスに送信されます。詳細については「ストレージバケットの管理」をご参照ください。 |
次の表に、サポートされているリージョンとリージョン ID を示します。
コンソールと PC クライアントからのアップロードでは、選択したリージョンのストレージアドレスが使用されます。SDK と API によるアップロードでは、URL ベースのプルアップロード操作の StorageLocation パラメーターなどを使用して、ストレージアドレスを指定できます。
|
リージョン |
リージョン ID |
|
China (Shanghai) |
cn-shanghai |
|
China (Beijing) |
cn-beijing |
|
China (Shenzhen) |
cn-shenzhen |
|
China (Hong Kong) |
cn-hongkong |
|
Japan (Tokyo) |
ap-northeast-1 |
|
Singapore |
ap-southeast-1 |
|
Indonesia (Jakarta) |
ap-southeast-5 |
|
Germany (Frankfurt) |
eu-central-1 |
|
US (Silicon Valley) |
us-west-1 |
課金
ApsaraVideo VOD のストレージは、従量課金 (後払い) またはリソースプラン (前払い) で課金されます。
-
従量課金:詳細については「メディアアセットストレージの課金」をご参照ください。
-
リソースプラン:詳細については「ApsaraVideo VOD ストレージプラン」をご参照ください。
アップロードイベント通知
ApsaraVideo VOD は、各アップロード後に HTTP(S) または MNS のコールバックでイベント通知を送信します。 処理ステータスの更新を受信するには、コールバックを設定してください。 次の表に、アップロードイベントを示します。
イベントの全詳細:イベント通知。
|
イベント名 |
タイプ |
説明 |
|
Video Upload Complete |
FileUploadComplete |
音声または動画ファイルのアップロードが完了した後にトリガーされます。 説明
トランスコーディングされていない音声または動画ファイルの場合、再生 URL は FileUploadComplete イベントの後にのみ利用可能になります。 アップロード中にトランスコーディングを無効にした場合でも、FileUploadComplete イベント通知を受信した後に Submit media transcoding jobs API を呼び出してファイルをトランスコーディングできます。 |
|
Image Upload Complete |
ImageUploadComplete |
画像ファイルのアップロードが完了した後にトリガーされます。 |
|
Auxiliary Media Upload Complete |
AttachedMediaUploadComplete |
補助メディアアセットのアップロードが完了した後にトリガーされます。 |
|
Video Upload from URL Complete |
UploadByURLComplete |
UploadMediaByURL 操作による動画の取得とアップロードが完了したときにトリガーされます。 |
|
Transcode complete for a single stream |
StreamTranscodeComplete |
ビデオストリームが特定の解像度とフォーマット (例:MP4 形式の SD) にトランスコーディングされたときにトリガーされます。 説明
トランスコーディングされたファイルの場合、再生 URL を取得する前に StreamTranscodeComplete イベントを待機してください。このコールバックを受信する前に再生すると失敗する可能性があります。 |
|
Video Transcode Complete |
TranscodeComplete |
ビデオ内の全ストリームのトランスコーディングが完了したときにトリガーされます。 説明
すべての解像度が利用可能であることを確認するために、TranscodeComplete イベントを待機してください。このコールバックの前に再生すると失敗する可能性があります。 |
アップロードの権限付与
開発者によるアップロードでは、悪意のあるアップロードや不正な再生を防ぐため、アップロード認証情報または Security Token Service (STS) トークンで権限を付与します。
-
アップロード方法別の権限付与の詳細:
-
2024年1月31日以降、 ApsaraVideo VOD はファイル権限を変更するための
x-oss-object-aclOSS ヘッダーをサポートしなくなりました。 ApsaraVideo VOD OSS バケットへのパブリック読み取りアップロードを禁止するには、次の手順を実行します。-
ApsaraVideo VOD が OSS リソースにアクセスすることを承認するには、 クラウドリソースへのアクセス権限付与 をクリックします。
-
OSS バケットへのパブリック読み取りオブジェクト ACL を持つオブジェクトのアップロードを禁止する ためのカスタムポリシーを作成します。ポリシーの内容と手順については、「OSS バケットへのパブリック読み取りオブジェクト ACL を持つオブジェクトのアップロードを禁止する」をご参照ください。
-
前の手順で作成したカスタムポリシーを AliyunVODDefaultRole ロールに付与します。
RAM コンソール にログインして権限を付与します (RAM ユーザー権限の管理)。
ナビゲーションペインで [ロール] をクリックします。 AliyunVODDefaultRole を見つけてクリックします。 [権限] タブで [権限を追加] をクリックします。 表示されるパネルで [カスタムポリシー] タブを選択し、対象のポリシーを選択します。
-
アップロードアクセラレーション
アップロードアクセラレーションは、長距離転送や大容量ファイル (GB/TB) の転送を改善します。中国本土から Singapore リージョンのバケットへ動画を転送するなど、クロスリージョンのアップロードに最適です。
有効化方法
アップロードアクセラレーションを有効にするには、チケットを送信してください。アカウント ID と、アクセラレーション対象の バケット を指定してください。
課金
アップロードアクセラレーションは、使用量に基づいて課金されます (転送アクセラレーションの課金)。
この機能を使用しない場合、課金は発生しません。
制限事項
ApsaraVideo VOD コンソールを使用してファイルをアップロードする以外のすべてのアップロード方法で、アクセラレーションがサポートされています。
次のステップ
次の表に、アップロード後のサービスと再生に関する考慮事項を示します。
|
サービス |
説明 |
参考資料 |
|
メディア資産管理 (アップロード後) |
アップロードされたメディアファイル (ソース動画、トランスコードされたストリーム、画像を含む) を管理します。 |
|
|
メディア処理 |
アップロード後の操作には、トランスコーディング、自動レビュー、オンライン編集、AI 処理が含まれます。 説明
ApsaraVideo VOD は、動画のメタデータ (解像度、デュレーション、ビットレート) を自動的に抽出し、サムネイルとスプライトをキャプチャします。これらの前処理操作は無料です。 |
|
|
音声と動画の再生 |
アップロードされたファイルは、すぐには再生できません。イベント通知が、ファイルの準備が完了したことを通知します。
|
|