Eingabemetadaten

Artikel
06/30/2023

Warnung

Azure Media Services wird am 30. Juni 2024 eingestellt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von AMS.

Ein Codierauftrag ist einem Eingabeasset (oder mehreren) zugeordnet, für das Sie einige Codieraufgaben durchführen möchten. Nach Abschluss einer Aufgabe wird ein Ausgabeobjekt erzeugt. Das Ausgabeobjekt enthält Videodaten, Audiodaten, Miniaturansichten, das Manifest und andere Dateien.

Das Ausgabeobjekt enthält auch eine Datei mit Metadaten zum Eingabeobjekt. Der Name der JSON-Datei mit Metadaten hat eine Zufalls-ID. Verwenden Sie diese nicht, um das Eingabeobjekt zu identifizieren, zu dem das Ausgabeobjekt gehört. Um das Eingabeobjekt zu bestimmen, zu dem es gehört, verwenden Sie das Feld Uri (weitere Informationen finden Sie unter Andere untergeordnete Elemente).

Media Services scannt Eingabeobjekte nicht im Vorhinein, um Metadaten zu generieren. Eingabemetadaten werden nur dann als Artefakt generiert, wenn ein Eingabeobjekt in einem Auftrag verarbeitet wird. Dieses Artefakt wird dann in das Ausgabeobjekt geschrieben. Zum Generieren von Metadaten für Eingabe- und Ausgabeobjekte werden verschiedene Tools eingesetzt. Deshalb weicht das Schema der Eingabemetadaten leicht von dem der Ausgabemetadaten ab.

In diesem Artikel werden die Elemente und Typen des JSON-Schemas beschrieben, auf denen die Eingabemetadaten (<asset_id>_metadata.json) basieren. Weitere Informationen zur Datei, in der die Metadaten zum Ausgabeobjekt enthalten sind, finden Sie unter Ausgabemetadaten.

Sie finden das Beispiel eines JSON-Schemas am Ende dieses Artikels.

Hinweis

Sämtliche Zeitangaben basieren auf dem ISO-8601-Format. Informationen zur Formatierung von Zeitangaben und Dauer finden Sie im gleichen Artikel unter Zeit und Dauer.

AssetFile

Enthält eine Sammlung der AssetFile-Elemente für den Codierungsauftrag.

Hinweis

Die folgenden vier untergeordneten Elemente müssen als Sequenz angezeigt werden.

Name	BESCHREIBUNG
VideoTracks	Jede physische Medienobjektdatei kann null oder mehr Videospuren enthalten, die zu einem entsprechenden Containerformat zusammengeführt werden. Weitere Informationen finden Sie unter VideoTracks.
AudioTracks	Jede physische Assetdatei kann null oder mehr Audiospuren enthalten, die zu einem entsprechenden Containerformat zusammengeführt werden. Weitere Informationen finden Sie unter AudioTracks.
Metadaten	Darstellung der Metadaten einer Assetdatei als Schlüssel-Wert-Zeichenfolge. Beispiel: `<Metadata key="language" value="eng" />`

Andere untergeordnete Elemente

Name	BESCHREIBUNG
Name Erforderlich	Name der Objektdatei Beispiel: `"Name": "Ignite-short.mp4"`
URI Erforderlich	Die URL, unter der sich das Eingabeobjekt befindet. Um das Eingabeobjekt zu bestimmen, zu dem das Ausgabeobjekt gehört, verwenden Sie das Feld `Uri` anstelle der ID.
Größe Erforderlich	Größe der Assetdatei in Byte Beispiel: `"Size": 75739259`
Duration Erforderlich	Dauer der Inhaltswiedergabe. Beispiel: `"Duration": "PT1M10.304S"`.
NumberOfStreams Erforderlich	Anzahl von Datenströmen in der Assetdatei Beispiel: `"NumberOfStreams": 2`
FormatNames Erforderlich	Formatierung von Namen Beispiel: `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName Erforderlich	Formatieren von ausführlichen Namen Beispiel: `"FormatVerboseName": "QuickTime / MOV"`
StartTime	Startzeit des Inhalts. Beispiel: `"StartTime": "PT0S"`
OverallBitRate	Durchschnittliche Bitrate der Objektdatei in Bits pro Sekunde. Beispiel: `"OverallBitRate": 8618539`

VideoTracks

Name	BESCHREIBUNG
FourCC Erforderlich	FourCC-Code des Videocodecs, der von ffmpeg gemeldet wird. Beispiel: `"FourCC": "avc1" \| "hev1" \| "hvc1"`
Profil	Profil der Videospur Beispiel: `"Profile": "Main"`
Level	Ebene der Videospur Beispiel: `"Level": "3.2"`
PixelFormat	Pixelformat der Videospur Beispiel: `"PixelFormat": "yuv420p"`
Width Erforderlich	Breite des codierten Videos in Pixel Beispiel: `"Width": "1280"`
Height Erforderlich	Höhe des codierten Videos in Pixel Beispiel: `"Height": "720"`
DisplayAspectRatioNumerator Erforderlich	Seitenverhältnis-Zähler der Videoanzeige Beispiel: `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator Erforderlich	Seitenverhältnis-Nenner der Videoanzeige Beispiel: `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	Seitenverhältnis-Zähler des Videosamples Beispiel: `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	Beispiel: `"SampleAspectRatioDenominator": 1.0`
FrameRate Erforderlich	Gemessene Videobildfrequenz im Format „.3f“ Beispiel: `"FrameRate": 29.970`
Bitrate	Durchschnittliche Videobitrate in Bits pro Sekunde gemäß Berechnung anhand der Objektdatei. Nur die elementare Datenstrom-Nutzlast wird gezählt. Der Aufwand für das Verpacken wird nicht einbezogen. Beispiel: `"Bitrate": 8421583`
HasBFrames	Videospuranzahl von B-Bildern Beispiel: `"HasBFrames": 2`
Metadaten	Generische Schlüssel-Wert-Zeichenfolgen, die für verschiedene Informationen verwendet werden können. Das vollständige Beispiel finden Sie am Ende des Artikels.
Id Erforderlich	Nullbasierter Index dieser Audio- oder Videospur. Diese ID ist nicht unbedingt die „TrackID“, die in einer MP4-Datei verwendet wird. Beispiel: `"Id": 2`
Codec	Codeczeichenfolge der Videospur Beispiel: `"Codec": "h264 \| hev1"`
CodecLongName	Langer Name des Audio- oder Videospurcodecs Beispiel: `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	Codeczeichenfolge der Videospur Beispiel: `"Codec": "h264 \| hev1"`
TimeBase Erforderlich	Gibt die Zeitbasis an. Beispiel: `"TimeBase": "1/30000"`
NumberOfFrames	Anzahl von Bildern (für Videospuren) Beispiel: `"NumberOfFrames": 2107`
StartTime	Gibt die Startzeit des Titels an. Beispiel: `"StartTime": "PT0.033S"`
Duration	Gibt die Dauer des Titels an. Beispiel: `"Duration": "PT1M10.304S"`

AudioTracks

Name	BESCHREIBUNG
SampleFormat	Beispielformat Beispiel: `"SampleFormat": "fltp"`
ChannelLayout	Kanallayout Beispiel: `"ChannelLayout": "stereo"`
Channels Erforderlich	Anzahl von Audiokanälen (0 oder mehr) Beispiel: `"Channels": 2`
SamplingRate Erforderlich	Audiosamplingrate in Stichproben/Sekunde oder Hz Beispiel: `"SamplingRate": 48000`
Bitrate	Die durchschnittliche Audiobitrate in Bit/s gemäß Berechnung anhand der Assetdatei. Nur die elementare Datenstrom-Nutzlast wird gezählt. Der Aufwand für das Verpacken wird in diesen Wert nicht einbezogen. Beispiel: `"Bitrate": 192080`
Metadaten	Generische Schlüssel-Wert-Zeichenfolgen, die für verschiedene Informationen verwendet werden können. Das vollständige Beispiel finden Sie am Ende des Artikels.
Id Erforderlich	Nullbasierter Index dieser Audio- oder Videospur. Dies bedeutet nicht unbedingt, dass die TrackID in einer MP4-Datei verwendet wird. Beispiel: `"Id": 1`
Codec	Codeczeichenfolge der Videospur Beispiel: `"Codec": "aac"`
CodecLongName	Langer Name des Audio- oder Videospurcodecs Beispiel: `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase Erforderlich	Gibt die Zeitbasis an. Beispiel: `"TimeBase": "1/48000"`
NumberOfFrames	Anzahl von Bildern (für Videospuren) Beispiel: `"NumberOfFrames": 3294`
StartTime	Gibt die Startzeit des Titels an. Beispiel: `"StartTime": "PT0S"`
Duration	Gibt die Dauer des Titels an. Beispiel: `"Duration": "PT1M10.272S"`

Metadaten

Name	BESCHREIBUNG
key Erforderlich	Schlüssel des Schlüssel-Wert-Paars
value Erforderlich	Wert des Schlüssel-Wert-Paars

Beispiel für das Schema

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

Anfordern von Hilfe und Support

Sie können Media Services mit Fragen kontaktieren oder unsere Updates mit einer der folgenden Methoden verfolgen:

Q & A
Stack Overflow. Markieren Sie Fragen mit azure-media-services.
@MSFTAzureMedia oder verwenden Sie @AzureSupport , um Support anzufordern.
Öffnen Sie ein Supportticket über die Azure-Portal.

Freigeben über