Métadonnées d’entrée

Article
06/30/2023

Avertissement

Azure Media Services sera mis hors service le 30 juin 2024. Pour plus d’informations, consultez le Guide de mise hors service AMS.

Un travail d’encodage est associé à un élément multimédia d’entrée (ou plusieurs) sur lequel vous souhaitez effectuer des tâches d’encodage. À l’achèvement d’une tâche, une ressource de sortie est générée. L’élément multimédia de sortie contient vidéo, audio, miniatures, manifeste et autres fichiers.

Il contient également un fichier avec des métadonnées relatives à l’élément multimédia d’entrée. Le nom du fichier JSON de métadonnées a un ID aléatoire, ne l’utilisez pas pour identifier la ressource d’entrée à laquelle appartient la ressource de sortie. Pour identifier la ressource d’entrée à laquelle elle appartient, utilisez le champ Uri (pour plus d’informations, consultez Autres éléments enfants).

Media Services n’analyse pas de manière préemptive les éléments multimédias d’entrée pour générer des métadonnées. Les métadonnées d’entrée sont générées uniquement sous forme d’artefact quand un élément multimédia d’entrée est traité au sein d’un travail. Par conséquent, cet artefact est écrit dans l’élément multimédia de sortie. Différents outils sont utilisés pour générer des métadonnées pour les éléments multimédias d’entrée et de sortie. Ainsi, les métadonnées d’entrée présentent un schéma légèrement différent de celui des métadonnées de sortie.

Cet article décrit les éléments et types du schéma JSON sur lesquels les métadonnées d’entrée (<asset_id>_metadata.json) sont basées. Pour plus d’informations sur le fichier qui contient des métadonnées sur la ressource de sortie, consultez Métadonnées de sortie.

Vous trouverez l’exemple de JSON à la fin de cet article.

Notes

Toutes les heures sont basées sur le format ISO-8601. Pour plus d’informations sur la mise en forme des durées, consultez Heures et Durées dans le même article.

AssetFile

Contient une collection d’éléments AssetFile pour le travail d’encodage.

Notes

Les quatre éléments enfants suivants doivent apparaître dans une séquence.

Nom	Description
VideoTracks	Chaque élément AssetFile physique peut contenir zéro, une ou plusieurs pistes vidéo entrelacées dans un format de conteneur approprié. Pour plus d’informations, consultez VideoTracks.
AudioTracks	Chaque élément AssetFile physique peut contenir zéro ou plusieurs pistes audio entrelacées dans un format de conteneur approprié. Pour plus d’informations, consultez AudioTracks
Métadonnées	Les métadonnées du fichier de ressource représentées sous la forme de chaînes clé/valeur. Par exemple : `<Metadata key="language" value="eng" />`

Autres éléments enfants

Nom	Description
Nom Obligatoire	Nom du fichier de ressource. Exemple : `"Name": "Ignite-short.mp4"`
Uri Obligatoire	URL où se trouve l’élément multimédia d’entrée. Pour identifier la ressource d’entrée à laquelle appartient la ressource de sortie, utilisez le champ `Uri` à la place de l’ID.
Taille Obligatoire	Taille du fichier de ressource en octets. Exemple : `"Size": 75739259`
Durée Obligatoire	Durée de lecture du contenu. Exemple : `"Duration": "PT1M10.304S"`.
NumberOfStreams Obligatoire	Nombre de flux dans le fichier de ressource. Exemple : `"NumberOfStreams": 2`
FormatNames Obligatoire	Noms de format. Exemple : `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName Obligatoire	Noms détaillés des formats. Exemple : `"FormatVerboseName": "QuickTime / MOV"`
StartTime	Heure de début du contenu. Exemple : `"StartTime": "PT0S"`
OverallBitRate	Vitesse de transmission moyenne du fichier de ressource en bits par seconde. Exemple : `"OverallBitRate": 8618539`

VideoTracks

Nom	Description
FourCC Obligatoire	Code FourCC du codec vidéo signalé par ffmpeg. Exemple : `"FourCC": "avc1" \| "hev1" \| "hvc1"`
Profil	Profil de la piste vidéo. Exemple : `"Profile": "Main"`
Niveau	Niveau de la piste vidéo. Exemple : `"Level": "3.2"`
PixelFormat	Format de pixel de la piste vidéo. Exemple : `"PixelFormat": "yuv420p"`
Width Obligatoire	Largeur vidéo encodée en pixels. Exemple : `"Width": "1280"`
Height Obligatoire	Hauteur vidéo encodée en pixels. Exemple : `"Height": "720"`
DisplayAspectRatioNumerator Obligatoire	Numérateur des proportions d’affichage vidéo. Exemple : `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator Obligatoire	Dénominateur des proportions d’affichage vidéo. Exemple : `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	Numérateur des proportions d’échantillon vidéo. Exemple : `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	Exemple : `"SampleAspectRatioDenominator": 1.0`
FrameRate Obligatoire	Fréquence d’images vidéo mesurée au format .3f. Exemple : `"FrameRate": 29.970`
Bitrate	Vitesse de transmission vidéo moyenne en bits par seconde, telle que calculée à partir du fichier de ressource. Seule la charge utile de flux élémentaire est comptée et la surcharge de packaging n’est pas incluse. Exemple : `"Bitrate": 8421583`
HasBFrames	Numéro de piste vidéo des trames B. Exemple : `"HasBFrames": 2`
Métadonnées	Des chaînes clé/valeur génériques qui peuvent être utilisées pour contenir différents types d’informations. Consultez l’exemple complet à la fin de l’article.
Id Obligatoire	Index de base zéro de cette piste audio ou vidéo. Cet ID ne correspond pas nécessairement au TrackID tel qu’utilisé dans un fichier MP4. Exemple : `"Id": 2`
Codec	Chaîne de codec de la piste vidéo. Exemple : `"Codec": "h264 \| hev1"`
CodecLongName	Nom long du codec de piste audio ou vidéo. Exemple : `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	Chaîne de codec de la piste vidéo. Exemple : `"Codec": "h264 \| hev1"`
TimeBase Obligatoire	Période. Exemple : `"TimeBase": "1/30000"`
NumberOfFrames	Nombre de trames (présent pour les pistes vidéo). Exemple : `"NumberOfFrames": 2107`
StartTime	Suivre l’heure de début. Exemple : `"StartTime": "PT0.033S"`
Durée	Durée de la piste. Exemple : `"Duration": "PT1M10.304S"`

AudioTracks

Nom	Description
SampleFormat	Exemple de format. Exemple : `"SampleFormat": "fltp"`
ChannelLayout	Disposition de canal. Exemple : `"ChannelLayout": "stereo"`
Canaux Obligatoire	Nombre (0 ou plus) de canaux audio. Exemple : `"Channels": 2`
SamplingRate Obligatoire	Taux d’échantillonnage audio en échantillons/sec ou Hz. Exemple : `"SamplingRate": 48000`
Bitrate	Débit binaire audio moyen en bits par seconde, tel que calculé à partir du fichier de ressource. Seule la charge utile de flux élémentaire est comptée et la surcharge de packaging n’est pas incluse dans ce nombre. Exemple : `"Bitrate": 192080`
Métadonnées	Des chaînes clé/valeur génériques qui peuvent être utilisées pour contenir différents types d’informations. Consultez l’exemple complet à la fin de l’article.
Id Obligatoire	Index de base zéro de cette piste audio ou vidéo. Il ne s’agit pas nécessairement du trackid tel qu’utilisé dans un fichier MP4. Exemple : `"Id": 1`
Codec	Chaîne de codec de la piste vidéo. Exemple : `"Codec": "aac"`
CodecLongName	Nom long du codec de piste audio ou vidéo. Exemple : `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase Obligatoire	Période. Exemple : `"TimeBase": "1/48000"`
NumberOfFrames	Nombre de trames (présent pour les pistes vidéo). Exemple : `"NumberOfFrames": 3294`
StartTime	Suivre l’heure de début. Exemple : `"StartTime": "PT0S"`
Durée	Durée de la piste. Exemple : `"Duration": "PT1M10.272S"`

Métadonnées

Nom	Description
key Obligatoire	La clé dans la paire clé/valeur.
value Obligatoire	La valeur dans la paire clé/valeur.

Exemple de schéma

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

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour vous poser des questions ou suivre nos mises à jour en suivant l’une des méthodes suivantes :

Q & R
Stack Overflow. Balisez les questions avec azure-media-services.
@MSFTAzureMedia ou utiliser @AzureSupport pour demander du support.
Ouvrez un ticket de support via le Portail Azure.

Partage via