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, womit sie erstellt wurde. Wenn sie mit einem iPhone erstellt wurde, enthält sie wahrscheinlich latitude für die geografische Positionierung. Häufigere Schlüssel sind height und duration.

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

id: Eine zufällige und eindeutige ID, die Transloadit intern zur Nachverfolgung der Datei verwendet.
name: Der Name der Datei. Transloadit ändert die für dieses Feld verwendete Dateiendung, wenn die Datei in ein anderes Format verarbeitet wird.
basename: Der Name der Datei ohne die Dateiendung.
ext: Die Dateiendung. Kann null sein, wenn keine Dateiendung ermittelt wurde, oder eine leere Zeichenfolge bei einem Namen ohne Dateiendung.
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 andere Zeichenfolgen akzeptieren, damit zukünftige Kategorien kompatibel bleiben.
field: Der Name des Formularfelds, über das diese Datei übermittelt wurde.
url: Eine URL, über die 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 zur späteren Verwendung in einen Speicher. Ergebnisse aus privatem Speicher von /transloadit/store geben sowohl für url als auch für ssl_url den Wert null zurück. Bewahren Sie den zurückgegebenen Workspace sowie asset_id und version_id als dauerhafte Referenz auf, vorbehaltlich der Zugriffs- und Aufbewahrungsregeln. /transloadit/import akzeptiert asset_id mit einer optionalen version_id oder einen veränderlichen path. Weder eine temporäre URL noch die id der verarbeiteten Datei ist eine dauerhafte Speicherreferenz.
original_id: Die eindeutige ID der ursprünglich hochgeladenen Datei, aus der diese Datei erzeugt wurde. Dies ist hilfreich, um nach mehreren Steps der Verarbeitung zu ermitteln, welche Datei eines Uploads mit mehreren Dateien zur Erzeugung einer bestimmten Datei verwendet wurde.
meta: Ein Objekt mit zusätzlichen Metadaten, die aus der Datei extrahiert wurden, wie unten gezeigt. 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

Obwohl es von der jeweiligen Datei abhängt, können Dateien, deren type den Wert image hat, typischerweise Daten wie die folgenden in der Eigenschaft meta enthalten:

width: Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeige-Seitenverhältnis vom Pixel-Seitenverhä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, wenn die Bildhöhe aus irgendeinem Grund 0 ist.
date_recorded: Das Datum und die Uhrzeit, zu denen das Medium aufgenommen wurde. Ein einzelner gültiger Zeitstempel als Zeichenfolge wird auf YYYY/MM/DD HH:MM:SS normalisiert. Wenn eine Zeitzone vorhanden ist, wird er in UTC/GMT umgewandelt und endet auf GMT. Nicht interpretierbare Zeitstempel-Zeichenfolgen 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 den eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
title: Der Titel dieses Bildes, zum Beispiel "Tree".
keywords: Aus den Metadaten der Datei extrahierte Schlüsselwörter: eine Zeichenfolge, eine endliche Zahl oder ein Array, dessen Einträge Zeichenfolgen, endliche Zahlen oder boolesche Werte sein können. Zum Beispiel ["tree", "nature"]. Das Feld kann fehlen oder null sein. Prüfen Sie vor dem Iterieren seinen Typ; Array-Einträge sind nicht zwangsläufig Zeichenfolgen.
description: Eine Beschreibung dieses Bildes, zum Beispiel "This tree is very old.".
location: Der Ort, an dem dieses Bild aufgenommen wurde, in der Regel 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 befüllen dieses Feld anstelle von creator.
copyright: Das Metadatenfeld für das Urheberrecht.
copyright_notice: Das Metadatenfeld für den Urheberrechtshinweis.
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 in den Bildmetadaten gespeicherte Ländercode, zum Beispiel "de" oder 528. Zeichenfolgen und numerische Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie Zeichenfolgenmethoden verwenden.
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: Die Belichtungsmessmethode 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 Name des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "iPhone 3GS".
device_vendor: Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "Apple".
device_software: Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "3.1.2".
latitude: Der Breitengrad, an dem das Medium aufgenommen wurde, zum Beispiel 52.5374.
longitude: Der Längengrad, an dem das Medium aufgenommen wurde, zum Beispiel 13.4034.
thumb_index: Der Index des aktuellen Vorschaubildes, beginnend bei 0. Dieser Schlüssel ist nur in Ergebnissen von 🤖/video/thumbs vorhanden.
thumb_offset: Der zeitliche Versatz des aktuellen Vorschaubildes in Sekunden. Dieser Schlüssel ist nur in Ergebnissen von 🤖/video/thumbs vorhanden.
frame_count: Die Anzahl der Einzelbilder in einer animierten GIF-Datei. Für alle anderen Bildtypen ist dies standardmäßig 1.
colorspace: Der erkannte Farbraum des Mediums, zum Beispiel "sRGB" oder "Gray". Der Videofarbraum ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Die Einstellung output_meta: false deaktiviert die Metadatenextraktion.
has_clipping_path: Ist true, wenn das Bild einen Beschneidungspfad enthält, andernfalls false.
average_color: Nicht zu verwechseln mit der dominanten Farbe, die anhand der am häufigsten vorkommenden Pixelfarbe bestimmt wird und nur begrenzte Anwendungsfälle hat. Die Durchschnittsfarbe wird berechnet, indem das Eingabebild zunächst auf 1 Pixel skaliert wird.
has_transparency: Ob das Bild transparente Bereiche enthält. Setzen Sie output_meta.has_transparency auf true, um eine Prüfung auf Transparenz anzufordern. Werte, die bekanntermaßen dem booleschen Wert false entsprechen, wie false für JPEG-Bilder, 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 des Dateityps und der Dateigröße können weiterhin 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. Die Angabe der Eigenschaft, auch mit dem Wert false, fordert die Extraktion an und kann zusätzliche Nutzungsgebühren verursachen, wenn Farben zurückgegeben werden. Wird output_meta selbst auf false gesetzt, wird die zusätzliche Metadatenextraktion deaktiviert; grundlegende Prüfungen des Dateityps und der Dateigröße können weiterhin ausgeführt werden.

Videometadaten

Obwohl es von der jeweiligen Datei abhängt, können Dateien, deren type den Wert video hat, typischerweise Daten wie die folgenden in der Eigenschaft meta enthalten:

width: Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeige-Seitenverhältnis vom Pixel-Seitenverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.
height: Die Höhe des Mediums in Pixeln.
framerate: Die Bildrate des Videos, zum Beispiel 29.5.
video_bitrate: Die Videobitrate des Videos, zum Beispiel 500000.
video_codec: Der Videocodec des Videos, zum Beispiel "ffh264".
audio_bitrate: Die Audiobitrate in Bits pro Sekunde über alle Kanäle hinweg, zum Beispiel 128000.
audio_samplerate: Die Audio-Abtastrate in Hertz, zum Beispiel 44100.
audio_channels: Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.
audio_codec: Der Audiocodec, zum Beispiel "faad". Siehe die unterstützten Audiocodecs.
seekable: Ob das Format des Videos das Springen zu einer bestimmten Position unterstützt, zum Beispiel true.
interlaced: Ob das Video offenbar das Zeilensprungverfahren verwendet: true für Videos mit Zeilensprungverfahren 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 keine Erkennung angefordert wurde oder wenn die angeforderte Erkennung kein eindeutiges Ergebnis lieferte. Das Vorhandensein des Felds allein zeigt nicht, dass die Erkennung ausgeführt wurde.
field_order: Die von FFprobe gemeldete Halbbildreihenfolge, zum Beispiel "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 keine Erkennung angefordert wurde oder die Halbbildreihenfolge nicht verfügbar war. Verwenden Sie interlaced für einfache Verzweigungen zwischen Videos mit Zeilensprungverfahren und progressiven Videos.
interlace_detection: Diagnosedetails aus der Zeilensprungerkennung 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 keine Erkennung angefordert wurde; prüfen Sie, ob ein Objekt mit einem anderen Wert als null vorliegt, bevor Sie dessen Eigenschaften lesen.
colorspace: Der erkannte Farbraum des Mediums, zum Beispiel "sRGB" oder "Gray". Der Videofarbraum ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Die Einstellung output_meta: false deaktiviert die Metadatenextraktion.
date_recorded: Das Datum und die Uhrzeit, zu denen das Medium aufgenommen wurde. Ein einzelner gültiger Zeitstempel als Zeichenfolge wird auf YYYY/MM/DD HH:MM:SS normalisiert. Wenn eine Zeitzone vorhanden ist, wird er in UTC/GMT umgewandelt und endet auf GMT. Nicht interpretierbare Zeitstempel-Zeichenfolgen 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 den eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
device_name: Der Name des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "iPhone 3GS".
device_vendor: Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "Apple".
device_software: Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, zum Beispiel "3.1.2".
latitude: Der Breitengrad, an dem das Medium aufgenommen wurde, zum Beispiel 52.5374.
longitude: Der Längengrad, an dem das Medium aufgenommen wurde, zum Beispiel 13.4034.

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 es von der jeweiligen Datei abhängt, können Dateien, deren type den Wert audio hat, typischerweise Daten wie die folgenden in der Eigenschaft meta enthalten:

duration: Die Länge der Audiodatei in Sekunden.
audio_bitrate: Die Audiobitrate in Bits pro Sekunde über alle Kanäle hinweg, zum Beispiel 128000.
audio_samplerate: Die Audio-Abtastrate in Hertz, zum Beispiel 44100.
audio_channels: Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.
audio_codec: Der Audiocodec, zum Beispiel "faad". Siehe die unterstützten Audiocodecs.
artist: In den Medienmetadaten gespeicherte Informationen zu den Kunstschaffenden. Wiederholte Tags werden als Liste zurückgegeben. Namen, die wie Zahlen aussehen, und die Wörter true und false können als JSON-Zahlen oder boolesche Werte vorliegen, auch innerhalb von Listen. Prüfen Sie den Typ, bevor Sie Zeichenfolgenmethoden 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 keine Messung angefordert wurde oder der Wert nicht verfügbar war. Das Vorhandensein des Felds allein zeigt nicht, dass die Messung ausgeführt wurde.

Metadaten von Office-Dokumenten

Dateien, deren type den Wert office hat, können diese Felder in meta enthalten, wenn sie in den gespeicherten Eigenschaften der Datei vorhanden sind. Diese Anzahlen 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.