Drive and Photo Service:メディア トランスコーディング

機能概要

PDS のメディア トランスコーディング機能は、テンプレートを使用してオーディオ ファイルとビデオ ファイルをトランスコードするドメイン固有の機能です。 ドメイン内の同じメディア ファイルは、テンプレートに基づいて 1 回だけトランスコードされます。 ハッシュ値が同じファイルは、同じメディア ファイルと見なされます。 これにより、プレビュー エクスペリエンスが向上し、コストを削減できます。

さまざまなビジネス シナリオの要件を満たすために、PDS は、オフライン トランスコーディング (offline_video または offline_audio)、ライブ トランスコーディング (live_transcoding)、クイック トランスコーディング (quick_video) などのトランスコーディング タイプをサポートしています。 オフライン トランスコーディングは、オーディオ ファイルとビデオ ファイルのオフライン処理用に設計されており、オーディオ ファイルとビデオ ファイルのさまざまな形式変換をサポートしています。 ライブ トランスコーディングとクイック トランスコーディングは、リアルタイム ビデオ ストリーミング用に設計されており、低レイテンシと高いリアルタイム パフォーマンス要件に対応します。

オフライン トランスコーディングでは、完全なメディア ファイルを別のファイルにトランスコードできます。 このトランスコーディング タイプは、高い互換性を備えており、ほとんどのトランスコーディング パラメータをサポートしています。 ただし、トランスコーディングが完了する前にプレビュー URL を取得することはできません。

ライブ トランスコーディング 2.0 とクイック トランスコーディングは、トランスコーディング タスクを次のサブタスクに分割します。プレイリストを生成するためのサブタスクと、複数のセグメントをトランスコードするためのサブタスクです。 これにより、トランスコーディング結果をすばやくプレビューできます。 ビデオがアップロードされ、トランスコーディング情報が取得されると、プレイリストを生成するためのサブタスクはすぐに完了し、プレビュー URL を取得できます。 プレビュー URL を使用してプレーヤーでビデオを再生する場合、トランスコーディングが完了していれば、再生はすぐに開始できます。 トランスコーディングが完了していない場合は、再生されるセグメントが対応するトランスコーディング サブタスクによってトランスコードされた後に再生が開始されます。これには通常 10 秒もかかりません。 再生中にトランスコードされていないセグメントをシークする場合、セグメントがトランスコードされるまで数秒待つだけで済みます。 クイック トランスコーディングと比較して、早期に開始されたライブ トランスコーディングには、一部のプレーヤーで再生シーク中にバッファリング時間が長くなるという欠点があります。 したがって、現在はクイック トランスコーディングのみがサポートされています。 ライブ トランスコーディングを有効にしているお客様には、ライブ トランスコーディングからクイック トランスコーディングへの移行を支援するシームレスな移行ソリューションが提供されています。 詳細については、「ライブ トランスコーディングからクイック トランスコーディングへの移行」をご参照ください。

次の図は、PDS のメディア トランスコーディング ロジックを示しています。これは、トランスコーディング情報の確認、トランスコーディング テンプレートの選択、トランスコーディング タスクの開始という 3 つの主要な手順で構成されています。

トランスコーディング テンプレートを選択するロジックは、メディア タイプによって異なります。 PDS は、ドメインに設定されているすべてのテンプレートを使用してオーディオ ファイルをトランスコードします。 次の表に、オフライン オーディオ トランスコーディングのデフォルト テンプレートを示します。

デフォルトでは、PDS は元のビデオの解像度に基づいてビデオ ファイルのトランスコーディング テンプレートを選択します。 解像度が元のビデオの解像度よりも低いすべてのテンプレートと、解像度が元のビデオの解像度以下ではない最初のテンプレートが選択されます。 PDS がビデオ ファイルのトランスコーディング テンプレートを選択する場合、PDS は最初に元のビデオの幅と高さを交換して、ビデオの幅がビデオの高さ以上になるようにします。 交換後、ビデオの幅または高さがテンプレートの幅または高さよりも大きい場合、元のビデオの解像度はテンプレートの解像度よりも大きいと見なされます。 PDS が解像度が元のビデオの解像度以下ではないテンプレートに基づいてビデオをトランスコードする場合、トランスコーディング中に元のビデオの解像度が使用されます。 keep_original_resolution フィールドは、元のビデオの解像度が保持されているかどうかを示すためにプレビュー URL に追加されます。

たとえば、ドメインに設定されているテンプレートの解像度が 720 × 480、1280 × 720、1920 × 1080 で、元のビデオの解像度が 540 × 720 の場合、解像度が 720 × 480 と 1280 × 720 のテンプレートが選択され、トランスコードされたビデオの解像度は 720 × 480 と 720 × 540 になります。 次の表に、3 つのビデオ トランスコーディング タイプすべてのデフォルトのビデオ トランスコーディング テンプレートを示します。

デフォルトのテンプレートとテンプレート選択ポリシーがビジネス要件を満たしていない場合は、お問い合わせいただき、テンプレートとテンプレート選択ポリシーをカスタマイズしてください。(PDS Enterprise Edition では、カスタム テンプレートまたはテンプレート選択ポリシーはサポートされていません。) 次の表に、PDS でサポートされているテンプレート パラメータを示します。

メディアトランスコード機能を有効にする

デフォルトでは、PDS Enterprise Edition でクイックトランスコードとオフライン トランスコード 機能が有効になっています。

PDS Developer Edition でメディア トランスコード 機能を有効にする場合は、公式 DingTalk グループに参加してご連絡ください。メディア トランスコード 機能の有効化は無料ですが、この機能を使用すると料金が発生します。詳細については、「付加価値機能の課金対象項目」をご参照ください。

オーディオまたはビデオ ファイルのアップロード

トランスコード用に新しいオーディオまたはビデオ ファイルをアップロードしたり、既存のメディア ファイルをトランスコードしたりできます。 トランスコード結果を取得するために必要な、元のメディア ファイルのドライブ ID とファイル ID を取得する必要があります。

メディア トランスコードに関する情報を取得する

/v2/file/get_video_preview_play_info 操作を呼び出します。トランスコード タイプを、クイック トランスコードなど、ドメインで有効になっているトランスコード機能に設定します。 template_id パラメーターを、使用するテンプレートの ID（例：264_480p）に設定します。この方法で、指定されたテンプレートに基づいてトランスコードされたファイルの再生情報を取得できます。テンプレート ID を指定しない場合は、すべてのトランスコードされたファイルの再生情報が返されます。トランスコードが完了していない場合は、状態コード 202 VideoPreviewWaitAndRetry が返されます。トランスコードが完了すると、プレビュー URL が URL フィールドに返されます。

サンプル リクエスト

{
    "drive_id": "1",
    "file_id": "abcd", // メディア ファイルの ID。
    "category": "quick_video", // トランスコード タイプ。
    "template_id": "264_480p"       // プレビューするファイルのトランスコードに使用するテンプレートの ID。
}

サンプル 応答

1. リトライ待機中の応答

{
  "Code": "VideoPreviewWaitAndRetry",
  "Message": "メディアはトランスコード中です。しばらく待ってから再試行してください。 xxx"
}

2. ビデオ トランスコード失敗の応答

   {
     "Code": "NotFound.VideoPreviewInfo",
     "Message": "ErrVideoPreviewLastErrorExist"
   }

3. オフライン ビデオ トランスコードの応答

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd", // ビデオ ファイルの ID。
    "video_preview_play_info": {
        "category": "offline_video", // トランスコード タイプ。
        // その他のビデオ情報。
        "offline_video_transcoding_list": [
            {
                "template_id": "264_480p", // テンプレート ID。
                "status": "finished" // トランスコード タスクは完了です。
                "url": "https://example.aliyundoc.com/c/d?e=f...", // プレビュー URL。
            }
        ]
    }
}

4. オフライン オーディオ トランスコードの応答

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd", // オーディオ ファイルの ID。
    "video_preview_play_info": {
        "category": "offline_audio", // トランスコード タイプ。
        // その他のオーディオ情報。
        "offline_audio_list": [
            {
                "template_id": "264_480p", // テンプレート ID。
                "status": "finished" // トランスコード タスクは完了です。
                "url": "https://example.aliyundoc.com/c/d?e=f...", // プレビュー URL。
            }
        ]
    }
}

5. クイック トランスコードの応答

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd", // ビデオ ファイルの ID。
    "video_preview_play_info": {
        "category": "quick_video", // トランスコード タイプ。
        // その他のビデオ情報。
        "quick_video_list": [
            {
                "template_id": "264_480p", // テンプレート ID。
                "status": "finished" // プレイリストが生成されました。
                "url": "https://example.aliyundoc.com/c/d?e=f...", // プレビュー URL。
            }
        ]
    }
}