# Metadaten Viele Dateien enthalten interessante Informationen über ihre Inhalte. Diese werden als „Metadaten“ bezeichnet. Transloadit extrahiert diese Metadaten automatisch aus allen hochgeladenen, importierten und verarbeiteten Dateien. Jede Datei enthält mindestens folgende Informationen: ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_GBjmaCTpH3rF6sBBsH4gkTL4K8CU) ```jsonc { "id": "ae52b7f8c1b3426e8c29ea0a9daf8306", "name": "straw-apple.jpg", "basename": "straw-apple", "ext": "jpg", "size": 92230, "mime": "image/jpeg", "type": "image", "field": "test_file", "url": "http://tmp.maynard.transloadit.com/upload/1324a798a99fce7f5f8289a95a74f02b.jpg", "original_id": "4af24fb2595f44809f3adc2f77bc9bfa", "meta": { // … } } ``` Welche Informationen wir extrahieren können, hängt von der Mediendatei, ihrem Typ und auch von ihrem Ersteller ab. Wurde sie mit einem iPhone erstellt, enthält sie wahrscheinlich `latitude` zur geografischen Positionsbestimmung. Häufigere Schlüssel sind`height` und `duration`. Um zu sehen, welche Informationen wir aus Ihren Dateien extrahieren können, testen Sie eine unserer[Demos](/demos/) und prüfen Sie nach dem Hochladen einer Datei unsere Antwort. `id` Eine zufällige, eindeutige ID, mit der Transloadit die Datei intern verfolgt. `name` Der Name der Datei. Transloadit ändert die für dieses Feld verwendete Erweiterung, wenn die Datei in ein anderes Format verarbeitet wird. `basename` Der Name der Datei ohne Erweiterung. `ext` Die Erweiterung der Datei. `size` Die Größe der Datei in Bytes. `mime` Der ermittelte MIME-Typ dieser Datei. `type` Ein abstrakter Typ, der die Datei beschreibt und derzeit `"image"`, `"video"`, `"audio"` oder`null` sein kann. `field` Der Name des Formularfelds, mit dem diese Datei übermittelt wurde. `url` Die URL, unter der diese Datei erreichbar ist. Dies ist entweder eine URL in Ihrem S3-Bucket oder eine temporäre URL auf unseren Servern. Da temporäre URLs nach einigen Stunden ablaufen, sollten Sie Ihre Dateien an einen anderen Speicherort verschieben, sofern Sie keinen Storage-Robot verwenden. `original_id` Die eindeutige ID der ursprünglichen Upload-Datei, aus der diese Datei erzeugt wurde. Damit lässt sich nach mehreren Verarbeitungs-Steps ermitteln, welche Datei eines Uploads mit mehreren Dateien zum Erzeugen einer bestimmten Datei verwendet wurde. `meta` Ein Objekt mit zusätzlichen Metadaten, die wie unten dargestellt aus der Datei extrahiert wurden. ## Bildmetadaten Obwohl dies von der jeweiligen Datei abhängt, können Dateien mit dem MIME-Typ `image` in der Eigenschaft`meta` üblicherweise folgende Daten enthalten: `width` Die Breite des Eingabebilds in Pixeln. `height` Die Höhe des Eingabebilds in Pixeln. `aspect_ratio` Das Seitenverhältnis des Bilds, also seine Breite geteilt durch seine Höhe. Es beträgt 0, wenn die Bildhöhe aus irgendeinem Grund 0 ist. `date_recorded` Datum und Uhrzeit der Aufnahme dieses Bilds im Format `YYYY/MM/DD HH:MM:SS TZ`, zum Beispiel`"2010/06/30 22:16:06 GMT"`. `date_file_created` Der Erstellungszeitpunkt im Dateisystem. `date_file_modified` Der Änderungszeitpunkt im Dateisystem. `title` Der Titel dieses Bilds, zum Beispiel `"Tree"`. `keywords` Ein Array mit Schlüsselwörtern für dieses Bild, zum Beispiel `["tree", "nature"]`. `description` Eine Beschreibung dieses Bilds, zum Beispiel `"This tree is very old."`. `location` Der Aufnahmeort dieses Bilds, üblicherweise die Straße, zum Beispiel `"Zingster Str. 32"`. `creator` Die Person, die das Bild aufgenommen hat. `author` Die Person, die das Bild aufgenommen hat. Einige Kameras füllen dieses Feld anstelle von `creator` aus. `copyright` Das Copyright-Metadatenfeld. `copyright_notice` Das Metadatenfeld für den Copyright-Hinweis. `city` Die Stadt, in der dieses Bild aufgenommen wurde, zum Beispiel `"Berlin"`. `state` Das Bundesland, in dem dieses Bild aufgenommen wurde, zum Beispiel `"Berlin"`. `country` Das Land, in dem dieses Bild aufgenommen wurde, zum Beispiel `"Germany"`. `country_code` Der Ländercode des Landes, in dem dieses Bild aufgenommen wurde, zum Beispiel `"de"`. `aperture` Die Blendeneinstellung für dieses Bild, zum Beispiel `5.7`. `exposure_compensation` Die Belichtungskorrektur für dieses Bild, zum Beispiel `"+4/3"`. `exposure_mode` Der Belichtungsmodus für dieses Bild, zum Beispiel `"Auto"`. `exposure_time` Die Belichtungszeit für dieses Bild, zum Beispiel `"1/30"`. `flash` Die Blitzeinstellungen für dieses Bild, zum Beispiel `"Off, Did not fire"`. `focal_length` Die Brennweite für dieses Bild, zum Beispiel `"55.0 mm"`. `f_number` Die Blendenzahl für dieses Bild, zum Beispiel `5.6`. `iso` Der ISO-Wert für dieses Bild, zum Beispiel `800`. `light_value` Der Lichtwert für dieses Bild, zum Beispiel `6.9`. `metering_mode` Der Messmodus für dieses Bild, zum Beispiel `"Multi-segment"`. `shutter_speed` Die Verschlusszeit für dieses Bild, zum Beispiel `"1/32"`. `white_balance` Die Weißabgleicheinstellung für dieses Bild, zum Beispiel `"Manual"`. `device_name` Der Gerätename der Kamera, zum Beispiel `"iPhone 3GS"`. `device_vendor` Der Kamerahersteller, zum Beispiel `"Apple"`. `device_software` Die Version der Gerätesoftware der Kamera, zum Beispiel `"3.1.2"`. `latitude` Der Breitengrad, an dem dieses Bild aufgenommen wurde, zum Beispiel `52.5374`. `longitude` Der Längengrad, an dem dieses Bild aufgenommen wurde, zum Beispiel `13.4034`. `thumb_index` Der Index des aktuellen Vorschaubilds, beginnend bei 0. Dieser Schlüssel ist nur in Ergebnissen von[🤖/video/thumbs](/docs/robots/video-thumbs.md) vorhanden. `thumb_offset` Der Versatz des aktuellen Vorschaubilds in Sekunden. Dieser Schlüssel ist nur in Ergebnissen von[🤖/video/thumbs](/docs/robots/video-thumbs.md) vorhanden. `frame_count` Die Anzahl der Frames in einer animierten GIF-Datei. Für alle anderen Bildtypen ist der Standardwert `1`. `colorspace` Der Farbraum des Bilds. Dies kann beispielsweise `"sRGB"` oder `"Gray"` sein. In der ersten ImageMagick-Stack-Version von Transloadit gibt es einen Fehler, durch den die in einem Bild verwendeten Farben dessen `colorspace` bestimmen. Ein in Graustufen gehaltenes Bild meldet dadurch `"Gray"`, selbst wenn es als `"RGB"` gespeichert wurde. `has_clipping_path` Ist `1`, wenn das Bild einen Beschneidungspfad enthält, andernfalls `0`. `average_color` Nicht mit der dominanten Farbe zu verwechseln, die nur die am häufigsten vorkommende Pixelfarbe erfasst und begrenzte Anwendungsfälle hat. Die Durchschnittsfarbe wird berechnet, indem das Eingabebild zunächst auf 1 Pixel skaliert wird. `has_transparency` Gibt für Bilder mit transparenten Bereichen `true` zurück. Dieser Schlüssel wird nur zurückgegeben, wenn Sie`output_meta.has_transparency` auf `true` setzen. `dominant_colors` Gibt ein Array der 20 am häufigsten verwendeten Farben eines Bilds zurück. Dieser Schlüssel wird nur zurückgegeben, wenn Sie`output_meta.dominant_colors` auf `true` setzen. ## Videometadaten Obwohl dies von der jeweiligen Datei abhängt, können Dateien mit dem MIME-Typ `video` in der Eigenschaft`meta` üblicherweise folgende Daten enthalten: `width` Die Breite des Videos in Pixeln. Wenn das Video mit einem anderen Anzeigeverhältnis als dem Pixelverhältnis dargestellt werden soll, gibt dies die Breite an, in der das Video angezeigt werden soll. `height` Die Höhe des Videos in Pixeln. `framerate` Die Framerate des Videos, zum Beispiel `29.5`. `video_bitrate` Die Videobitrate des Videos, zum Beispiel `500000`. `video_codec` Der Video-Codec des Videos, zum Beispiel `"ffh264"`. `audio_bitrate` Die Audiobitrate des Videos, zum Beispiel `128000`. `audio_samplerate` Die Audio-Abtastrate des Videos, zum Beispiel `44100`. `audio_channels` Die Anzahl der Audiokanäle im Video, zum Beispiel `2`. `audio_codec` Der Audio-Codec des Videos, zum Beispiel `"faad"`. `seekable` Gibt an, ob das Videoformat das Springen unterstützt, zum Beispiel `true`. `interlaced` Gibt an, ob das Video anscheinend Zeilensprungverfahren verwendet. Der Wert ist bei Videos mit Zeilensprungverfahren `true`, bei progressiven Videos `false` und `null`, wenn die Erkennung kein eindeutiges Ergebnis lieferte. Dieser Schlüssel wird nur zurückgegeben, wenn Sie `output_meta.interlaced` auf `true` setzen. `field_order` Die von FFprobe gemeldete Halbbildreihenfolge, zum Beispiel `"tt"`, `"bb"`, `"tb"`, `"bt"`,`"progressive"` oder `null`. Behandeln Sie dies als diagnostische Metadaten und verwenden Sie `interlaced` für einfache Verzweigungen nach Zeilensprungverfahren oder progressiver Darstellung. Dieser Schlüssel wird nur zurückgegeben, wenn Sie`output_meta.interlaced` auf `true` setzen. `interlace_detection` Diagnosedetails des Zeilensprungdetektors von Transloadit. Dieses Objekt kann`sampled_frames`, `tff`, `bff`, `progressive`, `undetermined`, `confidence`, `method` und`ffprobe_field_order` enthalten. Dieser Schlüssel wird nur zurückgegeben, wenn Sie `output_meta.interlaced` auf `true` setzen. `colorspace` Der Farbraum des Videos. Dies kann beispielsweise `"sRGB"` oder `"Gray"` sein. Dieser Schlüssel wird nur zurückgegeben, wenn Sie `output_meta.colorspace` auf `true` setzen. `date_recorded` Details finden Sie in der Beschreibung der Bildmetadaten. `date_file_created` Details finden Sie in der Beschreibung der Bildmetadaten. `date_file_modified` Details finden Sie in der Beschreibung der Bildmetadaten. `device_name` Details finden Sie in der Beschreibung der Bildmetadaten. `device_vendor` Details finden Sie in der Beschreibung der Bildmetadaten. `device_software` Details finden Sie in der Beschreibung der Bildmetadaten. `latitude` Details finden Sie in der Beschreibung der Bildmetadaten. `longitude` Details finden Sie in der Beschreibung der Bildmetadaten. Sie können beispielsweise Videos mit Zeilensprungverfahren in einem Import- oder Upload-Step erkennen und nur diese Dateien an einen nachfolgenden Step weiterleiten: ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_GBjmaCTpH3rF6sBBsH4gkTL4K8CU) ```jsonc { "steps": { ":original": { "robot": "/upload/handle", "output_meta": { "interlaced": true } }, "only_interlaced": { "use": ":original", "robot": "/file/filter", "accepts": [["${file.meta.interlaced}", "==", "true"]] } } } ``` ## Audiometadaten Obwohl dies von der jeweiligen Datei abhängt, können Dateien mit dem MIME-Typ `audio` in der Eigenschaft`meta` üblicherweise folgende Daten enthalten: `duration` Die Länge der Audiodatei in Sekunden. `audio_bitrate` Bits pro Sekunde (für alle Kanäle zusammen). `audio_samplerate` Die Audio-Abtastrate in Hertz, zum Beispiel `44100` bei einer CD. `audio_channels` Anzahl der Kanäle. Bei Stereo üblicherweise 2. `audio_codec` Der verwendete Audio-Codec. Hier finden Sie eine Liste aller von Transloadit unterstützten[Audio-Codecs](/docs/supported-formats.md). `artist` Viele Anwendungen, die Audiodateien erzeugen, schreiben zusätzliche Informationen wie`artist`, `year`, `album` und `genre` in die Audiodatei. `mean_volume` Die mittlere Lautstärke der Audiodatei. Dieser Schlüssel wird nur zurückgegeben, wenn Sie`output_meta.mean_volume` auf `true` setzen.