Metadados de entrada
Aviso
Os Serviços de Mídia do Azure serão desativados em 30 de junho de 2024. Para obter mais informações, consulte o Guia de Desativação do AMS.
Um trabalho de codificação é associado um ativo (ou ativos) de entrada no qual você deseja executar algumas tarefas de codificação. Após a conclusão de uma tarefa, um ativo de saída é produzido. O ativo de saída contém vídeo, áudio, miniaturas, manifesto e outros arquivos.
O ativo de saída também contém um arquivo com metadados sobre o ativo de entrada. O nome do arquivo JSON de metadados tem uma ID aleatória; não a utilize para identificar o ativo de entrada ao qual o ativo de saída pertence. Para identificar o ativo de entrada ao qual ele pertence, use o campo Uri (para obter mais informações, confira Outros elementos filho).
Os Serviços de Mídia não examinam preventivamente os ativos de entrada para gerar metadados. Os metadados de entrada são gerados apenas como um artefato quando um ativo de entrada é processado em um Trabalho. Portanto, esse artefato é gravado no ativo de saída. Diferentes ferramentas são usadas para gerar metadados para ativos de entrada e ativos de saída. Portanto, os metadados de entrada têm um esquema um pouco diferente dos metadados de saída.
Este artigo discute os elementos e os tipos do esquema JSON no qual os metadados de entrada (<asset_id>_metadata.json) se baseiam. Para saber mais sobre o arquivo que contém metadados sobre o ativo de saída, confira Metadados de saída.
Você pode encontrar o exemplo de esquema JSON no final deste artigo.
Observação
Todo o tempo é baseado no formato ISO-8601. Para obter mais informações sobre formatação de duração, consulte Tempos e Durações no mesmo artigo.
AssetFile
Contém uma coleção de elementos AssetFile para o trabalho de codificação.
Observação
Os quatro elementos filhos a seguir devem aparecer em uma sequência.
| Nome | Descrição |
|---|---|
| VideoTracks | Cada arquivo de ativo físico pode conter nenhuma ou mais faixas de vídeos intercaladas em um formato de contêiner apropriado. Para obter mais informações, confira VideoTracks. |
| AudioTracks | Cada arquivo de ativo físico pode conter nenhuma ou mais faixas de áudio intercaladas em um formato de contêiner apropriado. Para obter mais informações, confira AudioTracks |
| Metadados | Metadados do arquivo de ativo representados como cadeias de caracteres de chave\valor. Por exemplo: <Metadata key="language" value="eng" /> |
Outros elementos filho
| Nome | Descrição |
|---|---|
|
Nome Obrigatório |
Nome do arquivo de ativo. Exemplo: "Name": "Ignite-short.mp4" |
|
Uri Obrigatório |
A URL em que o ativo de entrada está localizado. Para identificar o ativo de entrada ao qual o ativo de saída pertence, use o campo Uri em vez da ID. |
|
Tamanho Obrigatório |
Tamanho do arquivo de ativo em bytes. Exemplo: "Size": 75739259 |
|
Duration Obrigatório |
Duração da reprodução de conteúdo. Exemplo: "Duration": "PT1M10.304S". |
|
NumberOfStreams Obrigatório |
Número de fluxos no arquivo de ativo. Exemplo: "NumberOfStreams": 2 |
|
FormatNames Obrigatório |
Nomes de formato. Exemplo: "FormatNames": "mov,mp4,m4a,3gp,3g2,mj2" |
|
FormatVerboseName Obrigatório |
Nomes detalhados de formato. Exemplo: "FormatVerboseName": "QuickTime / MOV" |
| StartTime | Hora de início do conteúdo. Exemplo: "StartTime": "PT0S" |
| OverallBitRate | Taxa de bits média do arquivo de ativo em bits por segundo. Exemplo: "OverallBitRate": 8618539 |
VideoTracks
| Nome | Descrição |
|---|---|
|
FourCC Obrigatório |
Código FourCC do codec de vídeo que é relatado por 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" |
|
Largura Obrigatório |
Largura do vídeo codificado em pixels. Exemplo: "Width": "1280" |
|
Altura Obrigatório |
Altura do vídeo codificado em pixels. Exemplo: "Height": "720" |
|
DisplayAspectRatioNumerator Obrigatório |
Numerador de taxa de proporção de exibição do vídeo. Exemplo: "DisplayAspectRatioNumerator": 16.0 |
|
DisplayAspectRatioDenominator Obrigatório |
Denominador de taxa de proporção de exibição do vídeo. Exemplo: "DisplayAspectRatioDenominator": 9.0 |
| SampleAspectRatioNumerator | Numerador de proporção de amostra de vídeo. Exemplo: "SampleAspectRatioNumerator": 1.0 |
| SampleAspectRatioDenominator | Exemplo: "SampleAspectRatioDenominator": 1.0 |
|
FrameRate Obrigatório |
Medida de taxa de quadros de vídeo em formato .3f. Exemplo: "FrameRate": 29.970 |
| Bitrate | Taxa média de bits de vídeo em bits por segundo, calculada com base no arquivo do ativo. Apenas a carga de fluxo elementar é contada, e a sobrecarga de empacotamento não está incluída. Exemplo: "Bitrate": 8421583 |
| HasBFrames | Número de faixas de vídeo de quadros B. Exemplo: "HasBFrames": 2 |
| Metadados | As cadeias de caracteres de chave/valor genéricas que podem ser usadas para armazenar uma variedade de informações. Confira o exemplo completo no final do artigo. |
|
Id Obrigatório |
Índice baseado em zero da faixa de áudio ou de vídeo. Essa ID não é necessariamente o TrackID assim como utilizado em um arquivo MP4. Exemplo: "Id": 2 |
| Codec | Cadeia de caracteres de codec de faixa de vídeo. Exemplo: "Codec": "h264 | hev1" |
| CodecLongName | Nome longo de codec de faixa de áudio ou vídeo. Exemplo: "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10" |
| Codec | Cadeia de caracteres de codec de faixa de vídeo. Exemplo: "Codec": "h264 | hev1" |
|
TimeBase Obrigatório |
Base de tempo. Exemplo: "TimeBase": "1/30000" |
| NumberOfFrames | Número de quadros (presentes em faixas de vídeo). Exemplo: "NumberOfFrames": 2107 |
| StartTime | Hora de início da faixa. Exemplo: "StartTime": "PT0.033S" |
| Duration | Duração da faixa. Exemplo: "Duration": "PT1M10.304S" |
AudioTracks
| Nome | Descrição |
|---|---|
| SampleFormat | Formato de exemplo. Exemplo: "SampleFormat": "fltp" |
| ChannelLayout | Layout do canal. Exemplo: "ChannelLayout": "stereo" |
|
Canais Obrigatório |
Número (0 ou mais) de canais de áudio. Exemplo: "Channels": 2 |
|
SamplingRate Obrigatório |
Taxa de amostragem de áudio em amostras/s ou Hz. Exemplo: "SamplingRate": 48000 |
| Bitrate | Taxa média de bits de áudio em bits por segundo, calculada com base no arquivo de ativo. Apenas a carga de fluxo elementar é contada, e a sobrecarga de empacotamento não está incluída nesta contagem. Exemplo: "Bitrate": 192080 |
| Metadados | As cadeias de caracteres de chave/valor genéricas que podem ser usadas para armazenar uma variedade de informações. Confira o exemplo completo no final do artigo. |
|
Id Obrigatório |
Índice baseado em zero da faixa de áudio ou de vídeo. Essa não é necessariamente a TrackID como usada em um arquivo MP4. Exemplo: "Id": 1 |
| Codec | Cadeia de caracteres de codec de faixa de vídeo. Exemplo: "Codec": "aac" |
| CodecLongName | Nome longo de codec de faixa de áudio ou vídeo. Exemplo: "CodecLongName": "AAC (Advanced Audio Coding)" |
|
TimeBase Obrigatório |
Base de tempo. Exemplo: "TimeBase": "1/48000" |
| NumberOfFrames | Número de quadros (presentes em faixas de vídeo). Exemplo: "NumberOfFrames": 3294 |
| StartTime | Hora de início da faixa. Exemplo: "StartTime": "PT0S" |
| Duration | Duração da faixa. Exemplo: "Duration": "PT1M10.272S" |
Metadados
| Nome | Descrição |
|---|---|
|
chave Obrigatório |
A chave do par chave/valor. |
|
value Obrigató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
Você pode entrar em contato com os Serviços de Mídia com perguntas ou seguir nossas atualizações por um dos seguintes métodos:
- P & R
-
Stack Overflow. Marque perguntas com
azure-media-services. - @MSFTAzureMedia ou use @AzureSupport para solicitar suporte.
- Abra um tíquete de suporte por meio do portal do Azure.