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

# から親マニフェストからタグを削除する AWS Elemental MediaPackage
<a name="drm-query-param"></a>

親の MediaPackage シグナルは、HLS または CMAF エンドポイントのすべてのトラックタイプの`#EXT-X-SESSION-KEY`タグをマニフェストします。このタグにより、キーが複数のストリーム間で共有されるときに、再生デバイスがキーをプリフェッチできるようになります。トラックのサブセットのみを使用していて、親マニフェストで参照されるすべてのキーを必要としない場合など、このオプションのタグが不要な場合があります。SPEKE v2 では、親マニフェストからすべての`#EXT-X-SESSION-KEY `タグを削除するクエリパラメータをマニフェストリクエストに追加できます。各子マニフェストには復号キーを取得するための独自の`#EXT-X-KEY`タグがあるため、 `#EXT-X-SESSION-KEY `はしばしば過剰です。

MediaPackage マニフェストレスポンスから`#EXT-X-SESSION-KEY`タグを削除するには、次のクエリパラメータを使用します。 `aws.drmsettings=excludesessionkeys`

次のセクションでは、クエリパラメータの使用について詳しく説明します。

## クエリ構文
<a name="drm-params-syntax"></a>

`#EXT-X-SESSION-KEY` タグを削除するための基本クエリパラメータは で`aws.drmsettings`、オプションのパラメータ名と値のペアが続きます。クエリを作成するには、MediaPackage エンドポイント URL の末尾`?aws.drmsettings=`に を追加し、その後にパラメータ名と値を追加します。

Apple HLS フィルタクエリは次のようになります。

`https://example-mediapackage-endpoint.mediapackage.us-west-2.amazonaws.com/out/v1/examplemediapackage/index.m3u8?aws.drmsettings=excludesessionkeys`

次の表に、クエリ構文が表示されます。

**注記**  
Amazon CloudFront を CDN として使用する場合は、追加の設定が必要になる場合があります。詳細については、[「すべてのエンドポイントのキャッシュ動作を設定する](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/live-streaming.html#live-streaming-with-mediapackage-create-cache-behavior)」を参照してください。


| クエリ文字列のコンポーネント | 説明 | 
| --- | --- | 
| ? | クエリの先頭を示す制限された文字。 | 
| aws.drmsettings= | 名前と値のペアで構成されたパラメータが続くベースクエリ。 | 
| : | パラメータ名と値を関連付けるために使用されます。例えば、parameter\$1name:value などです。 | 
| ; | 複数のパラメータを含むクエリのパラメータを区切ります。例えば、parameter1\$1name:value;parameter2\$1name:minValue-maxValue。同じクエリのパラメータのリストで使用する場合、 ANDオペレーションを意味します。 | 

## エラー状態
<a name="error-conditions-and-handling-drm"></a>

一部の再生デバイスは、マニフェストまたはセグメントに無効なクエリパラメータまたは不明なクエリパラメータが含まれている場合、エラーを返します。MediaPackage が処理できるクエリパラメータは次のとおりです。
+ `m`
+ `start`
+ `end`
+ `aws.manifestfilter`
+ `aws.drmsettings`

リストされている以外のクエリパラメータがある場合は、Amazon CloudFront などの CDN を使用して不要なパラメータを削除します。詳細については、*Amazon CloudFront デベロッパーガイド*」の[「クエリ文字列パラメータに基づくコンテンツのキャッシュ](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/QueryStringParameters.html)」を参照してください。

次の表に、その他の一般的なエラー条件を示します。


****  

| エラー状態 | 例 | HTTP ステータスコード | 
| --- | --- | --- | 
| リストパラメータが見つからず、限定されたリストの一部でもない | ?aws.manifestfilter=audio\$1language:dahlia | 200 | 
| 字幕ストリームのみがストリームに存在している | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 200 | 
| フィルタパラメータが重複している | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=audio\$1sample\$1rate:0-48000 | 400 | 
| 無効なパラメータ | ?aws.manifestfilter=donut\$1type:rhododendron | 400 | 
| 無効な範囲パラメータ | ?aws.manifestfilter=audio\$1sample\$1rate:300-0 | 400 | 
| 無効な範囲値 (INT\$1MAX 以上) | ?aws.manifestfilter=audio\$1sample\$1rate:0-2147483648 | 400 | 
| 正しい形式でないクエリ文字列 | ?aws.manifestfilter=audio\$1sample\$1rate:is:0-44100 | 400 | 
| パラメータ文字列が 1024 文字を超えている | ?aws.manifestfilter=audio\$1language:abcdef.... | 400 | 
| HLS または CMAF ビットレートマニフェストのクエリパラメータ | index\$11.m3u8?aws.manifestfilter=video\$1codec:h264 | 400 | 
| セグメントリクエストのクエリパラメータ | ...\$11.[ts\$1mp4\$1vtt..]?aws.manifestfilter=video\$1codec:h264 | 400 | 
| 繰り返しクエリパラメータ | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=video\$1bitrate:0-1 | 400 | 
| フィルタを適用すると、空のマニフェストになる (コンテンツには、クエリ文字列で定義された条件を満たすストリームがない)。 | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 400 |