Metadaten
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 sie erstellt 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 zur Nachverfolgung der Datei verwendet.
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 Endung.
ext-
Die Endung der Datei. Kann
nullsein, wenn keine Endung ermittelt wurde, oder ein leerer String bei einem Namen ohne Endung. size-
Die Größe der Datei in Byte.
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"odernull, wenn keine Kategorie erkannt wurde. Konsumenten 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, unter 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 zur späteren Verwendung in einen Speicher./transloadit/storesetzt fürurl/ssl_urleine signierte Smart CDN URL oder ohne Schlüsselnull. Bewahren Sie den zurückgegebenen Workspace,asset_idundversion_idals dauerhafte Referenz auf, vorbehaltlich Zugriffsrechten und Aufbewahrungsregeln./transloadit/importakzeptiertasset_idmit optionalerversion_idoder einen veränderlichenpath. Weder eine temporäre URL noch dieidder Verarbeitungsdatei ist eine dauerhafte Storage-Referenz. original_id-
Die eindeutige ID der ursprünglich hochgeladenen Datei, aus der diese Datei erzeugt wurde. Das 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 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 image ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:
width-
Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeigeseitenverhältnis von ihrem Pixelseitenverhä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 Zeitstempel als String wird auf
YYYY/MM/DD HH:MM:SSnormalisiert. Ist eine Zeitzone angegeben, wird er in UTC/GMT umgerechnet und endet aufGMT. Nicht parsebare Zeitstempel-Strings werden zunull. 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 eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
title-
Der Titel dieses Bildes, z. B.
"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 boolesche Werte sein können. Zum Beispiel
["tree", "nature"]. Das Feld kann fehlen odernullsein. Prüfen Sie den Typ, bevor Sie darüber iterieren; Array-Einträge sind nicht zwingend Strings. description-
Eine Beschreibung dieses Bildes, z. B.
"This tree is very old.". location-
Der Ort, an dem dieses Bild aufgenommen wurde, in der Regel die Straße, z. B.
"Zingster Str. 32". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. creator-
Die aus der Datei extrahierten Metadaten zum Urheber. Ursprüngliche skalare Werte, einschließlich Listen dieser Werte, bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
author-
Der Autor, der das Bild aufgenommen hat. Manche Kameras befüllen dieses Feld statt
creator. copyright-
Das Copyright-Metadatenfeld.
copyright_notice-
Der aus der Datei extrahierte Copyright-Vermerk. Ursprüngliche skalare Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.
city-
Die Stadt, in der dieses Bild aufgenommen wurde, z. B.
"Berlin". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. state-
Das Bundesland bzw. der Bundesstaat, in dem dieses Bild aufgenommen wurde, z. B.
"Berlin". country-
Das Land, in dem dieses Bild aufgenommen wurde, z. B.
"Germany". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. country_code-
Der in den Bildmetadaten erfasste Ländercode, z. B.
"de"oder528. String- und numerische Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. aperture-
Die Blendeneinstellung für dieses Bild, z. B.
5.7. exposure_compensation-
Die Belichtungskorrektur für dieses Bild, z. B.
"+4/3". exposure_mode-
Der Belichtungsmodus für dieses Bild, z. B.
"Auto". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. exposure_time-
Die Belichtungszeit für dieses Bild, z. B.
"1/30". flash-
Die Blitzeinstellungen für dieses Bild, z. B.
"Off, Did not fire". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. focal_length-
Die Brennweite für dieses Bild, z. B.
"55.0 mm". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. f_number-
Die Blendenzahl für dieses Bild, z. B.
5.6. iso-
Der ISO-Wert für dieses Bild, z. B.
800. light_value-
Der Lichtwert für dieses Bild, z. B.
6.9. metering_mode-
Die Belichtungsmessmethode für dieses Bild, z. B.
"Multi-segment". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. shutter_speed-
Die Verschlusszeit für dieses Bild, z. B.
"1/32". white_balance-
Die Weißabgleichseinstellung für dieses Bild, z. B.
"Manual". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden. device_name-
Der Name des Geräts, mit dem das Medium aufgenommen wurde, z. B.
"iPhone 3GS". device_vendor-
Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, z. B.
"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, z. B.
"3.1.2". latitude-
Der Breitengrad, an dem das Medium aufgenommen wurde, z. B.
52.5374. longitude-
Der Längengrad, an dem das Medium aufgenommen wurde, z. B.
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 dies standardmäßig
1. colorspace-
Der erkannte Farbraum des Mediums, z. B.
"sRGB"oder"Gray". Der Farbraum von Videos ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür istoutput_meta.colorspace: truenicht erforderlich. Wenn Sieoutput_meta: falsesetzen, wird die Metadatenextraktion deaktiviert. has_clipping_path-
Ist
true, wenn das Bild einen Beschneidungspfad enthält, andernfallsfalse. average_color-
Nicht zu verwechseln mit der dominanten Farbe, die die 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-
Ob das Bild transparente Bereiche hat. Setzen Sie
output_meta.has_transparencyauftrue, um eine Transparenzprüfung anzufordern. Bereits feststehende false-Werte, etwafalsebei JPEG-Bildern, können auch dann zurückgegeben werden, wenn diese Option weggelassen wird oderfalseist. Wenn Sieoutput_metaselbst auffalsesetzen, wird die zusätzliche Metadatenextraktion übersprungen; grundlegende Prüfungen von Dateityp und Dateigröße können trotzdem laufen. dominant_colors-
Gibt ein Array mit bis zu 10 dominanten Bildfarben als Hexadezimalwerte zurück. Lassen Sie
output_meta.dominant_colorsweg, um diese Extraktion zu überspringen. Wird die Eigenschaft angegeben, auch mitfalse, wird die Extraktion angefordert, und es können zusätzliche Nutzungsgebühren anfallen, wenn Farben zurückgegeben werden. Wenn Sie zusätzlichoutput_meta.dominant_colors_sampledauftruesetzen, werden schnellere, angenäherte Farben angefordert, ohne das Ausgabebild zu verändern oder eine weitere Metadatengebühr zu verursachen. Die gesampelte Palette kann abweichen, und die Sampling-Methode kann sich ändern. Wenn Sieoutput_metaselbst auffalsesetzen, wird die zusätzliche Metadatenextraktion deaktiviert; grundlegende Prüfungen von Dateityp und Dateigröße können trotzdem laufen.
Videometadaten
Obwohl 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 Anzeigeseitenverhältnis von ihrem Pixelseitenverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.
height-
Die Höhe des Mediums in Pixeln.
framerate-
Die Bildrate des Videos, z. B.
29.5. video_bitrate-
Die Videobitrate des Videos, z. B.
500000. video_codec-
Der Videocodec des Videos, z. B.
"ffh264". audio_bitrate-
Die Audiobitrate in Bit pro Sekunde über alle Kanäle, z. B.
128000. audio_samplerate-
Die Audio-Abtastrate in Hertz, z. B.
44100. audio_channels-
Die Anzahl der Audiokanäle, typischerweise
2für Stereo. audio_codec-
Der Audiocodec, z. B.
"faad". Siehe die unterstützten Audiocodecs. seekable-
Ob das Format des Videos das Springen an beliebige Positionen (Seeking) unterstützt, z. B.
true. interlaced-
Ob das Video offenbar das Zeilensprungverfahren (Interlacing) verwendet:
truefür Interlaced-Videos oderfalsefür progressive Videos. Setzen Sieoutput_meta.interlacedauftrue, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wertnullvorhanden sein, wenn keine Erkennung angefordert wurde oder die angeforderte Erkennung kein eindeutiges Ergebnis lieferte. Allein das Vorhandensein des Felds zeigt nicht, dass die Erkennung ausgeführt wurde. field_order-
Die von FFprobe gemeldete Halbbildreihenfolge, z. B.
"tt","bb","tb","bt"oder"progressive". Setzen Sieoutput_meta.interlacedauftrue, um die Erkennung anzufordern, die dieses Diagnosefeld befüllt. Dieser Schlüssel kann mit dem Wertnullvorhanden sein, wenn keine Erkennung angefordert wurde oder die Halbbildreihenfolge nicht verfügbar war. Verwenden Sieinterlacedfür eine einfache Unterscheidung zwischen interlaced und progressiv. interlace_detection-
Diagnosedetails aus dem Interlace-Detektor von Transloadit. Dieses Objekt kann
sampled_frames,tff,bff,progressive,undetermined,confidence,methodundffprobe_field_orderenthalten. Setzen Sieoutput_meta.interlacedauftrue, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wertnullvorhanden sein, wenn keine Erkennung angefordert wurde; prüfen Sie auf ein Objekt ungleich null, bevor Sie dessen Eigenschaften lesen. colorspace-
Der erkannte Farbraum des Mediums, z. B.
"sRGB"oder"Gray". Der Farbraum von Videos ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür istoutput_meta.colorspace: truenicht erforderlich. Wenn Sieoutput_meta: falsesetzen, wird die Metadatenextraktion deaktiviert. date_recorded-
Datum und Uhrzeit der Aufnahme des Mediums. Ein einzelner gültiger Zeitstempel als String wird auf
YYYY/MM/DD HH:MM:SSnormalisiert. Ist eine Zeitzone angegeben, wird er in UTC/GMT umgerechnet und endet aufGMT. Nicht parsebare Zeitstempel-Strings werden zunull. 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 eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.
device_name-
Der Name des Geräts, mit dem das Medium aufgenommen wurde, z. B.
"iPhone 3GS". device_vendor-
Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, z. B.
"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, z. B.
"3.1.2". latitude-
Der Breitengrad, an dem das Medium aufgenommen wurde, z. B.
52.5374. longitude-
Der Längengrad, an dem das Medium aufgenommen wurde, z. B.
13.4034.
Beispielsweise können Sie 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
Obwohl 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 Audiobitrate in Bit pro Sekunde über alle Kanäle, z. B.
128000. audio_samplerate-
Die Audio-Abtastrate in Hertz, z. B.
44100. audio_channels-
Die Anzahl der Audiokanäle, typischerweise
2für Stereo. audio_codec-
Der Audiocodec, z. B.
"faad". Siehe die unterstützten Audiocodecs. artist-
In den Medienmetadaten erfasste Künstlerangaben. Wiederholte Tags werden als Liste zurückgegeben. Numerisch aussehende Namen sowie die Wörter
trueundfalsekönnen als JSON-Zahlen bzw. boolesche Werte 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_volumeauftrue, um die Messung anzufordern. Dieser Schlüssel kann mit dem Wertnullvorhanden sein, wenn keine Messung angefordert wurde oder der Wert nicht verfügbar war. Allein das 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.