翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# HLS ソースの統合
AWS Elemental MediaTailor は、ライブストリーミングとビデオオンデマンド (VOD) の `EXT-X-VERSION``3`以上の `.m3u8` HLS マニフェストをサポートします。MediaTailor が広告ブレークに到達すると、コンテンツのタイプに基づいて広告の挿入または置き換えを試みます。その継続時間を埋めるために十分な広告がない場合、MediaTailor は基盤となるコンテンツストリーム、または設定されたスレートを表示します。コンテンツのタイプに基づいた HLS 広告動作の詳細については、「[AWS Elemental MediaTailor 広告挿入動作について](ad-behavior.md)」を参照してください。
以下のセクションでは、Mediatailor が HLS マニフェストを処理する方法について詳しく説明します。
**Topics**
+ [HLS 対応の広告マーカー](hls-ad-markers.md)
+ [広告マーカーパススルーの有効化](ad-marker-passthrough.md)
+ [HLS マニフェストタグの処理](manifest-hls-tags.md)
+ [HLS マニフェストの例](manifest-hls-example.md)
# HLS 対応の広告マーカー
AWS Elemental MediaTailor は、サポートされている広告マーカーの入力マニフェストを解析することで、HLS マニフェスト内の広告表示境界を識別します。以下のセクションでは、MediaTailor が使用するマーカーについて説明します。
## EXT-X-ASSET
`EXT-X-ASSET` タグには、視聴者のコンテンツをパーソナライズするために広告決定サーバー (ADS) により使用されるメタデータが含まれています。`EXT-X-ASSET` パラメータは、カンマで区切られたキーと値のペアです。
このタグを使用するには、以下の要件を満たしている必要があります。
+ オリジンマニフェストの `EXT-X-ASSET` *値*を URL エンコードする必要があります。次の例は、キーと URL エンコードされた値を持つ `EXT-X-ASSET` タグを示しています。
```
#EXT-X-ASSET:GENRE=CV,CAID=12345678,EPISODE="Episode%20Name%20Date",SEASON="Season%20Name%20and%20Number",SERIES="Series%2520Name"
```
+ MediaTailor ADS 設定には、動的 `[asset.]` 変数と*キー*を含める必要があります。以下は、動的 `[asset.]` 変数とキーを使用した MediaTailor ADS 設定の例です。
```
https://myads.com/stub?c=[asset.GENRE]&g=[asset.CAID]&e=[asset.EPISODE]&s=[asset.SEASON]&k=[asset.SERIES]
```
**VAST リクエストの例**
次の例は、ADS に対する VAST `GET` リクエストを示しています。
```
https://myads.com/stub?c=CV&g=12345678&e=Episode%20Name%20Date&s=Season%20Name%20and%20Number&k=Series%2520Name
```
## EXT-X-CUE-OUT および EXT-X-CUE-IN
このタイプの広告マーカーは最も一般的です。次の例は、このようなキューマーカーのオプションを示しています。
```
#EXT-X-CUE-OUT:DURATION=120
...
#EXT-X-CUE-IN
```
```
#EXT-X-CUE-OUT:30.000
...
#EXT-X-CUE-IN
```
```
#EXT-X-CUE-OUT
...
#EXT-X-CUE-IN
```
## EXT-X-DATERANGE
`EXT-X-DATERANGE` 広告マーカータグでは、`SCTE35-OUT` 属性を使用して、ad avail のタイミングを指定します。
**注記**
AWS Elemental MediaTailor は、`EXT-X-DATERANGE`広告マーカーに指定された`START-DATE`属性を無視します。
Ad avail は、次のいずれかの方法で指定できます。
+ `SCTE35-OUT` および `DURATION` 仕様の `EXT-X-DATERANGE` タグ。
例
```
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2019-01T00:15:00Z\",DURATION=60.000,SCTE35-OUT=0xF
```
+ ペアリングされた `EXT-X-DATERANGE` タグ (`SCTE35-OUT` 仕様と `SCTE35-IN` 仕様)。
例
```
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2019-01T00:15:00Z\",SCTE35-OUT=0xF
...
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2019-01T00:15:00Z\",SCTE35-IN=0xF
```
+ 以前のオプションの組み合わせ。仕様が `SCTE35-OUT` と `DURATION` の `EXT-X-DATERANGE` タグ、その後に`SCTE35-IN` 仕様の `EXT-X-DATERANGE` タグが続きます。この場合、MediaTailor は 2 つの仕様のうち最も早いキューイン設定を使用します。
例
```
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2019-01T00:15:00Z\",DURATION=60.000,SCTE35-OUT=0xF
...
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2019-01T00:15:00Z\",SCTE35-IN=0xF
```
## EXT-X-SPLICEPOINT-SCTE35
SCTE-35 ペイロードを含む `EXT-X-SPLICEPOINT-SCTE35` 広告マーカータグを base64 エンコードのバイナリで追加します。デコードされたバイナリで、プロバイダー配置機会を開始するキューアウトマーカー `0x34` と、プロバイダー配置機会を終了するキューインマーカー `0x35` を含む SCTE-35 `splice_info_section` を示す必要があります。
次の例は、キューアウトマーカーとキューインマーカーを指定する base64 エンコードのバイナリペイロードを含むスプライスポイントの仕様を示しています。
```
#EXT-X-SPLICEPOINT-SCTE35:/DA9AAAAAAAAAP/wBQb+uYbZqwAnAiVDVUVJAAAKqX//AAEjW4AMEU1EU05CMDAxMTMyMjE5M19ONAAAmXz5JA==
...
#EXT-X-SPLICEPOINT-SCTE35:/DA4AAAAAAAAAP/wBQb+tTeaawAiAiBDVUVJAAAKqH+/DBFNRFNOQjAwMTEzMjIxOTJfTjUAAIiGK1s=
```
# 広告マーカーパススルーの有効化
HLS の場合、デフォルトで MediaTailor のパーソナライズされたマニフェストにオリジンマニフェストからの SCTE-35 広告マーカーが含まれません。広告マーカーのパススルーが有効になっていると、MediaTailor がオリジンマニフェストからの以下の広告マーカーをパーソナライズされたマニフェストにパススルーします。
+ EXT-X-CUE-IN
+ EXT-X-CUE-IN
+ EXT-X-SPLICEPOINT-SCTE35
広告マーカーのパススルーはオプションの設定です。広告マーカーのパススルーは、MediaTailor のパーソナライズされたマニフェストに SCTE 広告マーカーを含めたい場合に使用します。一般的なユースケースには以下が含まれます。
+ コンテンツ置換 - コンテンツの置き換え、またはコンテンツの制限を実行します。
+ 広告追跡 - 1 つ、または複数の広告マーカーの存在または欠如に基づいて、広告追跡情報をトリガーします。
+ プレイヤー設定 - 広告マーカーの存在または欠如に基づいて、プレイヤーの UI でスクラブ機能またはカウントダウンタイマー機能を有効にします。
**注記**
MediaTailor は、これらのマーカーの値を変更しません。例えば、オリジンマニフェストの `EXT-X-CUE-OUT` の値が `60` になっているのに広告が配置されていないという場合でも、MediaTailor はパーソナライズされたマニフェストの値を `0` に変更しません。
## 広告マーカーのパススルーを有効にする
広告マーカーのパススルーは、 AWS マネジメントコンソール または AWS Command Line Interface () を使用して有効にできますAWS CLI。
**コンソールを使用して広告マーカーのパススルーを有効にする**
1. MediaTailor コンソール ([https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)) を開きます。
1. **[New Configuration]** (新しい設定) または **[Edit Configuration]** (設定を編集) をクリックします。
1. **[Advanced Settings]** (アドバンスト設定) セクションで、ドロップダウンメニューから **[Enable]** (有効) を選択します。
**AWS Command Line Interface (AWS CLI) を使用して広告マーカーのパススルーを有効にするには**
[put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html) コマンドを使用します。
# HLS マニフェストタグの処理
このセクションでは、 がパーソナライズされた出力マニフェストでタグ AWS Elemental MediaTailor を管理する方法について説明します。
## EXT-X-CUE タグ
MediaTailor は、入力マニフェスト内の `EXT-X-CUE-OUT`、`EXT-X-CUE-OUT-CONT`、および `EXT-X-CUE-IN` タグを、出力マニフェスト内の `EXT-X-DISCONTINUITY` タグに置き換えます。`DISCONTINUITY` タグは次の境界をマークします。
+ メインコンテンツが広告に移行する場所
+ ある広告から別の広告に遷移する場所
+ 広告がメインコンテンツに戻る場所
## EXT-X-DATERANGEタグ
MediaTailor は、入力マニフェストからの `EXT-X-DATERANGE` タグを出力マニフェストにパススルーします。MediaTailor は、`DATERANGE` タグに対応する `EXT-X-DISCONTINUITY` タグも挿入します。`DISCONTINUITY` タグは次の境界をマークします。
+ メインコンテンツが広告に移行する場所
+ ある広告から別の広告に遷移する場所
+ 広告がメインコンテンツに戻る場所
## EXT-X-KEYタグ
MediaTailor は、入力マニフェストからの `EXT-X-KEY` タグをパススルーします。これらのタグは、メインコンテンツが暗号化されていることを示します。広告は暗号化されていないため、MediaTailor は ad avail の開始時点に `EXT-X-KEY:METHOD=NONE` を挿入します。再生がメインコンテンツに戻ると、MediaTailor は、暗号化タイプとして定義された `METHOD` 値と共に `EXT-X-KEY` タグを挿入して暗号化を再度有効にします。
## 認識されないタグ
MediaTailor は、入力マニフェストからのすべての不明なタグとカスタムタグを出力マニフェストにパススルーします。
# HLS マニフェストの例
以下のセクションでは、HLS オリジンマニフェストとパーソナライズされたマニフェストの例を示します。これらの例を理解することは、MediaTailor ワークフローの設定とトラブルシューティングに役立ちます。
クエリパラメータを HLS マニフェストとセグメントに適用する方法については、「」を参照してください[MediaTailor HLS 暗黙的なセッションの初期化](manifest-query-parameters-hls-implicit-session-initialization.md)。
## HLS プレイリストタイプについて
HTTP Live Streaming (HLS) は、主に 2 種類のプレイリストを使用します。
マルチバリアントプレイリスト
多変量プレイリストは、コンテンツの使用可能なすべてのレンディションを一覧表示する最上位インデックスファイルです。メディアプレイリストへの参照が含まれていますが、メディアセグメント自体は含まれません。このプレイリストにより、プレイヤーはネットワーク条件、デバイス機能、またはユーザー設定に基づいて最適なレンディションを選択できます。
このプレイリストタイプは、マスタープレイリスト、マスターマニフェスト、プライマリプレイリスト、メインプレイリスト、インデックスファイル、マスター M3U8 など、さまざまなコンテキストの他のいくつかの名前でも知られています。
MediaTailor ワークフローでは、多変量プレイリストは再生リクエストのエントリポイントであり、広告パーソナライゼーションが開始される場所です。
メディアプレイリスト
メディアプレイリストには、コンテンツの特定のレンディション (品質レベル) の実際のメディアセグメント情報が含まれます。これには、1 つのレンディションの再生に必要なタイミング情報、セグメント URLs、およびその他のメタデータが含まれます。
このプレイリストタイプは、メディアプレイリスト、子マニフェスト、チャンクリスト、メディア M3U8、レンディションプレイリストとも呼ばれます。
MediaTailor ワークフローでは、メディアプレイリストは、コンテンツセグメントと広告セグメントの両方を適切なシーケンスに含めるようにパーソナライズされます。
HLS プレイリストタイプの詳細については、「」を参照してください[HLS プレイリストタイプ](hls-playlist-types.md)。
## HLS オリジンマニフェストの例
次の例は、HLS が AWS Elemental MediaTailor コンテンツオリジンから受信した HLS マルチバリアントプレイリストを示しています。
```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-STREAM-INF:BANDWIDTH=2665726,AVERAGE-BANDWIDTH=2526299,RESOLUTION=960x540,FRAME-RATE=29.970,CODECS="avc1.640029,mp4a.40.2",SUBTITLES="subtitles"
index_1.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3956044,AVERAGE-BANDWIDTH=3736264,RESOLUTION=1280x720,FRAME-RATE=29.970,CODECS="avc1.640029,mp4a.40.2",SUBTITLES="subtitles"
index_2.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=995315,AVERAGE-BANDWIDTH=951107,RESOLUTION=640x360,FRAME-RATE=29.970,CODECS="avc1.4D401E,mp4a.40.2",SUBTITLES="subtitles"
index_3.m3u8
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles",NAME="caption_1",DEFAULT=YES,AUTOSELECT=YES,FORCED=NO,LANGUAGE="eng",URI="index_4_0.m3u8"
```
この多変量プレイリストの例:
+ `#EXT-X-STREAM-INF` タグは、解像度とビットレートが異なるさまざまなレンディションを定義します。
+ 各レンディションはメディアプレイリストを参照します ( など`index_1.m3u8`)
+ `#EXT-X-MEDIA` タグは字幕トラックを定義します
次の例は、コンテンツオリジンから HLS が AWS Elemental MediaTailor 受信した HLS メディアプレイリストを示しています。この例では、`EXT-X-CUE-OUT` タグと `EXT-X-CUE-IN` タグを使用して、ad avail 機会を表しています。
```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:8779957
#EXTINF:6.006,
index_1_8779957.ts?m=1566416212
#EXTINF:6.006,
index_1_8779958.ts?m=1566416212
#EXTINF:5.372,
index_1_8779959.ts?m=1566416212
#EXT-OATCLS-SCTE35:/DAlAAAAAsvhAP/wFAXwAAAGf+/+AdLfiP4AG3dAAAEBAQAAXytxmQ==
#EXT-X-CUE-OUT:20.020
#EXTINF:0.634,
index_1_8779960.ts?m=1566416212
#EXT-X-CUE-OUT-CONT:ElapsedTime=0.634,Duration=21,SCTE35=/DAlAAAAAsvhAP/wFAXwAAAGf+/+AdLfiP4AG3dAAAEBAQAAXytxmQ==
#EXTINF:6.006,
index_1_8779961.ts?m=1566416212
#EXT-X-CUE-OUT-CONT:ElapsedTime=6.640,Duration=21,SCTE35=/DAlAAAAAsvhAP/wFAXwAAAGf+/+AdLfiP4AG3dAAAEBAQAAXytxmQ==
#EXTINF:6.006,
index_1_8779962.ts?m=1566416212
#EXT-X-CUE-OUT-CONT:ElapsedTime=12.646,Duration=21,SCTE35=/DAlAAAAAsvhAP/wFAXwAAAGf+/+AdLfiP4AG3dAAAEBAQAAXytxmQ==
#EXTINF:6.006,
index_1_8779963.ts?m=1566416212
#EXT-X-CUE-OUT-CONT:ElapsedTime=18.652,Duration=21,SCTE35=/DAlAAAAAsvhAP/wFAXwAAAGf+/+AdLfiP4AG3dAAAEBAQAAXytxmQ==
#EXTINF:1.368,
index_1_8779964.ts?m=1566416212
#EXT-X-CUE-IN
#EXTINF:4.638,
index_1_8779965.ts?m=1566416212
#EXTINF:6.006,
index_1_8779966.ts?m=1566416212
#EXTINF:6.006,
index_1_8779967.ts?m=1566416212
#EXTINF:6.006,
index_1_8779968.ts?m=1566416212
```
このメディアプレイリストの例:
+ `#EXTINF` タグは各セグメントの期間を指定します
+ `#EXT-X-CUE-OUT` タグは広告時間枠の開始を示します
+ `#EXT-X-CUE-OUT-CONT` タグは、進行中の広告時間枠に関する情報を提供します。
+ `#EXT-X-CUE-IN` タグは広告時間枠の終了を示します
## HLS のパーソナライズされたマニフェストの例
次の例は、パーソナライズされた AWS Elemental MediaTailor HLS マルチバリアントプレイリストを示しています。
```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:LANGUAGE="eng",AUTOSELECT=YES,FORCED=NO,TYPE=SUBTITLES,URI="../../../manifest/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/3.m3u8",GROUP-ID="subtitles",DEFAULT=YES,NAME="caption_1"
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-STREAM-INF:CODECS="avc1.640029,mp4a.40.2",AVERAGE-BANDWIDTH=2526299,RESOLUTION=960x540,SUBTITLES="subtitles",FRAME-RATE=29.97,BANDWIDTH=2665726
../../../manifest/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0.m3u8
#EXT-X-STREAM-INF:CODECS="avc1.640029,mp4a.40.2",AVERAGE-BANDWIDTH=3736264,RESOLUTION=1280x720,SUBTITLES="subtitles",FRAME-RATE=29.97,BANDWIDTH=3956044
../../../manifest/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/1.m3u8
#EXT-X-STREAM-INF:CODECS="avc1.4D401E,mp4a.40.2",AVERAGE-BANDWIDTH=951107,RESOLUTION=640x360,SUBTITLES="subtitles",FRAME-RATE=29.97,BANDWIDTH=995315
../../../manifest/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/2.m3u8
```
MediaTailor がメディアプレイリスト URLs を変更して、パーソナライズされた広告挿入を可能にするセッション固有の情報を含める方法に注目してください。
次の例は、パーソナライズされた AWS Elemental MediaTailor メディアプレイリストを示しています。
```
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:8779957
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779957.ts?m=1566416212
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779958.ts?m=1566416212
#EXTINF:5.372,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779959.ts?m=1566416212
#EXT-X-DISCONTINUITY
#EXTINF:3.066667,
../../../../segment/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0/8779960
#EXTINF:3.0,
../../../../segment/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0/8779961
#EXTINF:3.0,
../../../../segment/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0/8779962
#EXTINF:3.0,
../../../../segment/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0/8779963
#EXTINF:2.966667,
../../../../segment/43f3e412052f2808dd84ea1da90e92e914edddee/external-canary-hls/ee1696a8-4f7f-4c4c-99de-9821131847e8/0/8779964
#EXT-X-DISCONTINUITY
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779963.ts?m=1566416212
#EXTINF:1.368,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779964.ts?m=1566416212
#EXTINF:4.638,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779965.ts?m=1566416212
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779966.ts?m=1566416212
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779967.ts?m=1566416212
#EXTINF:6.006,
https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/e309ffd02ba8498d864dcaacff7a5ad9/index_1_8779968.ts?m=1566416212
```
このパーソナライズされたメディアプレイリストの例:
+ MediaTailor がコンテンツセグメント間に広告セグメントを挿入しました
+ `#EXT-X-DISCONTINUITY` タグはコンテンツと広告間の遷移をマークします
+ コンテンツセグメントはオリジンサーバーから提供されます (この例では MediaPackage)
+ 広告セグメントは MediaTailor の広告セグメントストレージから提供されます
## パーソナライズされたマニフェストの主な違い
MediaTailor が HLS マニフェストをパーソナライズすると、いくつかの重要な変更が行われます。
多変量プレイリストの変更
+ バリアントプレイリスト URLsは、セッション情報を含む MediaTailor が管理する URLsられます。
+ タグの順序は、最適な再生のために再編成できます。
バリアントプレイリストの変更
+ 広告マーカー (`EXT-X-CUE-OUT`、`EXT-X-CUE-IN`) は実際の広告セグメントに置き換えられます
+ コンテンツ/広告の境界に不連続マーカー (`EXT-X-DISCONTINUITY`) が追加される
+ コンテンツセグメント URLsがオリジンまたは CDN を指すように書き換えられる
+ MediaTailor URLs広告セグメントストレージを指すように広告セグメント URL が追加されます
これらの変更を理解することで、MediaTailor ワークフローの問題をトラブルシューティングし、CDN とプレイヤーを適切に設定することができます。
## 関連トピック
HLS マニフェストと MediaTailor の詳細については、以下のトピックを参照してください。
+ [HLS プレイリストタイプ](hls-playlist-types.md) - HLS プレイリストタイプの詳細な説明
+ [CDN を使用して MediaTailor の広告パーソナライゼーションとコンテンツ配信を最適化する](integrating-cdn.md) - MediaTailor での CDN の使用に関する情報
+ [MediaTailor 広告挿入の仕組み](what-is-flow.md) - MediaTailor 広告挿入の仕組みの概要