기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 의 상위 매니페스트에서 태그 제거 AWS Elemental MediaPackage
상위의 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`
다음 섹션에서는 쿼리 파라미터 사용에 대한 자세한 정보를 제공합니다.
## 쿼리 구문
`#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 작업을 암시합니다. |
## 오류 조건
매니페스트 또는 세그먼트에 유효하지 않거나 알 수 없는 쿼리 파라미터가 포함된 경우 일부 재생 디바이스는 오류를 반환합니다. 다음은 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 |