本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從父資訊清單移除標籤 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`，後面接著選用的參數名稱和值對。若要建構查詢，請附加`?aws.drmsettings=`至 MediaPackage 端點 URL 的結尾，後面接著參數名稱和值。

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)。


| 查詢字串元件 | Description | 
| --- | --- | 
| ? | 標記查詢開頭的限制字元。 | 
| 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 |