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 el geoposicionamiento. 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 rastrear el archivo.
name: El nombre del archivo. Transloadit cambiará la extensión usada en este campo si el archivo se procesa y se convierte a otro formato.
basename: El nombre del archivo sin la extensión.
ext: La extensión del archivo. Puede ser null cuando 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", o null cuando 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 null cuando no hay ninguna URL de entrega disponible. Las URLs temporales en nuestros servidores caducan al cabo de unas horas; exporta los archivos a un almacenamiento para usarlos más adelante. /transloadit/store asigna a url/ssl_url una URL firmada de Smart CDN, o null si no hay una clave. Conserva el Workspace, el asset_id y el version_id devueltos como referencia duradera, sujeta al acceso y a la retención. /transloadit/import acepta asset_id con un version_id opcional, o un path mutable. Ni una URL temporal ni el id del archivo de procesamiento son una referencia duradera al almacenamiento.
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 medio en píxeles. Para un video cuya relación de visualización difiere de su relación de píxeles, este es el ancho de visualización previsto.
height: La altura del medio en píxeles.
aspect_ratio: La relación de aspecto de la imagen, que es 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 medio. Una única marca de tiempo válida en forma de cadena se normaliza a YYYY/MM/DD HH:MM:SS. Cuando hay una zona horaria, se convierte a UTC/GMT y termina en GMT. Las marcas de tiempo en forma de cadena que no se pueden analizar pasan a ser null. 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 del medio, cuando está disponible.
date_file_modified: La marca de tiempo de modificación indicada por el sistema de archivos o por los metadatos incrustados en el medio.
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 ser null. Comprueba su tipo antes de iterarlo; 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 normalmente es la calle, como "Zingster Str. 32". Los valores de metadatos de tipo cadena y numéricos se conservan; comprueba el tipo antes de usar métodos de cadena.
creator: El creador que tomó la imagen.
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: El campo de metadatos del aviso de copyright.
city: La ciudad en la que se tomó esta imagen, como "Berlin".
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".
country_code: El código de país registrado en los metadatos de la imagen, como "de" o 528. Los valores de cadena y numéricos se conservan; 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".
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".
focal_length: La distancia focal de esta imagen, como "55.0 mm".
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".
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".
device_name: El nombre del dispositivo que grabó el medio, como "iPhone 3GS".
device_vendor: El fabricante del dispositivo que grabó el medio, como "Apple". Los valores de metadatos de tipo cadena y numéricos se conservan; comprueba el tipo antes de usar métodos de cadena.
device_software: La versión de software del dispositivo que grabó el medio, como "3.1.2".
latitude: La latitud en la que se grabó el medio, como 52.5374.
longitude: La longitud en la que se grabó el medio, como 13.4034.
thumb_index: El índice de la miniatura actual, empezando en 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 1 de forma predeterminada para todos los demás tipos de imagen.
colorspace: El espacio de color detectado del medio, como "sRGB" o "Gray". El espacio de color del video está disponible cuando se detecta mientras la extracción de metadatos está habilitada; no requiere output_meta.colorspace: true. Establecer output_meta: false deshabilita la extracción de metadatos.
has_clipping_path: Es true si la imagen contiene un trazado de recorte y false en caso contrario.
average_color: No debe confundirse con el color dominante, que cuenta el color de píxel que más se repite y tiene casos de uso limitados. El color promedio se calcula escalando primero la imagen de entrada a 1 píxel.
has_transparency: Indica si la imagen tiene áreas transparentes. Establece output_meta.has_transparency en true para solicitar la inspección de transparencia. Pueden devolverse valores booleanos falsos ya conocidos, como false para imágenes JPEG, incluso cuando esta opción se omite o es false. Establecer el propio output_meta en false omite la extracción de metadatos adicionales; las comprobaciones básicas de tipo y tamaño de archivo pueden seguir ejecutándose.
dominant_colors: Devuelve un array de hasta 10 colores dominantes de la imagen como valores hexadecimales. Omite output_meta.dominant_colors para no realizar esta extracción. Proporcionar la propiedad, incluso con valor false, solicita la extracción y puede generar cargos de uso adicionales cuando se devuelven colores. Establecer el propio output_meta en false deshabilita 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 medio en píxeles. Para un video cuya relación de visualización difiere de su relación de píxeles, este es el ancho de visualización previsto.
height: La altura del medio 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 2 para estéreo.
audio_codec: El códec de audio, como "faad". Consulta los códecs de audio compatibles.
seekable: Indica si el formato del video admite el desplazamiento a una posición concreta, como true.
interlaced: Indica si el video parece usar barrido entrelazado: true para videos entrelazados o false para videos progresivos. Establece output_meta.interlaced en true para solicitar la detección. Esta clave puede estar presente como null cuando no se solicitó la detección o cuando la detección solicitada no fue concluyente. La mera 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". Establece output_meta.interlaced en true para solicitar la detección que rellena este campo de diagnóstico. Esta clave puede estar presente como null cuando no se solicitó la detección o el orden de campos no estaba disponible. Usa interlaced para 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, method y ffprobe_field_order. Establece output_meta.interlaced en true para solicitar la detección. Esta clave puede estar presente como null cuando no se solicitó la detección; comprueba que sea un objeto no nulo antes de leer sus propiedades.
colorspace: El espacio de color detectado del medio, como "sRGB" o "Gray". El espacio de color del video está disponible cuando se detecta mientras la extracción de metadatos está habilitada; no requiere output_meta.colorspace: true. Establecer output_meta: false deshabilita la extracción de metadatos.
date_recorded: La fecha y hora en que se grabó el medio. Una única marca de tiempo válida en forma de cadena se normaliza a YYYY/MM/DD HH:MM:SS. Cuando hay una zona horaria, se convierte a UTC/GMT y termina en GMT. Las marcas de tiempo en forma de cadena que no se pueden analizar pasan a ser null. 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 del medio, cuando está disponible.
date_file_modified: La marca de tiempo de modificación indicada por el sistema de archivos o por los metadatos incrustados en el medio.
device_name: El nombre del dispositivo que grabó el medio, como "iPhone 3GS".
device_vendor: El fabricante del dispositivo que grabó el medio, como "Apple". Los valores de metadatos de tipo cadena y numéricos se conservan; comprueba el tipo antes de usar métodos de cadena.
device_software: La versión de software del dispositivo que grabó el medio, como "3.1.2".
latitude: La latitud en la que se grabó el medio, como 52.5374.
longitude: La longitud en la que se grabó el medio, 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 2 para estéreo.
audio_codec: El códec de audio, como "faad". Consulta los códecs de audio compatibles.
artist: Información del artista registrada en los metadatos del medio. Las etiquetas repetidas se devuelven como una lista. Los nombres con apariencia numérica y las palabras true y false pueden 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_volume en true para solicitar la medición. Esta clave puede estar presente como null cuando no se solicitó la medición o el valor no estaba disponible. La mera 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 proviene 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.