As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Removendo tags do manifesto principal de AWS Elemental MediaPackage
<a name="drm-query-param"></a>

MediaPackage os sinais no pai manifestam a `#EXT-X-SESSION-KEY` tag para cada tipo de trilha em um endpoint HLS ou CMAF. Essa tag permite que os dispositivos de reprodução pré-busquem chaves quando uma chave é compartilhada em vários streams. Há momentos em que você pode não querer essa tag opcional, como quando você está usando apenas um subconjunto das faixas e não quer que todas as chaves sejam referenciadas no manifesto principal. Com o SPEKE v2, você pode acrescentar um parâmetro de consulta às suas solicitações de manifesto que removerá todas as `#EXT-X-SESSION-KEY ` tags do manifesto principal. Como cada manifesto secundário tem sua própria `#EXT-X-KEY` tag para obter uma chave de decodificação, isso geralmente `#EXT-X-SESSION-KEY ` é supérfluo. 

Para remover a `#EXT-X-SESSION-KEY` tag das respostas do MediaPackage manifesto, use o seguinte parâmetro de consulta: `aws.drmsettings=excludesessionkeys`

A seção a seguir fornece mais informações sobre o uso de parâmetros de consulta. 

## Sintaxe de consulta
<a name="drm-params-syntax"></a>

O parâmetro de consulta básico para remover `#EXT-X-SESSION-KEY` tags é`aws.drmsettings`, seguido por pares opcionais de nome e valor do parâmetro. Para criar a consulta, anexe `?aws.drmsettings=` ao final da URL do MediaPackage endpoint, seguido pelo nome e valor do parâmetro.

Uma consulta de filtro Apple HLS pode ser semelhante a esta:

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

A sintaxe da consulta está listada na tabela a seguir.

**nota**  
Se você usa a Amazon CloudFront como sua CDN, talvez seja necessário definir configurações adicionais. Para obter mais informações, consulte [Configurar o comportamento do cache para todos os endpoints](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/live-streaming.html#live-streaming-with-mediapackage-create-cache-behavior).


| Componente da string da consulta | Description | 
| --- | --- | 
| ? | Um caractere restrito que marca o início de uma consulta. | 
| aws.drmsettings= | A consulta base, que é seguida por parâmetros criados de pares de nome e valor. | 
| : | Usado para associar o nome do parâmetro a um valor. Por exemplo, .parameter\$1name:value | 
| ; | Separa parâmetros em uma consulta que contém vários parâmetros. Por exemplo, .parameter1\$1name:value;parameter2\$1name:minValue-maxValue Quando usado em uma lista de parâmetros para a mesma consulta, implica uma AND operação. | 

## Condições de erro
<a name="error-conditions-and-handling-drm"></a>

Alguns dispositivos de reprodução retornarão erros se o manifesto ou os segmentos incluírem parâmetros de consulta inválidos ou desconhecidos. A seguir estão os parâmetros de consulta que MediaPackage podem ser processados:
+ `m`
+ `start`
+ `end`
+ `aws.manifestfilter`
+ `aws.drmsettings`

Se você tiver parâmetros de consulta diferentes dos listados, use uma CDN como CloudFront a Amazon para remover os parâmetros desnecessários. Para obter mais informações, consulte [Conteúdo em cache com base em parâmetros de sequência de caracteres de consulta](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/QueryStringParameters.html) no *Amazon CloudFront Developer Guide*.

A tabela a seguir contém outras condições de erro comuns. 


****  

| Condição de erro | Exemplo | Código de status HTTP | 
| --- | --- | --- | 
| Um parâmetro de lista não é encontrado e não faz parte de uma lista restrita | ?aws.manifestfilter=audio\$1language:dahlia | 200 | 
| Somente transmissões de legendas estão presentes no fluxo | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 200 | 
| Parâmetro de filtro duplicado | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=audio\$1sample\$1rate:0-48000 | 400 | 
| Parâmetro inválido | ?aws.manifestfilter=donut\$1type:rhododendron | 400 | 
| Parâmetro de intervalo inválido | ?aws.manifestfilter=audio\$1sample\$1rate:300-0 | 400 | 
| Valor de intervalo inválido (mais de INT\$1MAX) | ?aws.manifestfilter=audio\$1sample\$1rate:0-2147483648 | 400 | 
| String de consulta malformada | ?aws.manifestfilter=audio\$1sample\$1rate:is:0-44100 | 400 | 
| A string de parâmetro tem mais de 1024 caracteres | ?aws.manifestfilter=audio\$1language:abcdef.... | 400 | 
| Parâmetros de consulta em um manifesto de taxa de bits HLS ou CMAF | index\$11.m3u8?aws.manifestfilter=video\$1codec:h264 | 400 | 
| Parâmetros de consulta em uma solicitação de segmento | ...\$11.[ts\$1mp4\$1vtt..]?aws.manifestfilter=video\$1codec:h264 | 400 | 
| Parâmetro de consulta repetida | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=video\$1bitrate:0-1 | 400 | 
| A aplicação do filtro resulta em um manifesto vazio (o conteúdo não tem fluxos que atendam às condições definidas na string de consulta) | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 400 |