# Videos in HLS, MPEG-Dash und CMAF konvertieren
🤖/video/adaptive codiert Videos in Formate, die HTTP Live Streaming (HLS), MPEG-Dash und CMAF unterstützen, und erzeugt die erforderlichen Manifest- und Playlist-Dateien.
Dieser Robot akzeptiert alle Arten von Video- und Audiodateien. Vergessen Sie nicht, in Ihrem Parameter `use` die Step-Bündelung zu verwenden, damit der Robot mehrere Eingabedateien gleichzeitig verarbeitet.
Dieser Robot wird normalerweise zusammen mit [🤖/video/encode](/de/docs/robots/video-encode.md) verwendet. Wir haben speziell für die Unterstützung von MPEG-Dash und HTTP Live Streaming Voreinstellungen für das Video- und Audio-Encoding implementiert. Diese Voreinstellungen beginnen mit `"dash/"` beziehungsweise `"hls/"`. [Hier können Sie eine Demo für HTTP Live Streaming ansehen EN (English)](/demos/video-encoding/implement-http-live-streaming.md).
### Erforderliche CORS-Einstellungen für MPEG-Dash und HTTP Live Streaming
Für die Wiedergabe von MPEG-Dash-Manifest- oder HLS-Playlist-Dateien muss CORS serverseitig korrekt eingerichtet sein. Der Server, der die Dateien ausliefert, sollte so konfiguriert werden, dass er den Antworten die folgenden Header-Felder hinzufügt:
```
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET
Access-Control-Allow-Headers: *
```
Wenn die Dateien in einem Amazon-S3-Bucket gespeichert sind, können Sie mit der folgenden [CORS-Definition](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManageCorsUsing.html) sicherstellen, dass die CORS-Header-Felder korrekt gesetzt werden:
```json
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET"],
"AllowedOrigins": ["*"],
"ExposeHeaders": []
}
]
```
So richten Sie CORS für Ihren S3-Bucket ein:
1. Rufen Sie [https://s3.console.aws.amazon.com/s3/buckets/](https://s3.console.aws.amazon.com/s3/buckets/) auf
2. Klicken Sie auf Ihren Bucket
3. Klicken Sie auf „Permissions“
4. Bearbeiten Sie „Cross-origin resource sharing (CORS)“
### Segmente und Playlist-Dateien speichern
Der Robot versieht seine Ergebnisdateien (Segmente, Initialisierungssegmente, MPD-Manifest-Dateien und M3U8-Playlist-Dateien) mit der richtigen Metadateneigenschaft `relative_path`, sodass Sie sie problemlos mit einem unserer Robots zum Speichern ablegen können.
Verwenden Sie im Parameter `path` des ausgewählten Robots zum Speichern die Assembly Variable `${file.meta.relative_path}`, um die Dateien unter den richtigen Pfaden abzulegen, damit die Playlist-Dateien funktionieren.
## Anwendungsbeispiel
HTTP Live Streaming implementieren: Das hochgeladene Video in drei Versionen codieren, diese anschließend in mehrere Segmente aufteilen und Playlist-Dateien mit allen Segmenten erstellen:
```
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"encoded_480p": {
"robot": "/video/encode",
"use": ":original",
"preset": "hls/480p",
"ffmpeg_stack": "v7"
},
"encoded_720p": {
"robot": "/video/encode",
"use": ":original",
"preset": "hls/720p",
"ffmpeg_stack": "v7"
},
"encoded_1080p": {
"robot": "/video/encode",
"use": ":original",
"preset": "hls/1080p",
"ffmpeg_stack": "v7"
},
"hls_bundled": {
"robot": "/video/adaptive",
"use": {
"steps": [
"encoded_480p",
"encoded_720p",
"encoded_1080p"
],
"bundle_steps": true
},
"technique": "hls",
"playlist_name": "my_playlist.m3u8"
}
}
}
```
## Parameter
*
### `interpolate`
`boolean | Record`\
Steuert, ob einzelne Robot-Anweisungsfelder Assembly Variables interpolieren.\
Standardmäßig interpolieren die meisten Robot-Anweisungsfelder Assembly Variables. Mit dem Wert `false` behandeln Sie alle Anweisungsfelder als Literaltext. Wenn Sie stattdessen einen einzelnen Feldpfad auf `false` setzen, wird nur dieses Feld als Literaltext behandelt. Bei Feldern eines bestimmten Robots, die standardmäßig als Literaltext behandelt werden, aktivieren Sie die Interpolation wieder, indem Sie hierfür `true` festlegen oder für den jeweiligen Feldpfad den Wert `true` verwenden.\
Verwenden Sie Feldnamen wie `path` oder für verschachtelte Objekte Punktpfade wie `ffmpeg.vf` als Pfadangabe.
*
### `output_meta`
`Record | boolean | Array`\
Damit können Sie eine Reihe von Metadaten festlegen, deren Berechnung mehr CPU-Ressourcen beansprucht. Sie sind daher standardmäßig deaktiviert, damit Ihre Assemblies schnell verarbeitet werden.\
Für Bilder können Sie diesem Objekt den Eintrag `"has_transparency": true` hinzufügen, um zu ermitteln, ob das Bild transparente Bereiche enthält. Mit dem Eintrag `"dominant_colors": true` können Sie außerdem ein Array mit hexadezimalen Farbcodes aus dem Bild extrahieren.\
Für Bilder können Sie auch den Eintrag `"blurhash": true` hinzufügen, um einen [BlurHash](https://blurha.sh) zu extrahieren – eine kompakte Darstellung eines Platzhalters für das Bild, mit der Sie eine unscharfe Vorschau anzeigen können, während das vollständige Bild geladen wird.\
Für Videos können Sie den Parameter `"colorspace": true` hinzufügen, um den Farbraum des Ausgabevideos zu extrahieren.\
Für Videos können Sie außerdem den Eintrag `"interlaced": true` hinzufügen, um zu erkennen, ob das Video im Zeilensprungverfahren vorliegt. Dazu wird die ressourcenschonende ffprobe-Option `field_order` mit einem begrenzten Stichprobendurchlauf mithilfe von `idet` über die ersten Frames der Quelle kombiniert. Die Ergebnisse `interlaced` und `field_order` sowie das Diagnoseobjekt `interlace_detection` werden dabei unter `file.meta` ausgegeben. Dies ist rechenintensiv und wird entsprechend abgerechnet.\
Für Audio können Sie den Eintrag `"mean_volume": true` hinzufügen, um einen einzelnen Wert für die durchschnittliche Lautstärke der Audiodatei zu erhalten.\
Sie können diesen Parameter auch auf `false` setzen, um die Metadatenextraktion zu überspringen und das Transcoding zu beschleunigen.
*
### `result`
`boolean`(Standard: `false`)\
Ob die Ergebnisse dieses Steps im Assembly Status JSON enthalten sein sollen
*
### `queue`
`batch`\
Wenn Sie die Queue auf „batch“ setzen, wird die Priorität der Jobs für diesen Step manuell herabgestuft. So vermeiden Sie, Priority Job Slots für Jobs zu belegen, die keine Wartezeit von null in der Queue benötigen.
*
### `force_accept`
`boolean`(Standard: `false`)\
Erzwingt, dass ein Robot einen Dateityp akzeptiert, den er sonst ignorieren würde.\
Standardmäßig ignorieren Robots Dateien, deren Typ sie nicht kennen.[🤖/video/encode](/de/docs/robots/video-encode.md) ignoriert beispielsweise problemlos Eingabebilder.\
Wenn Sie den Parameter `force_accept` auf `true` setzen, können Sie erzwingen, dass Robots alle übergebenen Dateien akzeptieren. Dies führt in der Regel zu Fehlern und sollte nur zur Fehlersuche oder zur Behandlung von Grenzfällen verwendet werden.
*
### `ignore_errors`
`boolean | Array`(Standard: `[]`)\
Fehler in bestimmten Verarbeitungsphasen ignorieren.\
Wenn Sie hierfür `["meta"]` festlegen, ignoriert der Robot Fehler bei der Metadatenextraktion.\
Wenn Sie hierfür `["execute"]` festlegen, ignoriert der Robot Fehler während der Hauptausführungsphase.\
Wenn Sie hierfür `true` festlegen, entspricht dies `["meta", "execute"]` und Fehler in beiden Phasen werden ignoriert.
*
### `use`
`string | Array | Array