Metadados de entrada

Artigo
01/09/2023

Aviso

Os Serviços de Multimédia do Azure serão descontinuados a 30 de junho de 2024. Para obter mais informações, veja o Guia de Extinção do AMS.

Uma tarefa de codificação está associada a um recurso de entrada (ou recursos) no qual pretende realizar algumas tarefas de codificação. Após a conclusão de uma tarefa, é produzido um recurso de saída. O elemento de saída contém vídeo, áudio, miniaturas, manifesto e outros ficheiros.

O recurso de saída também contém um ficheiro com metadados sobre o recurso de entrada. O nome do ficheiro JSON de metadados tem um ID aleatório, não o utilize para identificar o recurso de entrada ao qual o recurso de saída pertence. Para identificar o elemento de entrada ao qual pertence, utilize o Uri campo (para obter mais informações, consulte Outros elementos subordinados).

Os Serviços de Multimédia não analisam preventivamente os recursos de entrada para gerar metadados. Os metadados de entrada são gerados apenas como um artefacto quando um recurso de entrada é processado numa Tarefa. Por conseguinte, este artefacto é escrito no elemento de saída. São utilizadas diferentes ferramentas para gerar metadados para recursos de entrada e recursos de saída. Por conseguinte, os metadados de entrada têm um esquema ligeiramente diferente dos metadados de saída.

Este artigo aborda os elementos e tipos do esquema JSON no qual se baseia o metadados de entrada (<asset_id>_metadata.json ). Para obter informações sobre o ficheiro que contém metadados sobre o recurso de saída, veja Metadados de saída.

Pode encontrar o exemplo de esquema JSON no final deste artigo.

Nota

Todo o tempo é baseado no formato ISO-8601. Para obter mais informações sobre a formatação de duração, veja Times and Durations ( Horas e Durações ) no mesmo artigo.

AssetFile

Contém uma coleção de elementos AssetFile para a tarefa de codificação.

Nota

Os quatro elementos subordinados seguintes têm de aparecer numa sequência.

Nome	Descrição
VideoTracks	Cada ficheiro de recurso físico pode conter zero ou mais vídeos que são controlados entrelaçados num formato de contentor adequado. Para obter mais informações, veja VideoTracks.
AudioTracks	Cada ficheiro de elemento físico pode conter zero ou mais faixas de áudio intercaladas num formato de contentor adequado. Para obter mais informações, veja AudioTracks
Metadados	Metadados do ficheiro de recurso representados como cadeias chave\valor. Por exemplo: `<Metadata key="language" value="eng" />`

Outros elementos subordinados

Nome	Descrição
Nome Necessário	Nome do ficheiro de recurso. Exemplo: `"Name": "Ignite-short.mp4"`
URI Necessário	O URL onde o recurso de entrada está localizado. Para identificar o recurso de entrada ao qual pertence o recurso de saída, utilize o `Uri` campo em vez do ID.
Tamanho Necessário	Tamanho do ficheiro de recursos em bytes. Exemplo: `"Size": 75739259`
Duration Necessário	Duração da reprodução de conteúdos. Exemplo: `"Duration": "PT1M10.304S"`.
NumberOfStreams Necessário	Número de fluxos no ficheiro de recursos. Exemplo: `"NumberOfStreams": 2`
FormatNames Necessário	Formatar nomes. Exemplo: `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName Necessário	Formatar nomes verbosos. Exemplo: `"FormatVerboseName": "QuickTime / MOV"`
StartTime	Hora de início do conteúdo. Exemplo: `"StartTime": "PT0S"`
OverallBitRate	Velocidade de transmissão média do ficheiro de recursos em bits por segundo. Exemplo: `"OverallBitRate": 8618539`

VideoTracks

Nome	Descrição
FourCC Necessário	Código FourCC do codec de vídeo comunicado pelo ffmpeg. Exemplo: `"FourCC": "avc1" \| "hev1" \| "hvc1"`
Perfil	Perfil da faixa de vídeo. Exemplo: `"Profile": "Main"`
Level	Nível da faixa de vídeo. Exemplo: `"Level": "3.2"`
PixelFormat	Formato de pixel da faixa de vídeo. Exemplo: `"PixelFormat": "yuv420p"`
Width Necessário	Largura de vídeo codificada em píxeis. Exemplo: `"Width": "1280"`
Height Necessário	Altura de vídeo codificada em píxeis. Exemplo: `"Height": "720"`
DisplayAspectRatioNumerator Necessário	Numerador de proporção de visualização de vídeo. Exemplo: `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator Necessário	Denominador de proporção de visualização de vídeo. Exemplo: `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	Numerador de proporção de exemplo de vídeo. Exemplo: `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	Exemplo: `"SampleAspectRatioDenominator": 1.0`
FrameRate Necessário	Taxa de fotogramas de vídeo medida no formato .3f. Exemplo: `"FrameRate": 29.970`
Velocidade de transmissão	Taxa média de bits de vídeo em bits por segundo, conforme calculado a partir do ficheiro de recurso. Apenas o payload de fluxo elementar é contado e a sobrecarga da embalagem não está incluída. Exemplo: `"Bitrate": 8421583`
HasBFrames	Número de registos de vídeo de fotogramas B. Exemplo: `"HasBFrames": 2`
Metadados	Cadeias de chave/valor genéricas que podem ser utilizadas para conter uma variedade de informações. Veja o exemplo completo no final do artigo.
ID Necessário	Índice baseado em zero desta faixa de áudio ou vídeo. Este ID não é necessariamente o TrackID utilizado num ficheiro MP4. Exemplo: `"Id": 2`
Codec	Cadeia de codec de faixa de vídeo. Exemplo: `"Codec": "h264 \| hev1"`
CodecLongName	Nome longo do codec de faixa de áudio ou vídeo. Exemplo: `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	Cadeia de codec de faixa de vídeo. Exemplo: `"Codec": "h264 \| hev1"`
TimeBase Necessário	Base de horas. Exemplo: `"TimeBase": "1/30000"`
NumberOfFrames	Número de frames (presentes para faixas de vídeo). Exemplo: `"NumberOfFrames": 2107`
StartTime	Controlar a hora de início. Exemplo: `"StartTime": "PT0.033S"`
Duration	Controlar a duração. Exemplo: `"Duration": "PT1M10.304S"`

AudioTracks

Nome	Descrição
SampleFormat	Formato de exemplo. Exemplo: `"SampleFormat": "fltp"`
ChannelLayout	Esquema de canal. Exemplo: `"ChannelLayout": "stereo"`
Channels (Canais) Necessário	Número (0 ou mais) de canais de áudio. Exemplo: `"Channels": 2`
AmostragemRate Necessário	Taxa de amostragem de áudio em exemplos/seg ou Hz. Exemplo: `"SamplingRate": 48000`
Velocidade de transmissão	Taxa média de bits de áudio em bits por segundo, conforme calculado a partir do ficheiro de recursos. Apenas o payload de fluxo elementar é contado e a sobrecarga da embalagem não está incluída nesta contagem. Exemplo: `"Bitrate": 192080`
Metadados	Cadeias de chave/valor genéricas que podem ser utilizadas para conter uma variedade de informações. Veja o exemplo completo no final do artigo.
ID Necessário	Índice baseado em zero desta faixa de áudio ou vídeo. Não é necessariamente o TrackID utilizado num ficheiro MP4. Exemplo: `"Id": 1`
Codec	Cadeia de codec de faixa de vídeo. Exemplo: `"Codec": "aac"`
CodecLongName	Nome longo do codec de faixa de áudio ou vídeo. Exemplo: `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase Necessário	Base de horas. Exemplo: `"TimeBase": "1/48000"`
NumberOfFrames	Número de frames (presentes para faixas de vídeo). Exemplo: `"NumberOfFrames": 3294`
StartTime	Controlar a hora de início. Exemplo: `"StartTime": "PT0S"`
Duration	Controlar a duração. Exemplo: `"Duration": "PT1M10.272S"`

Metadados

Nome	Descrição
tecla Necessário	A chave no par chave/valor.
value Necessário	O valor no par chave/valor.

Exemplo de esquema

{
  "AssetFile": [
    {
      "VideoTracks": [
        {
          "FourCC": "avc1",
          "Profile": "Main",
          "Level": "3.2",
          "PixelFormat": "yuv420p",
          "Width": "1280",
          "Height": "720",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "SampleAspectRatioNumerator": 1.0,
          "SampleAspectRatioNumeratorSpecified": true,
          "SampleAspectRatioDenominator": 1.0,
          "SampleAspectRatioDenominatorSpecified": true,
          "FrameRate": 29.970,
          "Bitrate": 8421583,
          "BitrateSpecified": true,
          "HasBFrames": 2,
          "HasBFramesSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Video Media Handler"
            },
            {
              "key": "encoder",
              "value": "AVC Coding"
            }
          ],
          "Id": 2,
          "Codec": "h264",
          "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "TimeBase": "1/30000",
          "NumberOfFrames": 2107,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0.033S",
          "Duration": "PT1M10.304S"
        }
      ],
      "AudioTracks": [
        {
          "SampleFormat": "fltp",
          "ChannelLayout": "stereo",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 192080,
          "BitrateSpecified": true,
          "BitsPerSampleSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Sound Media Handler"
            }
          ],
          "Id": 1,
          "Codec": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "TimeBase": "1/48000",
          "NumberOfFrames": 3294,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0S",
          "Duration": "PT1M10.272S"
        }
      ],
      "Metadata": [
        {
          "key": "major_brand",
          "value": "mp42"
        },
        {
          "key": "minor_version",
          "value": "19529854"
        },
        {
          "key": "compatible_brands",
          "value": "mp42isom"
        },
        {
          "key": "creation_time",
          "value": "2018-02-21T21:42:08.000000Z"
        }
      ],
      "Name": "Ignite-short.mp4",
      "Uri": "https://amsstorageacct.blob.core.windows.net/asset-00000000-0000-0000-000000000000/ignite.mp4",
      "Size": 75739259,
      "Duration": "PT1M10.304S",
      "NumberOfStreams": 2,
      "FormatNames": "mov,mp4,m4a,3gp,3g2,mj2",
      "FormatVerboseName": "QuickTime / MOV",
      "StartTime": "PT0S",
      "OverallBitRate": 8618539,
      "OverallBitRateSpecified": true
    }
  ]
}

Obter ajuda e suporte

Pode contactar os Serviços de Multimédia com perguntas ou seguir as nossas atualizações através de um dos seguintes métodos:

Q & A
Stack Overflow. Perguntas sobre etiquetas com azure-media-services.
@MSFTAzureMedia ou utilize @AzureSupport para pedir suporte.
Abra um pedido de suporte através do portal do Azure.

Partilhar via