Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Tags aus dem übergeordneten Manifest entfernen von AWS Elemental MediaPackage
<a name="drm-query-param"></a>

MediaPackage signalisiert im übergeordneten Manifest das `#EXT-X-SESSION-KEY` Tag für jeden Spurtyp auf einem HLS- oder CMAF-Endpunkt. Mit diesem Tag können Wiedergabegeräte Schlüssel vorab abrufen, wenn ein Schlüssel von mehreren Streams gemeinsam genutzt wird. Es kann vorkommen, dass Sie dieses optionale Tag nicht benötigen, z. B. wenn Sie nur eine Teilmenge der Titel verwenden und nicht möchten, dass alle Schlüssel im übergeordneten Manifest referenziert werden. Mit SPEKE v2 können Sie Ihren Manifestanfragen einen Abfrageparameter anhängen, der alle `#EXT-X-SESSION-KEY ` Tags aus dem übergeordneten Manifest entfernt. Da jedes untergeordnete Manifest sein eigenes `#EXT-X-KEY` Tag hat, um einen Entschlüsselungsschlüssel zu erhalten, `#EXT-X-SESSION-KEY ` ist dieser oft überflüssig. 

Verwenden Sie den folgenden Abfrageparameter, um das `#EXT-X-SESSION-KEY` Tag aus den MediaPackage Manifestantworten zu entfernen: `aws.drmsettings=excludesessionkeys`

Der folgende Abschnitt enthält weitere Informationen zur Verwendung von Abfrageparametern. 

## Abfragesyntax
<a name="drm-params-syntax"></a>

Der grundlegende Abfrageparameter für das Entfernen von `#EXT-X-SESSION-KEY` Tags ist`aws.drmsettings`, gefolgt von optionalen Parameternamen- und Wertepaaren. Um die Abfrage zu erstellen, fügen Sie `?aws.drmsettings=` sie an das Ende der MediaPackage Endpunkt-URL an, gefolgt vom Parameternamen und -wert.

Eine Apple HLS-Filterabfrage könnte folgendermaßen aussehen:

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

Die Abfragesyntax ist in der folgenden Tabelle aufgeführt.

**Anmerkung**  
Wenn Sie Amazon CloudFront als Ihr CDN verwenden, müssen Sie möglicherweise zusätzliche Konfigurationen einrichten. Weitere Informationen finden [Sie unter Cache-Verhalten für alle Endgeräte konfigurieren](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/live-streaming.html#live-streaming-with-mediapackage-create-cache-behavior).


| Komponente „Zeichenfolge abfragen“ | Description | 
| --- | --- | 
| ? | Ein eingeschränktes Zeichen, das den Anfang einer Abfrage markiert. | 
| aws.drmsettings= | Die Basisabfrage, gefolgt von Parametern aus Name- und Wert-Paaren. | 
| : | Wird verwendet, um dem Parameternamen einen Wert zuzuordnen. Beispiel, parameter\$1name:value. | 
| ; | Trennt Parameter in einer Abfrage, die mehrere Parameter enthält. Beispiel, parameter1\$1name:value;parameter2\$1name:minValue-maxValue. Wenn sie in einer Liste von Parametern für dieselbe Abfrage verwendet wird, impliziert dies eine AND Operation. | 

## Fehlerbedingungen
<a name="error-conditions-and-handling-drm"></a>

Einige Wiedergabegeräte geben Fehler zurück, wenn das Manifest oder die Segmente ungültige oder unbekannte Abfrageparameter enthalten. Die folgenden Abfrageparameter MediaPackage können verarbeitet werden:
+ `m`
+ `start`
+ `end`
+ `aws.manifestfilter`
+ `aws.drmsettings`

Wenn Sie andere als die aufgeführten Abfrageparameter haben, verwenden Sie ein CDN wie Amazon, CloudFront um die unnötigen Parameter zu entfernen. Weitere Informationen finden Sie unter [Cache-Inhalt basierend auf Abfragezeichenfolgenparametern](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/QueryStringParameters.html) im *Amazon CloudFront Developer Guide*.

Die folgende Tabelle enthält weitere häufig auftretende Fehlerbedingungen. 


****  

| Fehlerbedingung | Beispiel | HTTP-Statuscode | 
| --- | --- | --- | 
| Ein Listenparameter wird nicht gefunden und ist nicht Teil einer eingeschränkten Liste | ?aws.manifestfilter=audio\$1language:dahlia | 200 | 
| Nur Untertitel-Streams sind im Stream vorhanden | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 200 | 
| Doppelte Filterparameter | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=audio\$1sample\$1rate:0-48000 | 400 | 
| Ungültiger Parameter | ?aws.manifestfilter=donut\$1type:rhododendron | 400 | 
| Ungültiger Bereichsparameter | ?aws.manifestfilter=audio\$1sample\$1rate:300-0 | 400 | 
| Ungültiger Bereichswert (mehr als INT\$1MAX) | ?aws.manifestfilter=audio\$1sample\$1rate:0-2147483648 | 400 | 
| Falsch formatierte Abfragezeichenfolge | ?aws.manifestfilter=audio\$1sample\$1rate:is:0-44100 | 400 | 
| Die Parameterzeichenfolge ist länger als 1024 Zeichen | ?aws.manifestfilter=audio\$1language:abcdef.... | 400 | 
| Abfrageparameter auf einem HLS- oder CMAF-Bitraten-Manifest | index\$11.m3u8?aws.manifestfilter=video\$1codec:h264 | 400 | 
| Abfrageparameter für eine Segmentanforderung | ...\$11.[ts\$1mp4\$1vtt..]?aws.manifestfilter=video\$1codec:h264 | 400 | 
| Wiederholter Abfrageparameter | ?aws.manifestfilter=audio\$1sample\$1rate:0-48000;aws.manifestfilter=video\$1bitrate:0-1 | 400 | 
| Die Anwendung des Filters führt zu einem leeren Manifest (Inhalt enthält keine Streams, die die in der Abfragezeichenfolge definierten Bedingungen erfüllen) | ?aws.manifestfilter=audio\$1sample\$1rate:0-1;video\$1bitrate=0-1 | 400 |