ADS およびオリジンの MediaTailor パラメータルーティング - AWS Elemental MediaTailor
オリジンサーバーパラメータの動作

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ADS およびオリジンの MediaTailor パラメータルーティング

AWS Elemental MediaTailor は、プレフィックスと目的に基づいてクエリパラメータをさまざまな宛先にルーティングします。MediaPackage でのタイムシフト表示などのオリジン固有の機能を実装するには、パラメータルーティングを理解することが重要です。

パラメータルーティングルール

MediaTailor は、クエリパラメータに次のルーティングルールを使用します。

  • オリジンパラメータ (プレフィックスなし): 特定のプレフィックスのないパラメータは、オリジン固有の機能のためにオリジンサーバーに渡されます。

  • ADS パラメータ (ads. プレフィックス): プレフィックスが付いたパラメータads.が広告決定サーバーに送信されます

  • マニフェストパラメータ (manifest. プレフィックス): プレフィックスが付いたパラメータmanifest.は CDN ルーティングと認可に使用されます

例 パラメータルーティングの例

次のセッション初期化は、パラメータルーティングを示しています。

POST /v1/session/123456789/originId/index.m3u8
{
    "adsParams": {
        "param1": "value1",
        "param2": "value2"
    },
    "manifestParams": {
        "auth_token": "abc123"
    }
}

この例では、以下のようになっています：

  • param1 と param2は ADS に送信されます。

  • auth_token は CDN ルーティングと認可に使用されます

  • プレフィックスのないパラメータはオリジンサーバーに渡されます

オリジンサーバーパラメータの動作

オリジンサーバーに渡されるパラメータは、タイムシフト表示、コンテンツフィルタリング、認証などのオリジン固有の機能を有効にします。

一般的なオリジンパラメータのユースケース

オリジンパラメータは一般的に以下に使用されます。

  • タイムシフト表示： MediaPackage タイムシフトコンテンツの startおよび endパラメータ

  • コンテンツ認証： オリジンサーバーに必要な認証トークン

  • コンテンツフィルタリング： 返されるコンテンツバリアントを制御するパラメータ

  • オリジン固有の機能： オリジンサーバーがコンテンツ処理に使用するパラメータ

重要

パラメータはセッションの初期化時に処理され、セッション全体で維持されます。タイムシフトウィンドウなどのパラメータを変更するには、更新された値で新しいセッションを作成する必要があります。