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.
# Manifestfilterung
Bei der Manifestfilterung werden Client-Manifeste AWS Elemental MediaPackage dynamisch auf der Grundlage von Parametern erstellt, die Sie in einer Abfrage angeben, die an Ihre Wiedergabeanforderung angehängt ist. Auf diese Weise können Sie beispielsweise den Zuschauerzugriff auf Premium-4K-HEVC-Inhalte einschränken oder auf bestimmte Gerätetypen und Audio-Sampleratenbereiche abzielen — und das alles von einem einzigen Endpunkt aus. Bisher mussten Sie mehrere Endpunkte konfigurieren, um dieses Verhalten zu erreichen. MediaPackage bietet jetzt eine kostengünstige Möglichkeit, dynamisch verschiedene Client-Manifeste auf demselben Endpunkt zu erstellen.
## Arbeiten mit Manifestfiltern
Wenn Sie einen Manifestfilter verwenden, enthält das resultierende Manifest nur die Audio- und Videostreams, die den Eigenschaften entsprechen, die Sie in der Abfrage angeben. Wenn kein Manifestfilter verwendet wird, sind alle aufgenommenen Streams im Endpunkt-Ausgabestream vorhanden. Die Ausnahme dazu ist, wenn Sie Streamfilter für den Endpunkt festgelegt haben, wie etwa die minimale Videobitrate. In diesem Fall wird der Manifestfilter nach dem Streamfilter angewendet, wodurch die Ausgabe verzerrt werden kann. Dies wird nicht empfohlen.
Die Manifestfilterung kann für alle Endpunkttypen verwendet werden, die unterstützt werden von MediaPackage:
+ Apple HLS
+ DASH-ISO
+ Microsoft Smooth Streaming
+ CMAF
Um die Manifestfilterung zu verwenden, fügen Sie `aws.manifestfilter` Abfrageparameter an Ihre Wiedergabeanforderung an an MediaPackage. MediaPackage wertet die Abfrage aus und stellt ein auf diesen Abfrageparametern basierendes Client-Manifest bereit. Bei Manifestabfragen wird *nicht *zwischen Groß- und Kleinschreibung unterschieden. Sie können bis zu 1024 Zeichen lang sein. Wenn die Abfrage fehlerhaft ist oder keine Streams vorhanden sind, die den Abfrageparametern entsprechen, gibt MediaPackage ein unvollständiges oder leeres Manifest zurück. Informationen zur Abfragesyntax finden Sie im folgenden Abschnitt.
**Anmerkung**
Wenn Sie Apple HLS- oder CMAF-Endpunkte verwenden, gelten besondere Bedingungen. Hinweise zu diesen Bedingungen finden Sie unter [Besondere Bedingungen für HLS- und CMAF-Manifeste](#special-conditions-HLS-CMAF-manifests).
**Abfragesyntax**
Der Basis-Abfrageparameter ist `aws.manifestfilter`, gefolgt von optionalen Parameternamen/Werte-Paaren. Um die Abfrage zu erstellen, fügen Sie `?aws.manifestfilter=` sie an das Ende der MediaPackage Endpunkt-URL an, gefolgt von Parameternamen und -werten. Eine Liste aller verfügbaren Parameter finden Sie unter [Manifestfilterabfrageparameter](#manifest-filter-query-parameters).
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.manifestfilter=audio_sample_rate:0-44100;video_bitrate:0-2147483647;video_codec:h265;audio_language:fr,en-US,de}}`
Die Abfragesyntax ist in der folgenden Tabelle aufgeführt.
| Zeichenkettenkomponente abfragen | Description |
| --- | --- |
| ? | Ein eingeschränktes Zeichen, das den Anfang einer Abfrage markiert. |
| aws.manifestfilter= | Die Basisabfrage, gefolgt von Parametern aus Name- und Wert-Paaren. Eine Liste aller verfügbaren Parameter finden Sie unter [Manifestfilterabfrageparameter](#manifest-filter-query-parameters). |
| : | Wird verwendet, um dem Parameternamen einen Wert zuzuordnen. Beispiel, {{parameter\_name}}:{{value}}. |
| ; | Trennt Parameter in einer Abfrage, die mehrere Parameter enthält. Beispiel, {{parameter1\_name:value}};{{parameter2\_name:minValue-maxValue}}. |
| , | Trennt eine Liste von Werten. Beispiel, parameter\_name:{{value1}},{{value2}},{{value3}}. Durch Kommas getrennte Werte in einer Liste implizieren eine OR-Beziehung. |
| - | Wird verwendet, um den Wertebereich eines Parameters zu definieren. Beispiel, audio\_sample\_rate:0-44100. Wenn ein numerischer Wert in einem Bereich verwendet wird, wird er in die Bereichsdefinition aufgenommen. Das bedeutet, dass Streams mindestens dem Mindestwert und höchstens dem Höchstwert entsprechen müssen. Bei Bereichen sind die Mindest- und Höchstwerte obligatorisch. Die unterstützten Bereichswerte sind 0–2147483647. |
**Anmerkung**
Wenn Sie Amazon CloudFront als Ihr CDN verwenden, müssen Sie möglicherweise zusätzliche Konfigurationen einrichten. Weitere Informationen finden Sie unter [Konfigurieren der Cache-Verhaltensweisen für alle Endpunkte](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/live-streaming.html#live-streaming-with-mediapackage-create-cache-behavior).
## Manifestfilterabfrageparameter
MediaPackage unterstützt die folgenden Abfrageparameter.
| Kategorie | Name | Beschreibung | Beispiel |
| --- | --- | --- | --- |
| Audio | audio\_bitrate | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=audio\_bitrate:0-2147483647 |
| Audio | audio\_channels | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=audio\_channels:1-8 |
| Audio | audio\_codec | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=audio\_codec:AACL,AC-3 |
| Audio | audio\_language | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=audio\_language:fr,en-US,de |
| Audio | audio\_sample\_rate | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=audio\_sample\_rate:0-44100 |
| Untertitel | subtitle\_language | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=subtitle\_language:en-US, hi |
| Video | trickplay\_height | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=trickplay\_height:200-1200 |
| Video | trickplay\_type | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=trickplay\_type:iframe |
| Video | video\_bitrate | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=video\_bitrate:0-2147483647 |
| Video | video\_codec | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=video\_codec:h264 |
| Video | video\_dynamic\_range | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=video\_dynamic\_range:hdr10 |
| Video | video\_framerate | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=video\_framerate:23.976-30 |
| Video | video\_height | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediapackage/latest/ug/manifest-filtering.html) | stream.mpd?aws.manifestfilter=video\_height:720-1080 |
## Beispiele für Manifestfilterung
Dies sind Manifestfilterbeispiele.
**Example 1: Wählen Sie einen Player, der AVC und eine Audio-Abtastrate von 44,1k unterstützt**
Der Viewer spielt Inhalte auf einem Gerät ab, das nur AVC und eine Audio-Abtastrate von 44,1k unterstützen kann. Sie legen `video_codec` und `audio_sample_rate` fest, um Streams herauszufiltern, die diesen Anforderungen nicht entsprechen.
`?aws.manifestfilter=audio_sample_rate:0-44100;video_codec:h264`
**Example 2: Schränken Sie 4k-HEVC-Inhalte ein.**
Ihr 4K-HEVC-Stream umfasst 15 Mbit/s und alle Ihre anderen Streams umfassen weniger als 9 Mbit/s. Um den 4K-Stream aus dem Streamsatz auszuschließen, legen Sie einen Schwellenwert von 9 000 000 Bit pro Sekunde fest, um die höhere Bitrate herauszufiltern.
`?aws.manifestfilter=video_bitrate:0-9000000`
**Example 3: Video zwischen 23,976 und 30 Frames pro Sekunde einschließen**
Wenn Sie Videos nur innerhalb eines bestimmten Bildfrequenzbereichs aufnehmen möchten, verwenden Sie `video_framerate`. Dieser Parameter akzeptiert Gleitkommazahlen mit bis zu drei optionalen Dezimalwerten.
`?aws.manifestfilter=video_framerate:23.976-30`
## Besondere Bedingungen für HLS- und CMAF-Manifeste
Wenn Sie HLS- oder CMAF-Manifeste verwenden, gelten diese besonderen Bedingungen.
+ Für HLS-Manifeste empfehlen wir dringend die Verwendung von Audiowiedergabegruppen, um zu vermeiden, dass Videostreams, die mit den herausgefilterten Audiostreams multiplexiert sind, entfernt werden. Weitere Informationen zu Wiedergabegruppen finden Sie unter [Wiedergabegruppen verweisen in AWS Elemental MediaPackage](rendition-groups.md).
+ In HLS- und CMAF-Manifesten wird die Audio-Abtastrate nicht signalisiert. Daher ist es nicht einfach, die ursprünglichen oder gefilterten Manifeste für diese Einstellung visuell zu überprüfen. Um die Audio-Abtastrate zu verifizieren, überprüfen Sie die Audio-Abtastrate auf Encoder- und Ausgangsebene.
+ In HLS- und CMAF-Manifesten ordnet das `BANDWIDTH`-Attribut für eine Variante die Bandbreite der Audiospur der Videospur zu, unabhängig davon, ob sie mit der Videospur multiplexiert ist oder ob es sich um eine Audiowiedergabespur handelt, die von der Videospur referenziert wird. Daher können Sie das ursprüngliche und das gefilterte Manifest nicht visuell überprüfen, um sicherzustellen, dass der `video_bitrate` Filter funktioniert hat. Um den Filter zu verifizieren, überprüfen Sie die Videobitrate auf Encoder- und Ausgangsebene.
+ Bei HLS- und CMAF-Manifesten führen Anforderungsparameter, die an Bitraten-Wiedergabelisten oder Segmente angehängt sind, zu einem HTTP-400-Fehler.
## Fehlerbedingungen
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 zusätzliche allgemeine Fehlerbedingungen.
****
| Fehlerbedingung | Beispiel | HTTP-Statuscode |
| --- | --- | --- |
| Ein Listenparameter wird nicht gefunden und ist nicht Teil einer eingeschränkten Liste | ?aws.manifestfilter=audio\_language:dahlia | 200 |
| Nur Untertitel-Streams sind im Stream vorhanden | ?aws.manifestfilter=audio\_sample\_rate:0-1;video\_bitrate=0-1 | 200 |
| Doppelte Filterparameter | ?aws.manifestfilter=audio\_sample\_rate:0-48000;aws.manifestfilter=audio\_sample\_rate:0-48000 | 400 |
| Ungültiger Parameter | ?aws.manifestfilter=donut\_type:rhododendron | 400 |
| Ungültiger Bereichsparameter | ?aws.manifestfilter=audio\_sample\_rate:300-0 | 400 |
| Ungültiger Bereichswert (mehr als INT\_MAX) | ?aws.manifestfilter=audio\_sample\_rate:0-2147483648 | 400 |
| Falsch formatierte Abfragezeichenfolge | ?aws.manifestfilter=audio\_sample\_rate:is:0-44100 | 400 |
| Die Parameterzeichenfolge ist länger als 1024 Zeichen | ?aws.manifestfilter=audio\_language:abcdef.... | 400 |
| Abfrageparameter auf einem HLS- oder CMAF-Bitraten-Manifest | index\_1.m3u8?aws.manifestfilter=video\_codec:h264 | 400 |
| Abfrageparameter für eine Segmentanforderung | ...\_1.[ts\|mp4\|vtt..]?aws.manifestfilter=video\_codec:h264 | 400 |
| Wiederholter Abfrageparameter | ?aws.manifestfilter=audio\_sample\_rate:0-48000;aws.manifestfilter=video\_bitrate: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\_sample\_rate:0-1;video\_bitrate=0-1 | 400 |