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:

{
  "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 (English) 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 Thumbnails, beginnend bei 0. Dieser Schlüssel ist nur in Ergebnissen von 🤖/video/thumbs vorhanden.
thumb_offset: Der Versatz des aktuellen Thumbnails in Sekunden. Dieser Schlüssel ist nur in Ergebnissen von 🤖/video/thumbs 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:

{
  "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.
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.