通过

输出元数据

  • 项目

媒体服务徽标 v3

警告

Azure 媒体服务将于 2024 年 6 月 30 日停用。 有关详细信息，请参阅 AMS 停用指南。

编码作业与要执行部分编码任务的输入资产相关联。 例如，将 MP4 文件编码为 H.264 MP4 自适应比特率集；创建缩略图；创建叠加。 完成任务后，会生成一个输出资产。 输出资产包含视频、音频、缩略图和其他文件。 输出资产还包含提供输出资产相关元数据的文件。 元数据 JSON 文件的名称采用以下格式：<source_file_name>_manifest.json（例如 BigBuckBunny_manifest.json）。 应扫描任何 *_metadata.json 并查询其中的文件路径字符串，以找到源文件名（无截断）。

媒体服务不会先扫描输入资产以生成元数据。 只有在作业中处理输入资产时，才会生成输入元数据。 因此，此项目会写入到输出资产。 使用不同的工具为输入资产和输出资产生成元数据。 因此，输入元数据的模式与输出元数据略有不同。

本文讨论作为输出元数据 (<source_file_name>_manifest.json) 的基础的 JSON 架构的元素和类型。

使用 CopyVideo 或 CopyAudio 预设时的 BaseName 字符长度

使用任何标准编码预设或自定义预设时，用于命名输出元数据文件的 {baseName} 文件命名宏都会缩短为 32 个字符。 但是，为避免在自定义预设中使用其中一种 CopyCodec 操作（CopyAudio 或CopyVideo）时发生命名冲突，{Basename} 限制为 64 个字符。 这是为了支持客户希望在其资产中将所有输出文件存档的情况。 如果文件名很长，前 32 个字符可能与多个输出文件相同。 在此情况下，使用 CopyVideo 或 CopyAudio 时，前 32 个字符将生成重复的输出文件。 因此，如果在预设中使用 CopyCodec，{Basename} 行为将保留 64 个字符。

可以在本文末尾找到完整的架构代码和 JSON 示例。

AssetFile

编码作业的 AssetFile 条目集合。

名称 说明
源 为生成此 AssetFile 而处理的输入/源媒体文件集合。
示例： "Sources": [{"Name": "Ignite-short_1280x720_AACAudio_3551.mp4"}]
VideoTracks 每个物理 AssetFile 都可包含交错成适当容器格式的零个或多个视频轨道。
请参阅 VideoTracks。
AudioTracks 每个物理 AssetFile 都可包含交错成适当容器格式的零个或多个音频轨道。 这是所有这些音频轨道的集合。
有关详细信息，请参阅 AudioTracks。
名称
必须		 媒体资产文件名称。

示例： "Name": "Ignite-short_1280x720_AACAudio_3551.mp4"
大小
必须		 以字节为单位的资产文件大小。

示例： "Size": 32414631
持续时间
必须		 内容播放持续时间。 有关详细信息，请参阅 ISO8601 格式。

示例： "Duration": "PT1M10.315S"

VideoTracks

每个物理 AssetFile 都可包含交错成适当容器格式的零个或多个视频轨道。 VideoTracks 元素表示其中包含所有视频轨道的一个集合。

“属性” 说明
Id
必须		 此视频轨道从零开始的索引。注意：此“ID”不一定是 MP4 文件中使用的 TrackID。

示例： "Id": 1
FourCC
必须		 ffmpeg 报告的视频编解码器 FourCC 代码。

示例： "FourCC": "avc1" | "hev1" | "hvc1"
Profile H264 配置文件（仅适用于 H264 编解码器）

示例： "Profile": "High"
级别 H264 级别（仅适用于 H264 编解码器）。

示例： "Level": "3.2"
Width
必须		 以像素为单位的编码视频宽度。

示例： "Width": "1280"
Height
必须		 以像素为单位的编码视频高度。

示例： "Height": "720"
DisplayAspectRatioNumerator
必须		 视频显示纵横比分子。

示例： "DisplayAspectRatioNumerator": 16.0
DisplayAspectRatioDenominator
必须		 视频显示纵横比分母。

示例： "DisplayAspectRatioDenominator": 9.0
Framerate
必须		 采用 .3f 格式的测量的视频帧速率。

示例： "Framerate": 29.970
Bitrate
必须		 由 AssetFile 计算所得的平均视频比特率（比特/秒）。 仅针对基本流有效负载计数，不包含打包开销。

示例： "Bitrate": 3551567
TargetBitrate
必须		 通过编码预设请求的此视频轨道的目标平均比特率（比特/秒）。

示例： "TargetBitrate": 3520000

AudioTracks

每个物理 AssetFile 都可包含交错成适当容器格式的零个或多个音频轨道。 AudioTracks 元素表示其中包含所有那些音频轨道的一个集合。

“属性” 说明
Id
必须		 此音频轨道从零开始的索引。注意：这不一定是 MP4 文件中使用的 TrackID。

示例： "Id": 2
Codec 音频轨道编解码器字符串。

示例： "Codec": "aac"
语言 示例： "Language": "eng"
通道
必须		 音频通道数。

示例： "Channels": 2
SamplingRate
必须		 音频采样率（样本数/秒或 Hz）。

示例： "SamplingRate": 48000
Bitrate
必须		 由 AssetFile 计算的平均音频比特率（以比特/秒为单位）。 仅针对基本流有效负载计数，不包含打包开销。

示例： "Bitrate": 128041

JSON 架构示例

{
  "AssetFile": [
    {
      "Sources": [
        {
          "Name": "Ignite-short_1280x720_AACAudio_3551.mp4"
        }
      ],
      "VideoTracks": [
        {
          "Id": 1,
          "FourCC": "avc1",
          "Profile": "High",
          "Level": "3.2",
          "Width": "1280",
          "Height": "720",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "Framerate": 29.970,
          "Bitrate": 3551567,
          "TargetBitrate": 3520000
        }
      ],
      "AudioTracks": [
        {
          "Id": 2,
          "Codec": "aac",
          "Language": "eng",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 128041
        }
      ],
      "Name": "Ignite-short_1280x720_AACAudio_3551.mp4",
      "Size": 32414631,
      "Duration": "PT1M10.315S"
    },
    {
      "Sources": [
        {
          "Name": "Ignite-short_960x540_AACAudio_2216.mp4"
        }
      ],
      "VideoTracks": [
        {
          "Id": 1,
          "FourCC": "avc1",
          "Profile": "High",
          "Level": "3.1",
          "Width": "960",
          "Height": "540",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "Framerate": 29.970,
          "Bitrate": 2216326,
          "TargetBitrate": 2210000
        }
      ],
      "AudioTracks": [
        {
          "Id": 2,
          "Codec": "aac",
          "Language": "eng",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 128041
        }
      ],
      "Name": "Ignite-short_960x540_AACAudio_2216.mp4",
      "Size": 20680897,
      "Duration": "PT1M10.315S"
    },
    {
      "Sources": [
        {
          "Name": "Ignite-short_640x360_AACAudio_1150.mp4"
        }
      ],
      "VideoTracks": [
        {
          "Id": 1,
          "FourCC": "avc1",
          "Profile": "High",
          "Level": "3.0",
          "Width": "640",
          "Height": "360",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "Framerate": 29.970,
          "Bitrate": 1150440,
          "TargetBitrate": 1150000
        }
      ],
      "AudioTracks": [
        {
          "Id": 2,
          "Codec": "aac",
          "Language": "eng",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 128041
        }
      ],
      "Name": "Ignite-short_640x360_AACAudio_1150.mp4",
      "Size": 11313920,
      "Duration": "PT1M10.315S"
    },
    {
      "Sources": [
        {
          "Name": "Ignite-short_480x270_AACAudio_722.mp4"
        }
      ],
      "VideoTracks": [
        {
          "Id": 1,
          "FourCC": "avc1",
          "Profile": "High",
          "Level": "2.1",
          "Width": "480",
          "Height": "270",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "Framerate": 29.970,
          "Bitrate": 722682,
          "TargetBitrate": 720000
        }
      ],
      "AudioTracks": [
        {
          "Id": 2,
          "Codec": "aac",
          "Language": "eng",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 128041
        }
      ],
      "Name": "Ignite-short_480x270_AACAudio_722.mp4",
      "Size": 7554708,
      "Duration": "PT1M10.315S"
    },
    {
      "Sources": [
        {
          "Name": "Ignite-short_320x180_AACAudio_380.mp4"
        }
      ],
      "VideoTracks": [
        {
          "Id": 1,
          "FourCC": "avc1",
          "Profile": "High",
          "Level": "1.3",
          "Width": "320",
          "Height": "180",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "Framerate": 29.970,
          "Bitrate": 380655,
          "TargetBitrate": 380000
        }
      ],
      "AudioTracks": [
        {
          "Id": 2,
          "Codec": "aac",
          "Language": "eng",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 128041
        }`
      ],
      "Name": "Ignite-short_320x180_AACAudio_380.mp4",
      "Size": 4548932,
      "Duration": "PT1M10.315S"
    }
  ]
}

获得帮助和支持

如果有任何疑问，可以联系媒体服务，或者使用以下方法之一关注我们的更新：