標準トランスコーディングには、ビデオトランスコーディング、オーディオトランスコーディング、トランスマックスが含まれます。オーディオストリームまたはビデオストリームを、さまざまなネットワーク帯域幅や再生デバイスに合わせて、異なる画質やエンコーディング形式に変換します。ApsaraVideo VOD は、H.264、H.265、H.266、AV1、WebP、GIF をサポートしています。
注意事項
ApsaraVideo VOD には、TranscodeTemplateGroup という名前のプリセットトランスコードテンプレートグループが用意されています。これには、標準画質 (SD) の HLS および MP4 ビデオ形式に関する一般的な設定 (ビットレートや解像度など) が事前設定されています。このグループを使用すると、形式、ウォーターマーク、暗号化を迅速に指定できます。このテンプレートグループは、新規ユーザーに推奨します。
組み込みの [トランスコードなし] テンプレートグループを使用する場合、ソースビデオは直接再生できる必要があります。現在、トランスコーディングなしで直接再生できるのは、MP4、FLV、M3U8、MP3、WEBM 形式のビデオのみです。
上記の形式リストは、ビデオのコンテナフォーマットを指します。コンテナフォーマットがリストに含まれていても、内部のビデオエンコーディング形式がブラウザの HTML5 プレーヤーでサポートされていない場合、トランスコーディングなしで直接再生することはできません。たとえば、MPEG-4 Part 2 (Simple Profile、つまりコーデックが mp4v) でエンコードされた MP4 ファイルは、再生時に画面が真っ暗になったり、エラーが表示されたりします。
説明サポートされていないエンコーディング形式の確認と対処方法： ffprobe を使用して、ビデオストリームのエンコーディングを確認できます：
ffprobe -show_entries stream=codec_name -of csv=p=0 input.mp4。出力が mp4v のようなブラウザでサポートされていないエンコーディングである場合は、次のいずれかの処理を選択できます。アップロード時にトランスコードテンプレートグループ (システムのプリセットである TranscodeTemplateGroup など) を指定し、システムが H.264 にトランスコーディングしてから再生する方法、またはソースビデオを H.264 でエンコードされた MP4 にトランスコードしてから、非トランスコーディングのテンプレートグループにアップロードする方法です。
課金
ビデオトランスコーディングは有料サービスです。出力ビデオの仕様と長さに応じて課金されます。詳細については、「メディアトランスコーディングの課金」をご参照ください。
手順
コンソール
ステップ 1：通常トランスコードテンプレートグループの作成
組み込みの [トランスコードなし] および TranscodeTemplateGroup テンプレートグループが要件を満たさない場合は、任意のコンテナフォーマット、画質、およびその他のパラメーターを使用してカスタムトランスコードテンプレートグループを作成します。
詳細については、「トランスコードテンプレート」をご参照ください。
ステップ 2 (オプション)：ワークフローの作成
トランスコーディング、コンテンツモデレーション、スナップショットなどのメディア処理タスクをワークフローに編成します。メディアのアップロード中またはアップロード後にトリガーされると、タスクは事前定義された順序で自動的に実行されます。
ワークフローを作成し、メディアトランスコーディングノードを追加して、作成したトランスコードテンプレートグループに関連付けます。詳細については、「ワークフローの管理」をご参照ください。
ステップ 3：トランスコーディングの開始
作成したトランスコードテンプレートグループまたはワークフローを使用して、ビデオをトランスコードします。アップロード中またはアップロード後にトランスコーディングをトリガーできます。
アップロード中
ApsaraVideo VOD コンソール にログインします。
左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択します。[オーディオ/ビデオのアップロード] をクリックします。
[オーディオ/ビデオの追加] をクリックします。アップロード方法やストレージの場所などのパラメーターを設定します。トランスコードテンプレートグループでの処理 または ワークフローでの処理 を選択し、作成したテンプレートグループまたはワークフローを選択します。
サポートされている形式とパラメーターの説明については、「コンソールを使用したメディアファイルのアップロード」をご参照ください。
アップロードするメディアファイルを追加し、アップロード をクリックします。
アップロード後
この方法は、既存のビデオの再トランスコーディング、標準暗号化の適用、またはウォーターマーク設定の上書きによく使用されます。
ApsaraVideo VOD コンソール にログインします。
左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択します。
トランスコードするメディアファイルを見つけ、処理 列の 処理 をクリックします。
トランスコードテンプレートグループでの処理 または ワークフローでの処理 を選択します。[メディア処理] ダイアログボックスで、[トランスコードテンプレートグループで処理] を選択した場合は、[トランスコードテンプレートグループ] ドロップダウンリストから [TranscodeTemplateGroup] などのグループを選択します。
決定 をクリックします。
ステップ 4：結果の表示
トランスコーディングジョブを開始した後、次の方法でステータスを確認し、出力ビデオの URL を表示します。これらの URL を使用して、ApsaraVideo Player またはサードパーティ製のプレーヤーでトランスコードされたビデオを再生します。
ApsaraVideo VOD のコンテンツデリバリーネットワーク (CDN) ドメイン名を設定していない場合、ビデオが URL から再生またはダウンロードされるときにアウトバウンドデータ転送の料金が発生します。詳細については、「ストレージからのアウトバウンドデータ転送の課金」をご参照ください。
コンソール
ApsaraVideo VOD コンソール にログインします。
左側のナビゲーションウィンドウで、メディアファイル > [オーディオ/ビデオ] を選択します。
メディアファイルのステータスを確認します。
[正常]ステータスは、トランスコーディングが成功したことを示します。その他のステータスについては、「ステータス： ビデオステータス」をご参照ください。
トランスコードされたメディアファイルの 管理 列にある 管理 をクリックし、ビデオ URL タブに移動します。
トランスコーディングジョブが成功すると、指定された各画質のビデオストリームが、対応する URL とともに生成されます。
[ビデオアドレス] タブには、[オリジナルファイル]、[スムーズ]、[SD]、[オリジナル (トランスマックス)] など、各画質にトランスコードされた出力が一覧表示されます。列には、形式、解像度、ビットレート、アドレス、サイズ、作成時刻が含まれます。[操作] 列では、ビデオストリームの [アドレスのコピー]、[プレビュー]、または [削除] を行うことができます。同じ画質と形式で複数の出力が存在する場合、再生 API はデフォルトで最新のものを返します。[ワンクリッククリア] をクリックして、履歴出力を削除します。
イベント通知
イベント通知を設定して、アップロードの成功やトランスコーディングジョブの完了など、メディア処理が完了したときに更新情報を受信します。これらの通知から、トランスコーディングのステータスと出力ビデオの URL を取得できます。設定手順については、「イベント通知」をご参照ください。
トランスコーディングに関連するイベントは次のとおりです：
API
注意事項
API 操作の呼び出し手順については、「ApsaraVideo VOD API の概要」をご参照ください。Alibaba Cloud が提供するオンラインデバッグツールである OpenAPI Explorer を使用することを推奨します。これを使用すると、署名計算せずに ApsaraVideo VOD 操作を実行できます。OpenAPI Explorer は、呼び出しが成功した後、SDK サンプルコードも生成します。
ステップ 1：トランスコードテンプレートグループの作成
組み込みの [トランスコードなし] (TemplateGroupId が VOD_NO_TRANSCODE) および TranscodeTemplateGroup テンプレートグループが要件を満たさない場合は、任意のコンテナフォーマット、画質、その他のパラメーターを使用してカスタムグループを作成します。
AddTranscodeTemplateGroup API を呼び出します。
TranscodeTemplateパラメーターのDefinitionフィールドで、通常トランスコーディングのパラメーターを指定します。
ステップ 2 (オプション)：ワークフローの作成
トランスコーディング、コンテンツモデレーション、スナップショットなどのメディア処理タスクをワークフローに編成します。メディアのアップロード中またはアップロード後にトリガーされると、タスクは事前定義された順序で自動的に実行されます。
現在、ワークフローは ApsaraVideo VOD コンソールでのみ作成できます。詳細については、「ワークフローの管理」をご参照ください。
ステップ 3：トランスコーディングの開始
作成したトランスコードテンプレートグループまたはワークフローを使用して、ビデオをトランスコードします。アップロード中またはアップロード後にトランスコーディングをトリガーできます。
アップロード中
CreateUploadVideo API は、アップロード URL と認証情報を取得し、基本的なメディアアセット情報を作成するだけです。ファイル自体のアップロードは行いません。独自のアップロードロジックを実装する必要があります。API を使用した完全なアップロード例については、「ApsaraVideo VOD API を使用したメディアファイルのアップロード」をご参照ください。
CreateUploadVideo API または UploadMediaByURL API を呼び出してオーディオまたはビデオファイルをアップロードする際に、
TemplateGroupIdパラメーターでトランスコードテンプレートグループ ID を、またはWorkflowIdパラメーターでワークフロー ID を指定します。アップロードが完了すると、ApsaraVideo VOD は指定された設定に基づいて自動的にトランスコーディングを開始します。
アップロード後
この方法は、既存のビデオの再トランスコーディング、標準暗号化の適用、またはウォーターマーク設定の上書きによく使用されます。
SubmitTranscodeJobs API を呼び出し、
TemplateGroupIdパラメーターでトランスコードテンプレートグループ ID を指定します。または、SubmitWorkflowJob API を呼び出し、WorkflowIdパラメーターでワークフロー ID を指定します。システムは指定された設定に基づいて、ただちにトランスコーディングを開始します。
ステップ 4：結果の表示
トランスコーディングジョブを開始した後、次の方法でステータスを確認し、出力ビデオの URL を表示します。これらの URL を使用して、ApsaraVideo Player またはサードパーティ製のプレーヤーでトランスコードされたビデオを再生します。
ApsaraVideo VOD の CDN ドメイン名を設定していない場合、ビデオが URL から再生またはダウンロードされるときにアウトバウンドデータ転送の料金が発生します。詳細については、「ストレージからのアウトバウンドデータ転送の課金」をご参照ください。
API クエリ
SubmitTranscodeJobs API は TranscodeTaskId を返します。GetTranscodeTask API を呼び出して、タスクのステータス、出力ビデオの URL、およびその他の詳細をクエリします。
イベント通知
イベント通知を設定して、アップロードの成功やトランスコーディングジョブの完了など、メディア処理が完了したときに更新情報を受信します。これらの通知から、トランスコーディングのステータスと出力ビデオの URL を取得できます。設定手順については、「イベント通知」をご参照ください。
トランスコーディングに関連するイベントは次のとおりです：