Muchos archivos contienen información interesante sobre su contenido. Esta información 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, de su tipo y también de quién lo haya generado. Si se ha generado con un iPhone, probablemente incluya latitude para la geolocalización. Otras claves más habituales son height y duration.

Para ver qué información podemos extraer de los archivos que nos envíes, puedes probar una de nuestras demostraciones (English) e inspeccionar nuestra respuesta después de cargar un archivo allí.

id: Un ID aleatorio y único que Transloadit utiliza internamente para hacer un seguimiento del archivo.
name: El nombre del archivo. Transloadit cambiará la extensión utilizada en este campo si el archivo se procesa para convertirlo a un formato distinto.
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 si el nombre no tiene 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 ha detectado ninguna categoría. Los consumidores deben aceptar otras cadenas para mantener la compatibilidad con futuras categorías.
field: El nombre del campo del formulario utilizado 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 URL temporales de nuestros servidores caducan al cabo de unas horas; exporta los archivos al almacenamiento para usarlos más adelante. Los resultados de almacenamiento privado de /transloadit/store devuelven null tanto para url como para ssl_url. Conserva el Workspace, el asset_id y el version_id devueltos para disponer de una 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 de almacenamiento.
original_id: El ID único del archivo cargado originalmente a partir del cual se generó este archivo. Esto resulta útil para determinar qué archivo de una carga de varios archivos se utilizó 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 utilizarlo como una única marca de tiempo.

Metadatos de imágenes

Aunque depende del archivo en cuestión, los archivos cuyo type es image suelen poder contener datos como los siguientes dentro de la propiedad meta:

width: El ancho del contenido multimedia en píxeles. En los vídeos cuya relación de aspecto de visualización difiere de la relación de aspecto de sus píxeles, este 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, 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 la hora en que se grabó el contenido multimedia. Una única marca de tiempo válida en forma de cadena se normaliza a YYYY/MM/DD HH:MM:SS. Cuando incluye una zona horaria, se convierte a UTC/GMT y termina en GMT. Las marcas de tiempo en forma de cadena que no se pueden interpretar se convierten en 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 contenido multimedia, 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 contenido multimedia.
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 iterar sobre él; las entradas del array no son necesariamente cadenas.
description: Una descripción de esta imagen, como "This tree is very old.".
location: El lugar donde se tomó esta imagen, que suele ser la calle, como "Zingster Str. 32".
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 derechos de autor.
copyright_notice: El campo de metadatos del aviso de derechos de autor.
city: La ciudad donde se tomó esta imagen, como "Berlin".
state: El estado donde se tomó esta imagen, como "Berlin".
country: El país donde 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. Se conservan los valores de cadena y los numéricos; comprueba el tipo antes de utilizar 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: Los ajustes 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 contenido multimedia, como "iPhone 3GS".
device_vendor: El fabricante del dispositivo que grabó el contenido multimedia, como "Apple".
device_software: La versión del 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. El valor predeterminado es 1 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 vídeo 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 un único color de píxel, el más frecuente, y tiene casos de uso limitados. El color medio 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. Los valores que se sabe que son falsos, como false para las imágenes JPEG, pueden devolverse 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 del tipo y el tamaño del 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 omitir esta extracción. Proporcionar la propiedad, incluso con el valor false, solicita la extracción y puede generar cargos adicionales por uso cuando se devuelven colores. Establecer el propio output_meta en false deshabilita la extracción de metadatos adicionales; las comprobaciones básicas del tipo y el tamaño del archivo pueden seguir ejecutándose.

Metadatos de vídeo

Aunque depende del archivo en cuestión, los archivos cuyo type es video suelen poder contener datos como los siguientes dentro de la propiedad meta:

width: El ancho del contenido multimedia en píxeles. En los vídeos cuya relación de aspecto de visualización difiere de la relación de aspecto de sus píxeles, este es el ancho de visualización previsto.
height: La altura del contenido multimedia en píxeles.
framerate: La frecuencia de fotogramas del vídeo, como 29.5.
video_bitrate: La tasa de bits de vídeo del vídeo, como 500000.
video_codec: El códec de vídeo del vídeo, como "ffh264".
audio_bitrate: La tasa de bits de audio en bits por segundo para el conjunto de todos los canales, como 128000.
audio_samplerate: La frecuencia de muestreo del 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 vídeo permite desplazarse a otras posiciones, como true.
interlaced: Indica si el vídeo parece utilizar exploración entrelazada: true para vídeos entrelazados o false para vídeos progresivos. Establece output_meta.interlaced en true para solicitar la detección. Esta clave puede estar presente con el valor null cuando no se ha solicitado la detección o cuando la detección solicitada no ha sido concluyente. La mera presencia del campo no indica que se haya ejecutado la detección.
field_order: El orden de los 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 con el valor null cuando no se ha solicitado la detección o el orden de los campos no estaba disponible. Utiliza interlaced para una bifurcación sencilla 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 con el valor null cuando no se ha solicitado la detección; comprueba que sea 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 vídeo 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 la hora en que se grabó el contenido multimedia. Una única marca de tiempo válida en forma de cadena se normaliza a YYYY/MM/DD HH:MM:SS. Cuando incluye una zona horaria, se convierte a UTC/GMT y termina en GMT. Las marcas de tiempo en forma de cadena que no se pueden interpretar se convierten en 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 contenido multimedia, 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 contenido multimedia.
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".
device_software: La versión del 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 vídeo 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 suelen poder 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 para el conjunto de todos los canales, como 128000.
audio_samplerate: La frecuencia de muestreo del 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 contenido multimedia. 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 de JSON, incluso dentro de listas. Comprueba el tipo antes de utilizar métodos de cadena o iterar sobre 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 con el valor null cuando no se ha solicitado la medición o el valor no estaba disponible. La mera presencia del campo no indica que se haya ejecutado la medición.

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 proporciona 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, 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.