ストリーム バリエーション パラメータをオーバーライドする

ストリーム バリエーション パラメータのオーバーライドは必須ではありませんが、HLS 再生リストがリクエストされたときに、プレーヤーやアプリケーションが、バリエーションのデフォルト順序のオーバーライドを希望する場合に使用することができます。ユーザーのコンテンツ消費に応じて、特定の HLS バリエーションを他のものよりも優先する場合に役立ちます。

サーバーサイド ビーコン処理(SSB)IMA SDK のどちらを実装しても、プレーヤーまたはアプリからストリーム バリエーション順序パラメータを渡すことができます。

バリエーションの選択と順序をオーバーライドする

デフォルトの HLS 再生リストの順序はサイト運営者が指定します。

ストリーム作成中に指定されたバリエーションの選択パラメータと順序パラメータをオーバーライドして、マスター再生リストのリクエストへのレスポンスに含めるバリエーションのサブセットと、それらのバリエーションの順序を指定することができます。また、他のデフォルトの広告タグパラメータをオーバーライドすることもできます。

バリエーションのサブセットと順序は、ストリームのライフサイクル中はそのまま維持されます。ただし、クライアント側からこれらの値が明示的にオーバーライドされた場合(マスター再生リストを求める HTTP リクエストで新しい値が指定された場合)は、新しい値が使用されます。各パラメータは、IMA SDK を使用する際は「adTagParameters」構造の一部として、SSB を使用する際は追加の HTTP GET パラメータとして受け付けられます。

順序パラメータが指定されていない場合、再生リストは、サイト運営者によって返されたとおりに、元の順序で返されます。

バリエーションの選択をオーバーライドするストリーム パラメータ

パラメータ 説明
dai-ot
                         

dai-ov パラメータで指定された値のタイプを説明する順序タイプ情報。帯域幅を示す「bw」(最も近い一致)か、帯域幅と解像度(完全一致)をベースとする順序である必要があります。帯域幅または解像度を少なくとも 1 つ指定する必要があります。デフォルト値は「bw」です。

dai-ot パラメータが指定されていて dai-ov パラメータが指定されていない場合、再生リストは、元の順序ですべてのバリエーションを返します。

dai-ot=bw
dai-ot=bw_res
dai-ov

返されるメディア再生リストの順序を指定するカンマ区切りの値。dai-ot と組み合わせて使用します。各値は、dai-ot パラメータで記述されているタイプと同じタイプである必要があります。特別な値「audio」を使用して音声バリエーションを指定できます。

順序値が同じ複数のバリエーションがある場合(同じ帯域幅で解像度の異なる 2 つのバリエーションがある場合など)、それらのバリエーション間では元の順序が維持されます。

dai-ot=bw&dai-ov=2025837,1406061

dai-ot=bw_res&dai-ov=1400000:640x360,audio

dai-sr 返される動画バリエーションの帯域幅の範囲。特定の帯域幅より高いバリエーションをすべて選択するには、startBandwidth のみを指定します。特定の帯域幅より低いバリエーションをすべて選択するには、:endBandwidth(先頭にコロン「:」あり)のみを指定します。 dai-sr=1300000:2500000
dai-aor 返される音声バリエーションの帯域幅の範囲。特定の帯域幅より高いバリエーションをすべて選択するには、startBandwidth のみを指定します。特定の帯域幅より低いバリエーションをすべて選択するには、:endBandwidth(先頭にコロン「:」あり)のみを指定します。 dai-aor=60000
dai-os マスター再生リストの先頭に設定される動画バリエーションの帯域幅。値が startBandwidth に最も近いバリエーションが選択されます。最も近い値が高い値と低い値で 2 つある場合は、低い方の値が選択されます。このパラメータが指定されていて、dai-aor が指定されていない場合、音声のみのバリエーションはすべて除外されます。 dai-os=1700000
dai-excl 再生リストから除外するレンディション。subtitlesiframe がサポートされています。1 つの値またはカンマで区切った複数の値のリストを使用して、オーディオ コーデック、動画コーデック、音声や字幕の言語も除外できます。

dai-excl=subtitles
dai-excl=iframe


1 つのコーデック
dai-excl=codec:ec-3

複数のコーデック
dai-excl=codec:ec-3,codec:ac-3


1 つの言語の音声
dai-excl=audio-lang:en

1 つの言語の字幕
dai-excl=subtitle-lang:en

複数の選択
dai-excl=audio‑lang:en, audio-lang:es, subtitle-lang:en, subtitle-lang:es

例を表示

2 つのバリエーションを選択する

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai‑ot=bw&dai‑ov=2025837,1406061  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8  
1 つの音声バリエーションと 1 つの動画バリエーションを選択する

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai‑ot=bw&dai‑ov=audio,1406061  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8  
帯域幅と解像度を指定する

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai‑ot=bw_res&dai‑ov=1400000:640x360,audio  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8  
帯域幅の範囲を指定する

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8  
開始帯域幅を指定する

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8  
字幕を除外する

字幕を含む元のマニフェスト


#EXTM3U #EXT-X-VERSION:3 #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",AUTOSELECT=YES,URI="tt-en.m3u8" #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="de",NAME="Deutsch",AUTOSELECT=YES,URI="tt-de.m3u8" #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8" #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8  

リクエスト


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles  

レスポンス


#EXTM3U #EXT-X-VERSION:3 #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8" #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs" https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8  
コーデックを除外する

ac‑3、eac‑3 を含む元のマニフェスト


#EXTM3U #EXT‑X‑STREAM‑INF:BANDWIDTH=6107776,RESOLUTION=1920x1080,CODECS="avc1.640028,ec‑3",AUDIO="AUDIO‑EAC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6107776.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2212301,RESOLUTION=960x540,CODECS="avc1.640028,ec‑3",AUDIO="AUDIO‑EAC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2212301.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac‑3,avc1.640028",AUDIO="AUDIO‑AC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac‑3,avc1.640028",AUDIO="AUDIO‑AC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8 #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑eac3.m3u8",GROUP‑ID="AUDIO‑EAC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑ac3.m3u8",GROUP‑ID="AUDIO‑AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑aac.m3u8",GROUP‑ID="AUDIO‑AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES  

1 つのコーデックを除外する

リクエスト


http://truman.com/ssai/event/<event_code>/master.m3u8?dai‑excl=codec:ec‑3  

レスポンス


#EXTM3U #EXT‑X‑STREAM‑INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac‑3,avc1.640028",AUDIO="AUDIO‑AC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac‑3,avc1.640028",AUDIO="AUDIO‑AC3" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8 #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑ac3.m3u8",GROUP‑ID="AUDIO‑AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑aac.m3u8",GROUP‑ID="AUDIO‑AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES  

複数のコーデックを除外する

リクエスト


http://truman.com/ssai/event/<event_code>/master.m3u8?dai‑excl=codec:ec‑3,codec:ac‑3  

レスポンス


#EXTM3U #EXT‑X‑STREAM‑INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8 #EXT‑X‑STREAM‑INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO‑AAC" https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8 #EXT‑X‑MEDIA:TYPE=AUDIO,URI="audio‑aac.m3u8",GROUP‑ID="AUDIO‑AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES  
この情報は役に立ちましたか?
改善できる点がありましたらお聞かせください。