Viele Dateien enthalten interessante Informationen über ihren Inhalt. Diese werden als „Metadaten“ bezeichnet. Transloadit extrahiert diese Metadaten automatisch für alle hochgeladenen, importierten und verarbeiteten Dateien.

Jede Datei enthält mindestens Informationen wie die folgenden:

{
  "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 und ihrem Typ ab, aber auch davon, wer oder was sie erzeugt hat. Stammt sie von einem iPhone, ist wahrscheinlich latitude für die Geopositionierung enthalten. Zu den häufigeren Schlüsseln gehören height und duration.

Um zu sehen, welche Informationen wir aus den Dateien extrahieren können, die Sie uns schicken, können Sie eine unserer Demos (English) ausprobieren und nach dem Hochladen einer Datei unsere Antwort untersuchen.

id: Eine zufällige und eindeutige ID, die Transloadit intern verwendet, um die Datei nachzuverfolgen.
name: Der Name der Datei. Transloadit ändert die in diesem Feld verwendete Dateiendung, wenn die Datei bei der Verarbeitung in ein anderes Format umgewandelt wird.
basename: Der Name der Datei ohne Dateiendung.
ext: Die Dateiendung. Kann null sein, wenn keine Endung ermittelt wurde, oder ein leerer String bei einem Namen ohne Endung.
size: Die Größe der Datei in Bytes.
mime: Der für diese Datei ermittelte MIME-Typ.
type: Eine abstrakte Kategorie, die die Datei beschreibt. Bekannte Werte sind "audio", "document", "image", "office", "pdf", "swf", "video", "xls" oder null, wenn keine Kategorie erkannt wurde. Verarbeitende Anwendungen sollten auch andere Strings akzeptieren, damit künftige Kategorien kompatibel bleiben.
field: Der Name des Formularfelds, über das diese Datei übermittelt wurde.
url: Eine URL, von der die Datei heruntergeladen werden kann, oder null, wenn keine Auslieferungs-URL verfügbar ist. Temporäre URLs auf unseren Servern laufen nach einigen Stunden ab; exportieren Sie Dateien für die spätere Nutzung in einen Speicher. /transloadit/store setzt für url/ssl_url eine signierte Smart CDN URL, oder null, wenn kein Schlüssel vorhanden ist. Bewahren Sie den zurückgegebenen Workspace, asset_id und version_id als dauerhafte Referenz auf, vorbehaltlich Zugriffsrechten und Aufbewahrungsregeln. /transloadit/import akzeptiert asset_id mit optionaler version_id oder einen veränderlichen path. Weder eine temporäre URL noch die id der Verarbeitungsdatei ist eine dauerhafte Referenz auf gespeicherte Assets.
original_id: Die eindeutige ID der ursprünglich hochgeladenen Datei, aus der diese Datei erzeugt wurde. Dies ist nützlich, um nach mehreren Steps der Verarbeitung festzustellen, welche Datei eines Uploads mit mehreren Dateien zur Erzeugung einer bestimmten Datei verwendet wurde.
meta: Ein Objekt mit zusätzlichen, aus der Datei extrahierten Metadaten, wie unten dargestellt. Wiederholte Datums-Tags können als Listen ihrer ursprünglichen Werte zurückgegeben werden. Prüfen Sie den Typ des Werts, bevor Sie ihn als einzelnen Zeitstempel verwenden.

Bildmetadaten

Auch wenn es von der jeweiligen Datei abhängt, können Dateien, deren type image ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

width: Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeigeverhältnis vom Pixelverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.
height: Die Höhe des Mediums in Pixeln.
aspect_ratio: Das Seitenverhältnis des Bildes, also seine Breite geteilt durch seine Höhe. Ist 0, falls die Bildhöhe aus irgendeinem Grund 0 ist.
date_recorded: Datum und Uhrzeit der Aufnahme des Mediums. Ein einzelner gültiger String-Zeitstempel wird auf YYYY/MM/DD HH:MM:SS normalisiert. Enthält er eine Zeitzone, wird er nach UTC/GMT umgerechnet und endet auf GMT. Nicht parsebare String-Zeitstempel werden zu null. Numerische Zeitstempel und Listen wiederholter Datums-Tags behalten ihre ursprünglichen Werte.
date_file_created: Der von den Medienmetadaten gemeldete Erstellungszeitstempel, sofern verfügbar.
date_file_modified: Der vom Dateisystem oder von den eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
title: Der Titel dieses Bildes, etwa "Tree".
keywords: Aus den Metadaten der Datei extrahierte Schlüsselwörter: ein String, eine endliche Zahl oder ein Array, dessen Einträge Strings, endliche Zahlen oder Booleans sein können. Zum Beispiel ["tree", "nature"]. Das Feld kann fehlen oder null sein. Prüfen Sie seinen Typ, bevor Sie darüber iterieren; Array-Einträge sind nicht zwingend Strings.
description: Eine Beschreibung dieses Bildes, etwa "This tree is very old.".
location: Der Ort, an dem dieses Bild aufgenommen wurde, in der Regel die Straße, etwa "Zingster Str. 32". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
creator: Der Urheber, der das Bild aufgenommen hat.
author: Der Autor, der das Bild aufgenommen hat. Manche Kameras befüllen dieses Feld anstelle von creator.
copyright: Das Metadatenfeld für das Copyright.
copyright_notice: Das Metadatenfeld für den Copyright-Hinweis.
city: Die Stadt, in der dieses Bild aufgenommen wurde, etwa "Berlin".
state: Das Bundesland bzw. der Bundesstaat, in dem dieses Bild aufgenommen wurde, etwa "Berlin".
country: Das Land, in dem dieses Bild aufgenommen wurde, etwa "Germany".
country_code: Der in den Bildmetadaten erfasste Ländercode, etwa "de" oder 528. String- und numerische Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
aperture: Die Blendeneinstellung für dieses Bild, etwa 5.7.
exposure_compensation: Die Belichtungskorrektur für dieses Bild, etwa "+4/3".
exposure_mode: Der Belichtungsmodus für dieses Bild, etwa "Auto".
exposure_time: Die Belichtungszeit für dieses Bild, etwa "1/30".
flash: Die Blitzeinstellungen für dieses Bild, etwa "Off, Did not fire".
focal_length: Die Brennweite für dieses Bild, etwa "55.0 mm".
f_number: Die Blendenzahl für dieses Bild, etwa 5.6.
iso: Der ISO-Wert für dieses Bild, etwa 800.
light_value: Der Lichtwert für dieses Bild, etwa 6.9.
metering_mode: Der Belichtungsmessmodus für dieses Bild, etwa "Multi-segment".
shutter_speed: Die Verschlussgeschwindigkeit für dieses Bild, etwa "1/32".
white_balance: Die Weißabgleich-Einstellung für dieses Bild, etwa "Manual".
device_name: Der Name des Geräts, mit dem das Medium aufgenommen wurde, etwa "iPhone 3GS".
device_vendor: Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, etwa "Apple". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
device_software: Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, etwa "3.1.2".
latitude: Der Breitengrad, an dem das Medium aufgenommen wurde, etwa 52.5374.
longitude: Der Längengrad, an dem das Medium aufgenommen wurde, etwa 13.4034.
thumb_index: Der bei 0 beginnende Index des aktuellen Thumbnails. Dieser Schlüssel ist nur bei Ergebnissen von 🤖/video/thumbs vorhanden.
thumb_offset: Der Versatz des aktuellen Thumbnails in Sekunden. Dieser Schlüssel ist nur bei Ergebnissen von 🤖/video/thumbs vorhanden.
frame_count: Die Anzahl der Frames in einer animierten GIF-Datei. Bei allen anderen Bildtypen ist dieser Wert standardmäßig 1.
colorspace: Der erkannte Farbraum des Mediums, etwa "sRGB" oder "Gray". Der Video-Farbraum ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Mit output_meta: false wird die Metadatenextraktion deaktiviert.
has_clipping_path: Ist true, wenn das Bild einen Beschneidungspfad enthält, andernfalls false.
average_color: Nicht zu verwechseln mit der dominanten Farbe, die eine einzelne, am häufigsten vorkommende Pixelfarbe zählt und nur begrenzte Anwendungsfälle hat. Die Durchschnittsfarbe wird berechnet, indem das Eingabebild zunächst auf 1 Pixel skaliert wird.
has_transparency: Gibt an, ob das Bild transparente Bereiche hat. Setzen Sie output_meta.has_transparency auf true, um eine Transparenzprüfung anzufordern. Werte, die bekanntermaßen negativ sind, etwa false bei JPEG-Bildern, können auch dann zurückgegeben werden, wenn diese Option weggelassen wird oder false ist. Wird output_meta selbst auf false gesetzt, wird die zusätzliche Metadatenextraktion übersprungen; grundlegende Prüfungen von Dateityp und Dateigröße können dennoch ausgeführt werden.
dominant_colors: Gibt ein Array mit bis zu 10 dominanten Bildfarben als Hexadezimalwerte zurück. Lassen Sie output_meta.dominant_colors weg, um diese Extraktion zu überspringen. Wird die Eigenschaft angegeben, auch mit false, wird die Extraktion angefordert, und es können zusätzliche Nutzungsgebühren anfallen, wenn Farben zurückgegeben werden. Wird output_meta selbst auf false gesetzt, wird die zusätzliche Metadatenextraktion deaktiviert; grundlegende Prüfungen von Dateityp und Dateigröße können dennoch ausgeführt werden.

Videometadaten

Auch wenn es von der jeweiligen Datei abhängt, können Dateien, deren type video ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

width: Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeigeverhältnis vom Pixelverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.
height: Die Höhe des Mediums in Pixeln.
framerate: Die Bildrate des Videos, etwa 29.5.
video_bitrate: Die Video-Bitrate des Videos, etwa 500000.
video_codec: Der Videocodec des Videos, etwa "ffh264".
audio_bitrate: Die Audio-Bitrate in Bit pro Sekunde über alle Kanäle hinweg, etwa 128000.
audio_samplerate: Die Audio-Abtastrate in Hertz, etwa 44100.
audio_channels: Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.
audio_codec: Der Audiocodec, etwa "faad". Siehe die unterstützten Audiocodecs.
seekable: Gibt an, ob das Format des Videos das Springen an beliebige Positionen (Seeking) unterstützt, etwa true.
interlaced: Gibt an, ob das Video anscheinend das Zeilensprungverfahren (Interlacing) verwendet: true für Interlaced-Videos oder false für progressive Videos. Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn die Erkennung nicht angefordert wurde oder die angeforderte Erkennung kein eindeutiges Ergebnis lieferte. Das bloße Vorhandensein des Felds zeigt nicht, dass die Erkennung ausgeführt wurde.
field_order: Die von FFprobe gemeldete Halbbildreihenfolge, etwa "tt", "bb", "tb", "bt" oder "progressive". Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern, die dieses Diagnosefeld befüllt. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn die Erkennung nicht angefordert wurde oder die Halbbildreihenfolge nicht verfügbar war. Verwenden Sie interlaced für eine einfache Unterscheidung zwischen interlaced und progressiv.
interlace_detection: Diagnosedetails des Interlace-Detektors von Transloadit. Dieses Objekt kann sampled_frames, tff, bff, progressive, undetermined, confidence, method und ffprobe_field_order enthalten. Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn die Erkennung nicht angefordert wurde; prüfen Sie, ob ein Objekt ungleich null vorliegt, bevor Sie dessen Eigenschaften lesen.
colorspace: Der erkannte Farbraum des Mediums, etwa "sRGB" oder "Gray". Der Video-Farbraum ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Mit output_meta: false wird die Metadatenextraktion deaktiviert.
date_recorded: Datum und Uhrzeit der Aufnahme des Mediums. Ein einzelner gültiger String-Zeitstempel wird auf YYYY/MM/DD HH:MM:SS normalisiert. Enthält er eine Zeitzone, wird er nach UTC/GMT umgerechnet und endet auf GMT. Nicht parsebare String-Zeitstempel werden zu null. Numerische Zeitstempel und Listen wiederholter Datums-Tags behalten ihre ursprünglichen Werte.
date_file_created: Der von den Medienmetadaten gemeldete Erstellungszeitstempel, sofern verfügbar.
date_file_modified: Der vom Dateisystem oder von den eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
device_name: Der Name des Geräts, mit dem das Medium aufgenommen wurde, etwa "iPhone 3GS".
device_vendor: Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, etwa "Apple". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
device_software: Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, etwa "3.1.2".
latitude: Der Breitengrad, an dem das Medium aufgenommen wurde, etwa 52.5374.
longitude: Der Längengrad, an dem das Medium aufgenommen wurde, etwa 13.4034.

Sie können zum Beispiel in einem Import- oder Upload-Step Interlaced-Videos 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

Auch wenn es von der jeweiligen Datei abhängt, können Dateien, deren type audio ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

duration: Die Länge der Audiodatei in Sekunden.
audio_bitrate: Die Audio-Bitrate in Bit pro Sekunde über alle Kanäle hinweg, etwa 128000.
audio_samplerate: Die Audio-Abtastrate in Hertz, etwa 44100.
audio_channels: Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.
audio_codec: Der Audiocodec, etwa "faad". Siehe die unterstützten Audiocodecs.
artist: In den Medienmetadaten erfasste Künstlerinformationen. Wiederholte Tags werden als Liste zurückgegeben. Numerisch aussehende Namen sowie die Wörter true und false können als JSON-Zahlen oder Booleans ankommen, auch innerhalb von Listen. Prüfen Sie den Typ, bevor Sie String-Methoden verwenden oder über eine Liste iterieren.
mean_volume: Die mittlere Lautstärke der Audiodatei. Setzen Sie output_meta.mean_volume auf true, um die Messung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn die Messung nicht angefordert wurde oder der Wert nicht verfügbar war. Das bloße Vorhandensein des Felds zeigt nicht, dass die Messung ausgeführt wurde.

Metadaten von Office-Dokumenten

Dateien, deren type office ist, können diese Felder in meta enthalten, sofern sie in den gespeicherten Eigenschaften der Datei vorhanden sind. Diese Zählwerte werden von der Anwendung gemeldet, mit der das Dokument erstellt wurde; Transloadit berechnet sie nicht anhand des Inhalts neu, daher können sie fehlen oder veraltet sein.

page_count: Die Anzahl der Seiten. Bei Office-Dokumenten stammt sie aus den gespeicherten Eigenschaften der Datei.
word_count: Die in den Eigenschaften eines Office-Dokuments gespeicherte Wortanzahl.
character_count: Die in den Eigenschaften eines Office-Dokuments gespeicherte Zeichenanzahl.