Metadatos

Muchos archivos contienen información interesante sobre su contenido. Esto se denomina "metadatos". Transloadit extrae automáticamente estos metadatos de todos los archivos subidos, 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 demostraciones (English) e inspeccionar nuestra respuesta después de subir allí un archivo.

id: Un ID aleatorio y único que Transloadit utiliza internamente para hacer seguimiento del archivo.
name: El nombre del archivo. Transloadit cambiará la extensión utilizada 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.
size: El tamaño del archivo, en bytes.
mime: El tipo MIME determinado para este archivo.
type: Un tipo abstracto que describe el archivo y que actualmente puede ser "image", "video", "audio" o null.
field: El nombre del campo del formulario utilizado para enviar este archivo.
url: La URL desde la que se puede acceder a este archivo. Puede ser una URL de tu bucket de S3 o una URL temporal de nuestros servidores. Como las URL temporales vencen después de unas horas, asegúrate de mover tus archivos a otro lugar, a menos que uses un Robot de almacenamiento.
original_id: El ID único del archivo original subido a partir del cual se generó este archivo. Esto resulta útil para determinar qué archivo de una subida 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.

Metadatos de imágenes

Aunque depende del archivo en cuestión, los archivos cuyo tipo MIME es image normalmente pueden contener datos como los siguientes dentro de la propiedad meta:

width: El ancho de la imagen de entrada, en píxeles.
height: La altura de la imagen de entrada, en píxeles.
aspect_ratio: La relación de aspecto de la imagen, es decir, su ancho dividido entre 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 tomó esta imagen, con el formato YYYY/MM/DD HH:MM:SS TZ, por ejemplo, "2010/06/30 22:16:06 GMT".
date_file_created: La hora de creación en el sistema de archivos.
date_file_modified: La hora de modificación en el sistema de archivos.
title: El título de esta imagen, por ejemplo, "Tree".
keywords: Un arreglo de palabras clave para esta imagen, por ejemplo, ["tree", "nature"].
description: Una descripción de esta imagen, por ejemplo, "This tree is very old.".
location: La ubicación donde se tomó esta imagen, que normalmente corresponde a la calle, por ejemplo, "Zingster Str. 32".
creator: La persona que creó y tomó la imagen.
author: La persona autora que tomó la imagen. Algunas cámaras completan 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, por ejemplo, "Berlin".
state: El estado donde se tomó esta imagen, por ejemplo, "Berlin".
country: El país donde se tomó esta imagen, por ejemplo, "Germany".
country_code: El código del país donde se tomó esta imagen, por ejemplo, "de".
aperture: La configuración de apertura de esta imagen, por ejemplo, 5.7.
exposure_compensation: La compensación de exposición de esta imagen, por ejemplo, "+4/3".
exposure_mode: El modo de exposición de esta imagen, por ejemplo, "Auto".
exposure_time: El tiempo de exposición de esta imagen, por ejemplo, "1/30".
flash: La configuración del flash de esta imagen, por ejemplo, "Off, Did not fire".
focal_length: La distancia focal de esta imagen, por ejemplo, "55.0 mm".
f_number: El número f de esta imagen, por ejemplo, 5.6.
iso: El valor ISO de esta imagen, por ejemplo, 800.
light_value: El valor de luz de esta imagen, por ejemplo, 6.9.
metering_mode: El modo de medición de esta imagen, por ejemplo, "Multi-segment".
shutter_speed: La velocidad de obturación de esta imagen, por ejemplo, "1/32".
white_balance: La configuración del balance de blancos de esta imagen, por ejemplo, "Manual".
device_name: El nombre del dispositivo de la cámara, por ejemplo, "iPhone 3GS".
device_vendor: El fabricante de la cámara, por ejemplo, "Apple".
device_software: La versión del software del dispositivo de la cámara, por ejemplo, "3.1.2".
latitude: La latitud donde se tomó esta imagen, por ejemplo, 52.5374.
longitude: La longitud donde se tomó esta imagen, por ejemplo, 13.4034.
thumb_index: El índice de la miniatura actual, comenzando 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. El valor predeterminado es 1 para todos los demás tipos de imágenes.
colorspace: El espacio de color de la imagen. Por ejemplo, podría ser "sRGB" o "Gray". En la primera versión de la pila de ImageMagick de Transloadit, hay un error que hace que los colores utilizados en una imagen determinen su colorspace, por lo que una imagen con colores en escala de grises indicaría "Gray", incluso si se guardó como "RGB".
has_clipping_path: Es 1 si la imagen contiene un trazado de recorte y 0 en caso contrario.
average_color: No debe confundirse con el color dominante, que identifica el color de píxel más frecuente y tiene casos de uso limitados. El color promedio se calcula reduciendo primero la imagen de entrada a 1 píxel.
has_transparency: Devuelve true para las imágenes que tienen áreas transparentes. Esta clave solo se devuelve si configuras output_meta.has_transparency como true.
dominant_colors: Devuelve un arreglo con los 20 colores más utilizados en las imágenes. Esta clave solo se devuelve si configuras output_meta.dominant_colors como true.

Metadatos de video

Aunque depende del archivo en cuestión, los archivos cuyo tipo MIME es video normalmente pueden contener datos como los siguientes dentro de la propiedad meta:

width: El ancho del video, en píxeles. Si el video se diseñó para mostrarse con una relación de visualización diferente de la relación de píxeles, este valor indica el ancho con el que debe mostrarse el video.
height: La altura del video, en píxeles.
framerate: La velocidad de fotogramas del video, por ejemplo, 29.5.
video_bitrate: La tasa de bits del video, por ejemplo, 500000.
video_codec: El códec de video, por ejemplo, "ffh264".
audio_bitrate: La tasa de bits del audio del video, por ejemplo, 128000.
audio_samplerate: La frecuencia de muestreo del audio del video, por ejemplo, 44100.
audio_channels: El número de canales de audio del video, por ejemplo, 2.
audio_codec: El códec de audio del video, por ejemplo, "faad".
seekable: Indica si el formato del video permite desplazarse por él, por ejemplo, true.
interlaced: Indica si el video parece utilizar escaneo entrelazado. Es true para videos entrelazados, false para videos progresivos y null si la detección no fue concluyente. Esta clave solo se devuelve si configuras output_meta.interlaced como true.
field_order: El orden de campos informado por FFprobe, por ejemplo, "tt", "bb", "tb", "bt", "progressive" o null. Trátalo como metadatos de diagnóstico y utiliza interlaced para una bifurcación sencilla entre contenido entrelazado y progresivo. Esta clave solo se devuelve si configuras output_meta.interlaced como true.
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. Esta clave solo se devuelve si configuras output_meta.interlaced como true.
colorspace: El espacio de color del video. Por ejemplo, podría ser "sRGB" o "Gray". Esta clave solo se devuelve si configuras output_meta.colorspace como true.
date_recorded: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
date_file_created: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
date_file_modified: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
device_name: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
device_vendor: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
device_software: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
latitude: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.
longitude: Para obtener más detalles, consulta la descripción de los metadatos de imágenes.

Por ejemplo, puedes detectar videos entrelazados en un Step de importación o subida 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 tipo MIME 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: Bits por segundo (para todos los canales combinados).
audio_samplerate: La frecuencia de muestreo del audio en hercios, por ejemplo, 44100 para un CD.
audio_channels: Número de canales. Normalmente 2 para estéreo.
audio_codec: El códec de audio utilizado. Esta es una lista de todos los códecs de audio compatibles con Transloadit.
artist: Muchas aplicaciones que producen audio escriben información adicional en el archivo de audio, como artist, year, album y genre.
mean_volume: El volumen promedio del archivo de audio. Esta clave solo se devuelve si configuras output_meta.mean_volume como true.