セッション制御用の MediaTailor サービス変数

AWS Elemental MediaTailor は、セッションレベルの動作を制御するサービス変数のaws.クエリパラメータ名前空間を予約します。ads. パラメータ (ADS に転送される) およびmanifest.パラメータ (パーソナライズされたマニフェスト URLs に追加される) とは異なり、aws.パラメータは MediaTailor によって直接消費され、オリジンサーバーまたは ADS に転送されません。

サポートされているパラメータ

次の表に、セッションレベルの動作を制御するために使用できるaws.*パラメータを示します。

aws.startTime

が設定されている場合、MediaTailor aws.startTimeは指定されたプログラム日時に最も近いセグメント境界でセッションを開始します。

使用方法

マニフェストリクエストでクエリパラメータaws.startTimeとして を渡します。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z

または、明示的なセッション初期化では、 aws. プレフィックスなしで最上位フィールドとして渡します。

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "startTime": "2026-06-17T10:00:00Z"
}

要件

には、次の要件が適用されますaws.startTime。

動作

次の表は、さまざまなシナリオでの aws.startTime の動作を示しています。

クランプ動作

セッション中に開始ポイントが DVR ウィンドウから経過すると、 EXT-X-STARTはウィンドウヘッドから 3 xtargetDuration に固定されます。3×targetDuration バッファは、RFC 8216 §6.3.3 プレイヤーバッファリングの推奨事項と一致しています。

#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES
#EXT-X-MEDIA-SEQUENCE:500
#EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z
#EXTINF:6.006,
segment500.ts
#EXTINF:6.006,
segment501.ts
...

制限事項

以下の制限が適用されます。

aws.preroll

の場合aws.preroll=disabled、MediaTailor は、再生設定に がある場合でも、セッションのプレロール広告挿入を抑制しますLivePreRollConfiguration。

使用方法

マニフェストリクエストでクエリパラメータaws.prerollとして を渡します。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled

または、明示的なセッション初期化では、 aws. プレフィックスなしで最上位フィールドとして渡します。

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "preroll": "disabled"
}

要件

には、次の要件が適用されますaws.preroll。

動作

次の表は、 aws.prerollの動作を示しています。

制限事項

セッションの初期化後にこのパラメータを変更することはできません。

aws.overlayAvails

の場合aws.overlayAvails=off、MediaTailor はソースマニフェストのオーバーレイ (非線形) 広告マーカーを無視し、セッションのオーバーレイ広告を挿入しません。

使用方法

マニフェストリクエストでクエリパラメータaws.overlayAvailsとして を渡します。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off

要件

には、次の要件が適用されますaws.overlayAvails。

動作

次の表は、 aws.overlayAvailsの動作を示しています。

制限事項

セッションの初期化後にこのパラメータを変更することはできません。

aws.logMode

の場合aws.logMode=DEBUG、MediaTailor はセッションの詳細デバッグログ記録を有効にします。デバッグログは CloudWatch Logs に出力され、マニフェストのパーソナライゼーション、広告決定サーバーのリクエスト、セッション状態に関する詳細情報を提供します。これは、広告挿入の問題のトラブルシューティングに役立ちます。

使用方法

マニフェストリクエストでクエリパラメータaws.logModeとして を渡します。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG

要件

には、次の要件が適用されますaws.logMode。

動作

次の表は、 aws.logModeの動作を示しています。

制限事項

以下の制限が適用されます。

aws.availSuppressionMode

ライブエッジに対する広告表示の位置に基づいて広告表示が抑制されるかどうかを制御します。これを使用して、ライブエッジの前後の時間枠内にある広告時間枠をスキップします。たとえば、イベント中にライブストリームに参加したときにビューワーが既に通過した広告時間枠を埋めないようにします。

使用方法

マニフェストリクエストで avail 抑制パラメータをクエリパラメータとして渡します。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

このパラメータは、次の 2 つのコンパニオンパラメータで機能します。

要件

表示抑制パラメータには、次の要件が適用されます。

モードの動作

次の表に、各抑制モードの効果を示します。

フィルポリシー (AFTER_LIVE_EDGE のみ)

次の表は、モードが の場合のフィルポリシーの動作を示していますAFTER_LIVE_EDGE。

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

制限事項

以下の制限が適用されます。