入力メタデータ

[アーティクル]
06/30/2023

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。詳細については、 AMS 廃止ガイドを参照してください。

エンコードジョブは、エンコーディングタスクを実行する入力資産に関連付けられています。タスクが完了すると、出力資産が生成されます。出力資産には、ビデオ、オーディオ、サムネイル、マニフェスト、およびその他のファイルが含まれます。

この出力資産には、入力資産に関するメタデータが格納されたファイルも含まれます。メタデータ JSON ファイルの名前にはランダムな ID が含まれており、それを使用して、出力資産が属する入力資産を特定しないでください。属している入力資産を特定するには、Uri フィールドを使用します (詳細については、「その他の子要素」を参照してください)。

Media Services では、メタデータを生成するために入力資産は事前にスキャンされません。入力メタデータは、入力資産がジョブで処理されるときに、成果物としてのみ生成されます。そのため、この成果物は、出力資産に書き込まれます。入力資産と出力資産のメタデータの生成には、異なるツールが使用されます。したがって、入力メタデータには、出力メタデータとは若干異なるスキーマがあります。

この記事では、入力メタデータ (<asset_id>_metadata.json) が基づく JSON スキーマの要素と種類について説明します。出力資産に関するメタデータを含むファイルについては、「出力メタデータ」を参照してください。

JSON スキーマの例は、この記事の最後に記載されています。

注意

常に ISO-8601 形式に基づいています。期間書式設定の詳細は、同じアーティクルの時間と期間をご覧ください。

AssetFile

エンコードジョブの AssetFile 要素のコレクションが含まれます。

注意

次の 4 つの子要素は順番に表示されます。

名前	説明
VideoTracks	各物理資産ファイルには、適切なコンテナー形式にインターリーブされる 0 個以上のビデオトラックを含めることができます。詳細については、「VideoTracks」を参照してください。
AudioTracks	各物理資産ファイルには、適切なコンテナー形式にインターリーブされる 0 個以上のオーディオトラックを含めることができます。詳細については、「AudioTracks」を参照してください。
Metadata	キー\値文字列として表される資産ファイルのメタデータ。例: `<Metadata key="language" value="eng" />`

その他の子要素

名前	説明
名前必須	資産ファイルの名前。例: `"Name": "Ignite-short.mp4"`
Uri 必須	入力資産が配置されている URL。出力資産が属している入力資産を特定するには、ID ではなく `Uri` フィールドを使用します。
[サイズ] 必須	資産ファイルのサイズ (バイト単位)。例: `"Size": 75739259`
Duration 必須	コンテンツの再生時間。例: `"Duration": "PT1M10.304S"`.
NumberOfStreams 必須	資産ファイル内のストリーム数。例: `"NumberOfStreams": 2`
FormatNames 必須	形式の名前。例: `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName 必須	形式の詳細な名前。例: `"FormatVerboseName": "QuickTime / MOV"`
StartTime	コンテンツの開始時刻。例: `"StartTime": "PT0S"`
OverallBitRate	資産ファイルの平均ビットレート (ビット/秒)。例: `"OverallBitRate": 8618539`

VideoTracks

名前	説明
FourCC 必須	ffmpeg によって報告されるビデオコーデックの FourCC コード。例: `"FourCC": "avc1" \| "hev1" \| "hvc1"`
プロファイル	ビデオトラックのプロファイル。例: `"Profile": "Main"`
Level	ビデオトラックのレベル。例: `"Level": "3.2"`
PixelFormat	ビデオトラックのピクセル形式。例: `"PixelFormat": "yuv420p"`
Width 必須	エンコードされたビデオの幅 (ピクセル単位)。例: `"Width": "1280"`
Height 必須	エンコードされたビデオの高さ (ピクセル単位)。例: `"Height": "720"`
DisplayAspectRatioNumerator 必須	ビデオディスプレイの縦横比の分子。例: `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator 必須	ビデオディスプレイの縦横比の分母。例: `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	ビデオサンプルの縦横比の分子。例: `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	例: `"SampleAspectRatioDenominator": 1.0`
FrameRate 必須	.3f 形式の測定されたビデオフレームレート。例: `"FrameRate": 29.970`
Bitrate	資産ファイルから計算された平均ビデオビットレート (ビット/秒)。基本ストリームペイロードのみがカウントされます。パッケージのオーバーヘッドは含まれません。例: `"Bitrate": 8421583`
HasBFrames	B フレームのビデオトラック数。例: `"HasBFrames": 2`
Metadata	さまざまな情報を保持する際に使用できる汎用的なキー/値文字列。この記事の最後にある完全な例を参照してください。
Id 必須	このオーディオまたはビデオトラックの 0 から始まるインデックス。この Id は、必ずしも MP4 ファイルで使用されている TrackID であるとは限りません。例: `"Id": 2`
Codec	ビデオトラックコーデック文字列。例: `"Codec": "h264 \| hev1"`
CodecLongName	オーディオまたはビデオトラックコーデックの長い名前。例: `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	ビデオトラックコーデック文字列。例: `"Codec": "h264 \| hev1"`
TimeBase 必須	時間ベース。例: `"TimeBase": "1/30000"`
NumberOfFrames	フレームの数。例: `"NumberOfFrames": 2107`
StartTime	トラックの開始時刻。例: `"StartTime": "PT0.033S"`
Duration	トラックの時間。例: `"Duration": "PT1M10.304S"`

AudioTracks

名前	説明
SampleFormat	サンプル形式。例: `"SampleFormat": "fltp"`
ChannelLayout	チャネルレイアウト。例: `"ChannelLayout": "stereo"`
Channels 必須	オーディオチャネルの数 (0 以上)。例: `"Channels": 2`
SamplingRate 必須	オーディオサンプリングレート (サンプル数/秒または Hz)。例: `"SamplingRate": 48000`
Bitrate	資産ファイルから計算された、平均オーディオビットレート (ビット/秒)。基本ストリームペイロードのみがカウントされます。この値には、パッケージのオーバーヘッドは含まれません。例: `"Bitrate": 192080`
Metadata	さまざまな情報を保持する際に使用できる汎用的なキー/値文字列。この記事の最後にある完全な例を参照してください。
Id 必須	このオーディオまたはビデオトラックの 0 から始まるインデックス。必ずしも MP4 ファイルで使用されている TrackID であるとは限りません。例: `"Id": 1`
Codec	ビデオトラックコーデック文字列。例: `"Codec": "aac"`
CodecLongName	オーディオまたはビデオトラックコーデックの長い名前。例: `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase 必須	時間ベース。例: `"TimeBase": "1/48000"`
NumberOfFrames	フレームの数。例: `"NumberOfFrames": 3294`
StartTime	トラックの開始時刻。例: `"StartTime": "PT0S"`
Duration	トラックの時間。例: `"Duration": "PT1M10.272S"`

Metadata

名前	説明
key 必須	キー/値ペアのキー。
value 必須	キー/値ペアの値。

スキーマの例

{
  "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
    }
  ]
}

ヘルプとサポート

質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。

Q & A
Stack Overflow。質問にタグを付けます azure-media-services。
@MSFTAzureMedia するか、@AzureSupport を使用してサポートを要求します。
Azure portalからサポートチケットを開きます。

次の方法で共有