Metadatos
Muchos archivos contienen información interesante sobre su contenido. Esto se denomina “metadatos”. Transloadit extrae automáticamente estos metadatos de todos los archivos cargados, importados y procesados.
Como mínimo, cada archivo tendrá información como la siguiente:
{
"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": {
// …
}
}
La información que podemos extraer depende del archivo multimedia y de su tipo, pero también de quién lo produjo. Si
fue un iPhone, probablemente incluya latitude para la geolocalización. Otras claves más comunes son
height y duration.
Para ver qué información podemos extraer de los archivos que nos envíes, puedes probar una de nuestras demos (English) e inspeccionar nuestra respuesta después de cargar un archivo allí.
id-
Un ID aleatorio y único que Transloadit usa internamente para hacer seguimiento del archivo.
name-
El nombre del archivo. Transloadit cambiará la extensión usada en este campo si el archivo se procesa a un formato diferente.
basename-
El nombre del archivo sin la extensión.
ext-
La extensión del archivo. Puede ser
nullcuando no se ha determinado una extensión, o una cadena vacía para un nombre sin extensión. size-
El tamaño del archivo, en bytes.
mime-
El tipo MIME determinado para este archivo.
type-
Una categoría abstracta que describe el archivo. Los valores conocidos son
"audio","document","image","office","pdf","swf","video","xls", onullcuando no se detectó ninguna categoría. Los consumidores deben aceptar otras cadenas para que las categorías futuras sigan siendo compatibles. field-
El nombre del campo de formulario usado para enviar este archivo.
url-
Una URL desde la que se puede descargar el archivo, o
nullcuando no hay ninguna URL de entrega disponible. Las URLs temporales de nuestros servidores caducan al cabo de unas horas; exporta los archivos a un almacenamiento para usarlos más adelante./transloadit/storeasigna aurl/ssl_urluna URL firmada de Smart CDN, onullsi no hay clave. Conserva el Workspace devuelto, así comoasset_idyversion_id, como referencia duradera, sujeta al acceso y a la retención./transloadit/importaceptaasset_idcon unversion_idopcional, o unpathmutable. Ni una URL temporal ni eliddel archivo de procesamiento constituyen una referencia duradera de Storage. original_id-
El ID único del archivo cargado original a partir del cual se generó este archivo. Esto es útil para determinar qué archivo de una carga de varios archivos se usó para generar un archivo determinado, después de varios Steps de procesamiento.
meta-
Un objeto que contiene metadatos adicionales extraídos del archivo, como se muestra a continuación. Las etiquetas de fecha repetidas pueden devolverse como listas de sus valores originales. Comprueba el tipo del valor antes de usarlo como una única marca de tiempo.
Metadatos de imagen
Aunque depende del archivo en cuestión, los archivos cuyo type es image normalmente pueden contener datos
como los siguientes dentro de la propiedad meta:
width-
El ancho del contenido multimedia en píxeles. En los videos cuya relación de aspecto de visualización difiere de su relación de píxeles, es el ancho de visualización previsto.
height-
La altura del contenido multimedia en píxeles.
aspect_ratio-
La relación de aspecto de la imagen, es decir, su ancho dividido por su altura. Será 0 si, por algún motivo, la altura de la imagen es 0.
date_recorded-
La fecha y hora en que se grabó el contenido multimedia. Una única marca de tiempo de cadena válida se normaliza a
YYYY/MM/DD HH:MM:SS. Cuando hay una zona horaria, se convierte a UTC/GMT y termina enGMT. Las marcas de tiempo de cadena que no se pueden analizar se convierten ennull. Las marcas de tiempo numéricas y las listas de etiquetas de fecha repetidas conservan sus valores originales. date_file_created-
La marca de tiempo de creación indicada por los metadatos multimedia, cuando está disponible.
date_file_modified-
La marca de tiempo de modificación indicada por el sistema de archivos o por los metadatos multimedia incrustados.
title-
El título de esta imagen, como
"Tree". keywords-
Palabras clave extraídas de los metadatos del archivo: una cadena, un número finito o un array cuyas entradas pueden ser cadenas, números finitos o booleanos. Por ejemplo,
["tree", "nature"]. El campo puede estar ausente o sernull. Comprueba su tipo antes de iterar; las entradas del array no son necesariamente cadenas. description-
Una descripción de esta imagen, como
"This tree is very old.". location-
La ubicación en la que se tomó esta imagen, que suele ser la calle, como
"Zingster Str. 32". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. creator-
Los metadatos del creador extraídos del archivo. Se conservan los valores escalares originales, incluidas las listas de estos valores; comprueba el tipo antes de usar métodos de cadena.
author-
El autor que tomó la imagen. Algunas cámaras rellenan este campo en lugar de
creator. copyright-
El campo de metadatos de copyright.
copyright_notice-
Los metadatos del aviso de copyright extraídos del archivo. Se conservan los valores escalares originales; comprueba el tipo antes de usar métodos de cadena.
city-
La ciudad en la que se tomó esta imagen, como
"Berlin". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. state-
El estado en el que se tomó esta imagen, como
"Berlin". country-
El país en el que se tomó esta imagen, como
"Germany". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. country_code-
El código de país registrado en los metadatos de la imagen, como
"de"o528. Se conservan los valores de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. aperture-
El ajuste de apertura de esta imagen, como
5.7. exposure_compensation-
La compensación de exposición de esta imagen, como
"+4/3". exposure_mode-
El modo de exposición de esta imagen, como
"Auto". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. exposure_time-
El tiempo de exposición de esta imagen, como
"1/30". flash-
La configuración del flash de esta imagen, como
"Off, Did not fire". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. focal_length-
La distancia focal de esta imagen, como
"55.0 mm". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. f_number-
El número f de esta imagen, como
5.6. iso-
El valor ISO de esta imagen, como
800. light_value-
El valor de luz de esta imagen, como
6.9. metering_mode-
El modo de medición de esta imagen, como
"Multi-segment". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. shutter_speed-
La velocidad de obturación de esta imagen, como
"1/32". white_balance-
El ajuste de balance de blancos de esta imagen, como
"Manual". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. device_name-
El nombre del dispositivo que grabó el contenido multimedia, como
"iPhone 3GS". device_vendor-
El fabricante del dispositivo que grabó el contenido multimedia, como
"Apple". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. device_software-
La versión de software del dispositivo que grabó el contenido multimedia, como
"3.1.2". latitude-
La latitud en la que se grabó el contenido multimedia, como
52.5374. longitude-
La longitud en la que se grabó el contenido multimedia, como
13.4034. thumb_index-
El índice de la miniatura actual, empezando por 0. Esta clave solo está presente en los resultados de 🤖/video/thumbs.
thumb_offset-
El desplazamiento de la miniatura actual, en segundos. Esta clave solo está presente en los resultados de 🤖/video/thumbs.
frame_count-
El número de fotogramas de un archivo GIF animado. Es
1de forma predeterminada para todos los demás tipos de imagen. colorspace-
El espacio de color detectado del contenido multimedia, como
"sRGB"o"Gray". El espacio de color del video está disponible cuando se detecta mientras la extracción de metadatos está habilitada; no requiereoutput_meta.colorspace: true. Estableceroutput_meta: falsedeshabilita la extracción de metadatos. has_clipping_path-
Es
truesi la imagen contiene un trazado de recorte yfalseen caso contrario. average_color-
No debe confundirse con el color dominante, que contabiliza un único color de píxel, el más frecuente, y tiene casos de uso limitados. El color promedio se calcula escalando primero la imagen de entrada a 1 píxel.
has_transparency-
Este campo indica si la imagen tiene áreas transparentes. Establece
output_meta.has_transparencyentruepara solicitar la inspección de transparencia. Se pueden devolver valores falsos ya conocidos, comofalsepara imágenes JPEG, incluso cuando esta opción se omite o esfalse. Establecer el propiooutput_metaenfalseomite la extracción de metadatos adicionales; las comprobaciones básicas de tipo y tamaño de archivo pueden seguir ejecutándose. dominant_colors-
Transloadit devuelve un array de hasta 10 colores dominantes de la imagen como valores hexadecimales. Omite
output_meta.dominant_colorspara no realizar esta extracción. Proporcionar la propiedad, incluso confalse, solicita la extracción y puede generar cargos de uso adicionales cuando se devuelven colores. Si además establecesoutput_meta.dominant_colors_sampledentrue, solicitas colores aproximados y más rápidos sin cambiar la imagen de salida ni añadir otro cargo de metadatos. La paleta muestreada puede diferir y el método de muestreo puede cambiar. Establecer el propiooutput_metaenfalsedeshabilita la extracción de metadatos adicionales; las comprobaciones básicas de tipo y tamaño de archivo pueden seguir ejecutándose.
Metadatos de video
Aunque depende del archivo en cuestión, los archivos cuyo type es video normalmente pueden contener datos
como los siguientes dentro de la propiedad meta:
width-
El ancho del contenido multimedia en píxeles. En los videos cuya relación de aspecto de visualización difiere de su relación de píxeles, es el ancho de visualización previsto.
height-
La altura del contenido multimedia en píxeles.
framerate-
La velocidad de fotogramas del video, como
29.5. video_bitrate-
La tasa de bits de video del video, como
500000. video_codec-
El códec de video del video, como
"ffh264". audio_bitrate-
La tasa de bits de audio en bits por segundo sumando todos los canales, como
128000. audio_samplerate-
La frecuencia de muestreo de audio en hercios, como
44100. audio_channels-
El número de canales de audio, normalmente
2para estéreo. audio_codec-
El códec de audio, como
"faad". Consulta los códecs de audio compatibles. seekable-
Este campo indica si el formato del video admite la búsqueda de posición, como
true. interlaced-
Este campo indica si el video parece usar barrido entrelazado:
truepara videos entrelazados ofalsepara videos progresivos. Estableceoutput_meta.interlacedentruepara solicitar la detección. Esta clave puede estar presente comonullcuando no se solicitó la detección o cuando la detección solicitada no fue concluyente. La sola presencia del campo no indica que la detección se haya ejecutado. field_order-
El orden de campos indicado por FFprobe, como
"tt","bb","tb","bt"o"progressive". Estableceoutput_meta.interlacedentruepara solicitar la detección que rellena este campo de diagnóstico. Esta clave puede estar presente comonullcuando no se solicitó la detección o el orden de campos no estaba disponible. Usainterlacedpara una bifurcación simple entre entrelazado y progresivo. interlace_detection-
Detalles de diagnóstico del detector de entrelazado de Transloadit. Este objeto puede incluir
sampled_frames,tff,bff,progressive,undetermined,confidence,methodyffprobe_field_order. Estableceoutput_meta.interlacedentruepara solicitar la detección. Esta clave puede estar presente comonullcuando no se solicitó la detección; comprueba que haya un objeto no nulo antes de leer sus propiedades. colorspace-
El espacio de color detectado del contenido multimedia, como
"sRGB"o"Gray". El espacio de color del video está disponible cuando se detecta mientras la extracción de metadatos está habilitada; no requiereoutput_meta.colorspace: true. Estableceroutput_meta: falsedeshabilita la extracción de metadatos. date_recorded-
La fecha y hora en que se grabó el contenido multimedia. Una única marca de tiempo de cadena válida se normaliza a
YYYY/MM/DD HH:MM:SS. Cuando hay una zona horaria, se convierte a UTC/GMT y termina enGMT. Las marcas de tiempo de cadena que no se pueden analizar se convierten ennull. Las marcas de tiempo numéricas y las listas de etiquetas de fecha repetidas conservan sus valores originales. date_file_created-
La marca de tiempo de creación indicada por los metadatos multimedia, cuando está disponible.
date_file_modified-
La marca de tiempo de modificación indicada por el sistema de archivos o por los metadatos multimedia incrustados.
device_name-
El nombre del dispositivo que grabó el contenido multimedia, como
"iPhone 3GS". device_vendor-
El fabricante del dispositivo que grabó el contenido multimedia, como
"Apple". Se conservan los valores de metadatos de cadena y numéricos; comprueba el tipo antes de usar métodos de cadena. device_software-
La versión de software del dispositivo que grabó el contenido multimedia, como
"3.1.2". latitude-
La latitud en la que se grabó el contenido multimedia, como
52.5374. longitude-
La longitud en la que se grabó el contenido multimedia, como
13.4034.
Por ejemplo, puedes detectar video entrelazado en un Step de importación o de carga y dirigir solo esos archivos a un Step posterior:
{
"steps": {
":original": {
"robot": "/upload/handle",
"output_meta": {
"interlaced": true
}
},
"only_interlaced": {
"use": ":original",
"robot": "/file/filter",
"accepts": [["${file.meta.interlaced}", "==", "true"]]
}
}
}
Metadatos de audio
Aunque depende del archivo en cuestión, los archivos cuyo type es audio normalmente pueden contener datos
como los siguientes dentro de la propiedad meta:
duration-
La duración del archivo de audio en segundos.
audio_bitrate-
La tasa de bits de audio en bits por segundo sumando todos los canales, como
128000. audio_samplerate-
La frecuencia de muestreo de audio en hercios, como
44100. audio_channels-
El número de canales de audio, normalmente
2para estéreo. audio_codec-
El códec de audio, como
"faad". Consulta los códecs de audio compatibles. artist-
La información del artista registrada en los metadatos multimedia. Las etiquetas repetidas se devuelven como una lista. Los nombres con aspecto numérico y las palabras
trueyfalsepueden llegar como números o booleanos JSON, incluso dentro de listas. Comprueba el tipo antes de usar métodos de cadena o de iterar una lista. mean_volume-
El volumen medio del archivo de audio. Establece
output_meta.mean_volumeentruepara solicitar la medición. Esta clave puede estar presente comonullcuando no se solicitó la medición o el valor no estaba disponible. La sola presencia del campo no indica que la medición se haya ejecutado.
Metadatos de documentos de Office
Los archivos cuyo type es office pueden incluir estos campos dentro de meta, cuando están presentes en las
propiedades almacenadas del archivo. Estos recuentos los indica la aplicación con la que se creó el documento; Transloadit
no los recalcula a partir de su contenido, por lo que pueden faltar o estar desactualizados.
page_count-
El número de páginas. En los documentos de Office, este valor procede de las propiedades almacenadas del archivo.
word_count-
El recuento de palabras almacenado en las propiedades de un documento de Office.
character_count-
El recuento de caracteres almacenado en las propiedades de un documento de Office.