Muitos arquivos contêm informações interessantes sobre seu conteúdo. Isso é chamado de “metadados”. A Transloadit extrai automaticamente esses metadados de todos os arquivos enviados por upload, importados e processados.

No mínimo, cada arquivo terá informações como:

{
  "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": {
    // …
  }
}

As informações que podemos extrair dependem do arquivo de mídia, do seu tipo e também de quem o produziu. Se ele foi produzido por um iPhone, provavelmente contém latitude para posicionamento geográfico. Outras chaves mais comuns incluem height e duration.

Para ver quais informações podemos extrair dos arquivos que você nos enviar, experimente uma das nossas demonstrações (English) e inspecione nossa resposta depois de fazer upload de um arquivo nela.

id: Um ID aleatório e único usado internamente pela Transloadit para rastrear o arquivo.
name: O nome do arquivo. A Transloadit alterará a extensão usada neste campo se o arquivo for processado para um formato diferente.
basename: O nome do arquivo sem a extensão.
ext: A extensão do arquivo. Pode ser null quando uma extensão não tiver sido determinada, ou uma string vazia para um nome sem extensão.
size: O tamanho do arquivo, em bytes.
mime: O tipo MIME determinado para este arquivo.
type: Uma categoria abstrata que descreve o arquivo. Os valores conhecidos são "audio", "document", "image", "office", "pdf", "swf", "video", "xls", ou null quando nenhuma categoria foi detectada. Os consumidores devem aceitar outras strings para manter a compatibilidade com categorias futuras.
field: O nome do campo de formulário usado para enviar este arquivo.
url: Uma URL da qual o arquivo pode ser baixado, ou null quando nenhuma URL de entrega está disponível. As URLs temporárias nos nossos servidores expiram após algumas horas; exporte os arquivos para armazenamento para uso posterior. Os resultados de armazenamento privado de /transloadit/store retornam null tanto para url quanto para ssl_url. Guarde o Workspace, o asset_id e o version_id retornados para ter uma referência durável, sujeita a acesso e retenção. /transloadit/import aceita asset_id com um version_id opcional, ou um path mutável. Nem uma URL temporária nem o id do arquivo de processamento são referências duráveis de armazenamento.
original_id: O ID único do arquivo original enviado por upload a partir do qual este arquivo foi gerado. Isso é útil para determinar qual arquivo de um upload de vários arquivos foi usado para gerar um determinado arquivo, após vários Steps de processamento.
meta: Um objeto que contém metadados adicionais extraídos do arquivo, conforme mostrado abaixo. Tags de data repetidas podem ser retornadas como listas de seus valores originais. Verifique o tipo do valor antes de usá-lo como um único timestamp.

Metadados de imagem

Embora isso dependa do arquivo em questão, arquivos cujo type é image normalmente podem conter dados como os seguintes na propriedade meta:

width: A largura da mídia em pixels. Para vídeos cuja proporção de exibição difere da proporção de pixels, esta é a largura de exibição pretendida.
height: A altura da mídia em pixels.
aspect_ratio: A proporção da imagem, que é sua largura dividida pela altura. Será 0 se, por algum motivo, a altura da imagem for 0.
date_recorded: A data e a hora em que a mídia foi registrada. Um único timestamp válido em formato de string é normalizado para YYYY/MM/DD HH:MM:SS. Quando há um fuso horário, o timestamp é convertido para UTC/GMT e termina em GMT. Timestamps em formato de string que não podem ser interpretados tornam-se null. Timestamps numéricos e listas de tags de data repetidas mantêm seus valores originais.
date_file_created: O timestamp de criação informado pelos metadados da mídia, quando disponível.
date_file_modified: O timestamp de modificação informado pelo sistema de arquivos ou pelos metadados incorporados à mídia.
title: O título desta imagem, como "Tree".
keywords: Palavras-chave extraídas dos metadados do arquivo: uma string, um número finito ou um array cujos elementos podem ser strings, números finitos ou booleanos. Por exemplo, ["tree", "nature"]. O campo pode estar ausente ou ser null. Verifique seu tipo antes de iterar; os elementos do array não são necessariamente strings.
description: Uma descrição desta imagem, como "This tree is very old.".
location: O local em que esta imagem foi capturada, geralmente o endereço, como "Zingster Str. 32".
creator: O criador que capturou a imagem.
author: O autor que capturou a imagem. Algumas câmeras preenchem este campo em vez de creator.
copyright: O campo de metadados de direitos autorais.
copyright_notice: O campo de metadados do aviso de direitos autorais.
city: A cidade em que esta imagem foi capturada, como "Berlin".
state: O estado em que esta imagem foi capturada, como "Berlin".
country: O país em que esta imagem foi capturada, como "Germany".
country_code: O código do país em que esta imagem foi capturada, como "de".
aperture: A configuração de abertura para esta imagem, como 5.7.
exposure_compensation: A compensação de exposição para esta imagem, como "+4/3".
exposure_mode: O modo de exposição para esta imagem, como "Auto".
exposure_time: O tempo de exposição para esta imagem, como "1/30".
flash: As configurações de flash para esta imagem, como "Off, Did not fire".
focal_length: A distância focal para esta imagem, como "55.0 mm".
f_number: O número f para esta imagem, como 5.6.
iso: O valor ISO para esta imagem, como 800.
light_value: O valor de luz para esta imagem, como 6.9.
metering_mode: O modo de medição para esta imagem, como "Multi-segment".
shutter_speed: A velocidade do obturador para esta imagem, como "1/32".
white_balance: A configuração de balanço de branco para esta imagem, como "Manual".
device_name: O nome do dispositivo que registrou a mídia, como "iPhone 3GS".
device_vendor: O fabricante do dispositivo que registrou a mídia, como "Apple".
device_software: A versão do software do dispositivo que registrou a mídia, como "3.1.2".
latitude: A latitude em que a mídia foi registrada, como 52.5374.
longitude: A longitude em que a mídia foi registrada, como 13.4034.
thumb_index: O índice da miniatura atual, começando em 0. Esta chave está presente apenas nos resultados de 🤖/video/thumbs.
thumb_offset: O deslocamento da miniatura atual, em segundos. Esta chave está presente apenas nos resultados de 🤖/video/thumbs.
frame_count: O número de quadros em um arquivo GIF animado. O valor padrão é 1 para todos os outros tipos de imagem.
colorspace: O espaço de cores detectado na mídia, como "sRGB" ou "Gray". O espaço de cores do vídeo está disponível quando detectado enquanto a extração de metadados está habilitada; não exige output_meta.colorspace: true. Definir output_meta: false desabilita a extração de metadados.
has_clipping_path: É true se a imagem contém um caminho de recorte, e false caso contrário.
average_color: Não deve ser confundida com a cor dominante, que considera apenas a cor de pixel mais frequente e tem casos de uso limitados. A cor média é calculada primeiro redimensionando a imagem de entrada para 1 pixel.
has_transparency: Indica se a imagem tem áreas transparentes. Defina output_meta.has_transparency como true para solicitar a inspeção de transparência. Valores booleanos sabidamente falsos, como false para imagens JPEG, podem ser retornados mesmo quando esta opção é omitida ou é false. Definir o próprio output_meta como false faz com que a extração de metadados adicionais seja ignorada; verificações básicas de tipo e tamanho do arquivo ainda podem ser executadas.
dominant_colors: Retorna um array com até 10 cores dominantes da imagem como valores hexadecimais. Omita output_meta.dominant_colors para não realizar esta extração. Fornecer a propriedade, inclusive com o valor false, solicita a extração e pode gerar cobranças adicionais de uso quando cores são retornadas. Definir o próprio output_meta como false desabilita a extração de metadados adicionais; verificações básicas de tipo e tamanho do arquivo ainda podem ser executadas.

Metadados de vídeo

Embora isso dependa do arquivo em questão, arquivos cujo type é video normalmente podem conter dados como os seguintes na propriedade meta:

width: A largura da mídia em pixels. Para vídeos cuja proporção de exibição difere da proporção de pixels, esta é a largura de exibição pretendida.
height: A altura da mídia em pixels.
framerate: A taxa de quadros do vídeo, como 29.5.
video_bitrate: A taxa de bits de vídeo do vídeo, como 500000.
video_codec: O codec de vídeo do vídeo, como "ffh264".
audio_bitrate: A taxa de bits de áudio em bits por segundo considerando todos os canais, como 128000.
audio_samplerate: A taxa de amostragem do áudio em hertz, como 44100.
audio_channels: O número de canais de áudio, normalmente 2 para estéreo.
audio_codec: O codec de áudio, como "faad". Veja os codecs de áudio compatíveis.
seekable: Indica se o formato do vídeo permite saltar para uma posição específica, como true.
interlaced: Indica se o vídeo parece usar varredura entrelaçada: true para vídeos entrelaçados ou false para vídeos progressivos. Defina output_meta.interlaced como true para solicitar a detecção. Esta chave pode estar presente com o valor null quando a detecção não foi solicitada ou quando a detecção solicitada foi inconclusiva. A presença do campo, por si só, não indica que a detecção foi executada.
field_order: A ordem dos campos informada pelo FFprobe, como "tt", "bb", "tb", "bt" ou "progressive". Defina output_meta.interlaced como true para solicitar a detecção que preenche este campo de diagnóstico. Esta chave pode estar presente com o valor null quando a detecção não foi solicitada ou a ordem dos campos não estava disponível. Use interlaced para ramificações simples entre entrelaçado e progressivo.
interlace_detection: Detalhes de diagnóstico do detector de entrelaçamento da Transloadit. Este objeto pode incluir sampled_frames, tff, bff, progressive, undetermined, confidence, method e ffprobe_field_order. Defina output_meta.interlaced como true para solicitar a detecção. Esta chave pode estar presente com o valor null quando a detecção não foi solicitada; verifique se há um objeto não nulo antes de ler suas propriedades.
colorspace: O espaço de cores detectado na mídia, como "sRGB" ou "Gray". O espaço de cores do vídeo está disponível quando detectado enquanto a extração de metadados está habilitada; não exige output_meta.colorspace: true. Definir output_meta: false desabilita a extração de metadados.
date_recorded: A data e a hora em que a mídia foi registrada. Um único timestamp válido em formato de string é normalizado para YYYY/MM/DD HH:MM:SS. Quando há um fuso horário, o timestamp é convertido para UTC/GMT e termina em GMT. Timestamps em formato de string que não podem ser interpretados tornam-se null. Timestamps numéricos e listas de tags de data repetidas mantêm seus valores originais.
date_file_created: O timestamp de criação informado pelos metadados da mídia, quando disponível.
date_file_modified: O timestamp de modificação informado pelo sistema de arquivos ou pelos metadados incorporados à mídia.
device_name: O nome do dispositivo que registrou a mídia, como "iPhone 3GS".
device_vendor: O fabricante do dispositivo que registrou a mídia, como "Apple".
device_software: A versão do software do dispositivo que registrou a mídia, como "3.1.2".
latitude: A latitude em que a mídia foi registrada, como 52.5374.
longitude: A longitude em que a mídia foi registrada, como 13.4034.

Por exemplo, você pode detectar vídeo entrelaçado em um Step de importação ou upload e encaminhar apenas esses arquivos para um Step subsequente:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle",
      "output_meta": {
        "interlaced": true
      }
    },
    "only_interlaced": {
      "use": ":original",
      "robot": "/file/filter",
      "accepts": [["${file.meta.interlaced}", "==", "true"]]
    }
  }
}

Metadados de áudio

Embora isso dependa do arquivo em questão, arquivos cujo type é audio normalmente podem conter dados como os seguintes na propriedade meta:

duration: A duração do arquivo de áudio em segundos.
audio_bitrate: A taxa de bits de áudio em bits por segundo considerando todos os canais, como 128000.
audio_samplerate: A taxa de amostragem do áudio em hertz, como 44100.
audio_channels: O número de canais de áudio, normalmente 2 para estéreo.
audio_codec: O codec de áudio, como "faad". Veja os codecs de áudio compatíveis.
artist: Muitos aplicativos que produzem áudio gravam informações adicionais no arquivo de áudio, como artist, year, album, genre.
mean_volume: O volume médio do arquivo de áudio. Defina output_meta.mean_volume como true para solicitar a medição. Esta chave pode estar presente com o valor null quando a medição não foi solicitada ou o valor não estava disponível. A presença do campo, por si só, não indica que a medição foi executada.