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, 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 foi um iPhone, provavelmente há uma 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 examine nossa resposta após enviar um arquivo por lá.

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 pela 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. /transloadit/store atribui a url/ssl_url uma URL assinada do Smart CDN, ou null sem uma chave. Guarde o Workspace, o asset_id e o version_id retornados para ter uma referência duradoura, 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 é uma referência duradoura ao Storage.
original_id: O ID único do arquivo enviado originalmente a partir do qual este arquivo foi gerado. Isso é útil para determinar qual arquivo de um envio com 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 dos seus valores originais. Verifique o tipo do valor antes de usá-lo como uma única marca de data e hora.

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 em 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 gravada. Uma única marca de data e hora válida em formato de string é normalizada para YYYY/MM/DD HH:MM:SS. Quando há um fuso horário, ela é convertida para UTC/GMT e termina em GMT. Marcas de data e hora em formato de string que não podem ser interpretadas tornam-se null. Marcas de data e hora numéricas e listas de tags de data repetidas mantêm seus valores originais.
date_file_created: A marca de data e hora de criação informada pelos metadados da mídia, quando disponível.
date_file_modified: A marca de data e hora de modificação informada 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 onde esta imagem foi capturada, que geralmente é a rua, como "Zingster Str. 32". Os valores de metadados em formato de string e numéricos são preservados; verifique o tipo antes de usar métodos de string.
creator: Os metadados do criador extraídos do arquivo. Os valores escalares originais, incluindo listas desses valores, são preservados; verifique o tipo antes de usar métodos de string.
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: Os metadados do aviso de direitos autorais extraídos do arquivo. Os valores escalares originais são preservados; verifique o tipo antes de usar métodos de string.
city: A cidade onde esta imagem foi capturada, como "Berlin".
state: O estado onde esta imagem foi capturada, como "Berlin".
country: O país onde esta imagem foi capturada, como "Germany".
country_code: O código do país registrado nos metadados da imagem, como "de" ou 528. Os valores em formato de string e numéricos são preservados; verifique o tipo antes de usar métodos de string.
aperture: A configuração de abertura desta imagem, como 5.7.
exposure_compensation: A compensação de exposição desta imagem, como "+4/3".
exposure_mode: O modo de exposição desta imagem, como "Auto".
exposure_time: O tempo de exposição desta imagem, como "1/30".
flash: As configurações de flash desta imagem, como "Off, Did not fire".
focal_length: A distância focal desta imagem, como "55.0 mm".
f_number: O número f desta imagem, como 5.6.
iso: O valor ISO desta imagem, como 800.
light_value: O valor de luminosidade desta imagem, como 6.9.
metering_mode: O modo de medição desta imagem, como "Multi-segment".
shutter_speed: A velocidade do obturador desta imagem, como "1/32".
white_balance: A configuração de balanço de branco desta imagem, como "Manual". Os valores de metadados em formato de string e numéricos são preservados; verifique o tipo antes de usar métodos de string.
device_name: O nome do dispositivo que gravou a mídia, como "iPhone 3GS".
device_vendor: O fabricante do dispositivo que gravou a mídia, como "Apple". Os valores de metadados em formato de string e numéricos são preservados; verifique o tipo antes de usar métodos de string.
device_software: A versão do software do dispositivo que gravou a mídia, como "3.1.2".
latitude: A latitude em que a mídia foi gravada, como 52.5374.
longitude: A longitude em que a mídia foi gravada, como 13.4034.
thumb_index: O índice da miniatura atual, começando em 0. Esta chave só está presente nos resultados de 🤖/video/thumbs.
thumb_offset: O deslocamento da miniatura atual, em segundos. Esta chave só está presente 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 da mídia, como "sRGB" ou "Gray". O espaço de cores do vídeo está disponível quando é detectado com a extração de metadados ativada; isso não exige output_meta.colorspace: true. Definir output_meta: false desativa 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 contabiliza a única 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 que sabidamente correspondem ao booleano falso, 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 do tipo e do tamanho do arquivo ainda podem ser executadas.
dominant_colors: Retorna um array de até 10 cores dominantes da imagem como valores hexadecimais. Omita output_meta.dominant_colors para ignorar 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 forem retornadas. Definir o próprio output_meta como false desativa a extração de metadados adicionais; verificações básicas do tipo e do 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 em 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, como 500000.
video_codec: O codec de 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 de á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". Consulte os codecs de áudio compatíveis.
seekable: Indica se o formato do vídeo permite navegar para posições específicas, 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 como 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 como null quando a detecção não foi solicitada ou a ordem dos campos não estava disponível. Use interlaced para uma lógica condicional 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 como 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 da mídia, como "sRGB" ou "Gray". O espaço de cores do vídeo está disponível quando é detectado com a extração de metadados ativada; isso não exige output_meta.colorspace: true. Definir output_meta: false desativa a extração de metadados.
date_recorded: A data e a hora em que a mídia foi gravada. Uma única marca de data e hora válida em formato de string é normalizada para YYYY/MM/DD HH:MM:SS. Quando há um fuso horário, ela é convertida para UTC/GMT e termina em GMT. Marcas de data e hora em formato de string que não podem ser interpretadas tornam-se null. Marcas de data e hora numéricas e listas de tags de data repetidas mantêm seus valores originais.
date_file_created: A marca de data e hora de criação informada pelos metadados da mídia, quando disponível.
date_file_modified: A marca de data e hora de modificação informada pelo sistema de arquivos ou pelos metadados incorporados à mídia.
device_name: O nome do dispositivo que gravou a mídia, como "iPhone 3GS".
device_vendor: O fabricante do dispositivo que gravou a mídia, como "Apple". Os valores de metadados em formato de string e numéricos são preservados; verifique o tipo antes de usar métodos de string.
device_software: A versão do software do dispositivo que gravou a mídia, como "3.1.2".
latitude: A latitude em que a mídia foi gravada, como 52.5374.
longitude: A longitude em que a mídia foi gravada, como 13.4034.

Por exemplo, você pode detectar vídeos entrelaçados 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 de á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". Consulte os codecs de áudio compatíveis.
artist: Informações do artista registradas nos metadados da mídia. Tags repetidas são retornadas como uma lista. Nomes com aparência numérica e as palavras true e false podem chegar como números ou booleanos JSON, inclusive dentro de listas. Verifique o tipo antes de usar métodos de string ou iterar uma lista.
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 como 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.

Metadados de documentos do Office

Arquivos cujo type é office podem incluir estes campos em meta, quando presentes nas propriedades armazenadas do arquivo. Essas contagens são informadas pelo aplicativo de criação do documento; a Transloadit não as recalcula a partir do conteúdo, portanto elas podem estar ausentes ou desatualizadas.

page_count: O número de páginas. Para documentos do Office, esse valor vem das propriedades armazenadas do arquivo.
word_count: A contagem de palavras armazenada nas propriedades de um documento do Office.
character_count: A contagem de caracteres armazenada nas propriedades de um documento do Office.