# Dateien für Webbrowser bereitstellen
🤖/file/serve stellt Dateien für Webbrowser bereit.
Wenn Transloadit Dateien dynamisch transformieren soll, können Sie mit diesem Robot festlegen, welcher Step in einem Template über ein CDN an die Endbenutzer ausgeliefert werden soll. Außerdem können Sie zusätzliche Informationen für die ausgelieferten Dateien festlegen, etwa Header. So können Sie dem CDN beispielsweise vorgeben, wie lange zwischengespeicherte Kopien des Ergebnisses aufbewahrt werden sollen. Standardmäßig weisen wir Browser an, das Ergebnis für 72h (`259200` Sekunden) zwischenzuspeichern, und CDNs, den Inhalt für 24h (`86400` Sekunden) zwischenzuspeichern. Verwenden Sie den Parameter `cache_duration`, um beide Werte gleichzeitig anzupassen.
🤖/file/serve dient lediglich als Glue-Code zwischen unserer Assembly-Engine und der Dateiauslieferung über HTTP. Damit können Sie über den Parameter `use` das passende Ergebnis aus einer Reihe von Steps auswählen und Header für den ursprünglichen Inhalt konfigurieren. Damit endet seine Zuständigkeit. Anschließend übernimmt 🤖/tlcdn/deliver die weltweite Verteilung dieses ursprünglichen Inhalts und sorgt dafür, dass er nahe bei Ihren Endbenutzern zwischengespeichert wird, wenn diese Anfragen wie [https://my-app.tlcdn.com/resize-img/canoe.jpg?w=500](https://my-app.tlcdn.com/resize-img/canoe.jpg?w=500) stellen. 🤖/tlcdn/deliver ist kein Bestandteil Ihrer Assembly Instructions, kann jedoch auf Ihren Rechnungen erscheinen, da bei der Verteilung der zwischengespeicherten Kopien Bandbreitenkosten anfallen. Kosten für 🤖/file/serve entstehen nur, wenn das CDN keine zwischengespeicherte Kopie besitzt und die erneute Erzeugung des ursprünglichen Inhalts anfordert. Abhängig von Ihren Cache-Einstellungen kann dies pro Datei und Transformation nur einmal im Monat oder Jahr geschehen.
Obwohl es theoretisch möglich ist, [🤖/file/serve](/de/docs/robots/file-serve.md) direkt in HTML-Dateien zu verwenden, raten wir dringend davon ab. Wenn Ihre Website populär wird und die von /file/serve verarbeitete Medien-URL eine Million Mal aufgerufen wird, führt dies zu einer Million neuer Bildgrößenänderungen. Wenn Sie ein CDN davorschalten, sorgt das damit verbundene Caching sowohl für niedrige Encoding-Kosten als auch für geringe Latenzen.
Konfigurieren Sie außerdem Caching-Header und Cache-Control-Direktiven, um zu steuern, wie Inhalte auf den CDN-Edge-Servern zwischengespeichert und invalidiert werden, und dabei Aktualität und Effizienz auszubalancieren.
## Smart-CDN-Sicherheit mit signierten URLs
Mit [signierten Smart-CDN-URLs](/de/docs/api/authentication.md#smart-cdn) können Sie den Missbrauch unserer Encoding-Plattform verhindern. Nachfolgend finden Sie ein kurzes Node.js-Beispiel mit unserem Node SDK. Außerdem stehen [Beispiele für andere Sprachen und SDKs](/de/docs/api/authentication.md#example-code) zur Verfügung.
```javascript
// yarn add transloadit
// or
// npm install --save transloadit
import { Transloadit } from 'transloadit'
const transloadit = new Transloadit({
authKey: 'YOUR_TRANSLOADIT_KEY',
authSecret: 'YOUR_TRANSLOADIT_SECRET',
})
const url = transloadit.getSignedSmartCDNUrl({
workspace: 'YOUR_WORKSPACE',
template: 'YOUR_TEMPLATE',
input: 'image.png',
urlParams: { height: 100, width: 100 },
})
console.log(url)
```
Dadurch wird eine signierte Smart-CDN-URL mit Authentifizierungsparametern erzeugt, die unbefugten Zugriff auf Ihre Transformationsendpunkte verhindert.
Verwenden Sie für neue Integrationen das moderne Format `sig` + `exp`. Veraltete Signaturen im Format `s` werden nicht mehr empfohlen. Beachten Sie außerdem, dass das Ablaufzeitfenster dem praktischen Cache-Zeitfenster für signierte Ergebnisse entspricht: Kürzere Ablaufzeiten verschärfen die Zugriffskontrolle, während längere Ablaufzeiten die Wiederverwendung des Caches verbessern und das Encoding-Volumen reduzieren.
## Weitere Informationen
* [Inhaltsauslieferung](/de/services/content-delivery.md)
* Preise für [🤖/file/serve](/de/docs/robots/file-serve.md)
* Preise für [🤖/tlcdn/deliver](/de/docs/robots/tlcdn-deliver.md)
* Blogbeitrag zur [Dateivorschau-Funktion EN (English)](/blog/2024/06/file-preview-with-smart-cdn.md)
## Anwendungsbeispiel
Transformierte Dateien mit expliziter Cache-Dauer für Browser und CDN ausliefern:
```
{
"steps": {
"resized": {
"robot": "/image/resize",
"use": ":original",
"width": 800,
"height": 450,
"resize_strategy": "fit"
},
"served": {
"robot": "/file/serve",
"use": "resized",
"cache_duration": 86400
}
}
}
```
## 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.
*
### `user_meta`
`Record`(Standard: `{}`)\
Fügt jeder von diesem Robot ausgegebenen Datei benutzerdefinierte Metadaten hinzu, ohne den Dateiinhalt zu verändern.\
Die Werte werden mit allen bereits in der Eingabedatei enthaltenen `user_meta` zusammengeführt. Wenn beide Objekte denselben Schlüssel enthalten, hat der Wert dieses Robots Vorrang. Assembly Variables werden unterstützt, zum Beispiel `{ "internal_file_id": "${file.id}" }`.
*
### `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