Métadonnées d’entrée

Logo de Media Services v3


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 :