Surveillance des AWS métadonnées des MediaConnect sources élémentaires

MediaConnect la surveillance des métadonnées de la source affiche des informations sur le flux de transport et son support de programme. Vous pouvez consulter les messages d'état relatifs à la source du flux ainsi que les détails relatifs aux données vidéo, audio et autres du programme. La surveillance des métadonnées source peut être utilisée avec la MediaConnect consoleAPI, AWS CLI, ouSDK. Pour plus d'informations sur leAPI, voir : DescribeFlowSourceMetadatadans la MediaConnect APIréférence.

Note

Si vous utilisez plusieurs sources pour votre flux, les métadonnées de la source ne sont affichées que pour la source actuellement utilisée par le flux.

Détails des métadonnées de la source

Les sections suivantes fournissent des détails sur le type d'informations affichées par la surveillance des métadonnées source.

Alertes et messages

La section Alertes actives de l'onglet Console des métadonnées source et la section messages de la CLI réponse DescribeFlowSourceMetadataAPI/peuvent contenir des messages d'état contenant davantage d'informations sur le flux de transport. En cas MediaConnect de détection d'un problème ou d'impossibilité de récupérer les métadonnées du flux source, un message d'état associé sera affiché.

Programmes

La section des programmes contient des informations sur les programmes individuels contenus dans le flux de transport. Cette section contient les champs suivants :

Champ	Détails
Numéro du programme	Numéro de programme du programme.
Programme PID	Le programme Packet Identifier (PID).
PCR PID	La référence d'horloge du programme (PCR) PID du programme.
Nom du programme	Le nom du programme. Le nom du programme provient de la valeur du nom de service dans le tableau de description des services (SDT).
Streams	Les sections imbriquées contiennent des informations sur les types de flux vidéo, audio et de données.

Streams

La section des flux est imbriquée dans chaque programme de flux de transport individuel. Cette section contient les champs suivants :

Champ	Détails
Type de flux	Type de contenu contenu dans le flux. Cette valeur peut être vidéo, audio, de données ou inconnue.
Codec	Le codec du flux. Cette valeur varie en fonction du type de flux. Exemple : un type de flux vidéo peut afficher une valeur égale à H264 tandis qu'un type de flux audio s'afficheAAC.
PID	L'identifiant de paquet (PID) du flux.
Fréquence de trames	Fréquence d'images du flux vidéo, affichée en frames-per-second (fps).
Résolution du cadre	Résolution du flux vidéo. Dans la console, ce champ affiche la largeur du cadre suivie de la hauteur du cadre. Exemple : une largeur de cadre de 1920 et une hauteur de cadre de 1080 sont affichées dans la console sous la forme1920 x 1080. Dans la CLI réponseAPI/, la hauteur et la largeur du cadre sont affichées sous forme de valeurs distinctes.
Canaux	Le nombre de canaux du flux audio.
Fréquence d'échantillonnage	Fréquence d'échantillonnage du flux audio. Dans la CLI réponseAPI/, la fréquence d'échantillonnage est affichée en hertz (Hz). Dans la console, la fréquence d'échantillonnage est affichée en Hz, sauf si elle dépasse 1000 Hz, puis elle est affichée en kilohertz (kHz).
Taille de l'échantillon	Taille d'échantillon du flux audio. La taille de l'échantillon est affichée en bits.

Utilisation de la surveillance des métadonnées source (console)

Vous pouvez récupérer les dernières métadonnées de la source à MediaConnect l'aide de la console.

1. Ouvrez la MediaConnect console à l'adresse https://console.aws.amazon.com/mediaconnect/.

2. Dans l'écran Flux, sélectionnez le flux que vous souhaitez inspecter.

3. Sélectionnez l'onglet Métadonnées de la source.

4. L'onglet des métadonnées de la source contient une liste extensible de chaque alerte, programme et flux actifs pour la source du flux sélectionné.

Utilisation de la surveillance des métadonnées source (AWS CLI)

Vous pouvez récupérer les dernières métadonnées de la source à MediaConnect l'aide du AWS CLI. L'exemple suivant montre la AWS CLI commande et la valeur de retour pour un scénario typique.

1. Dans le AWS CLI, utilisez la describe-flow-source-metadata commande avec l'--flow-arnoption du flux que vous souhaitez inspecter.

   aws mediaconnect describe-flow-source-metadata --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow

2. La valeur renvoyée contiendra les informations multimédia relatives à la source du flux sélectionné. Voici un exemple générique du format de la valeur de retour. Dans cet exemple, il n'y a aucun message à afficher.

   {
       "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
       "Messages": [],
       "Timestamp": "2023-12-06T19:57:54Z",
       "TransportMediaInfo": {
           "Programs": [
               {
                   "PcrPid": 1000,
                   "ProgramNumber": 1,
                   "ProgramPid": 2000,
                   "ProgramName": "AwardsShow HD",
                   "Streams": [
                       {
                           "Codec": "H264",
                           "FrameRate": "59.94",
                           "FrameResolution": {
                               "FrameHeight": 1080,
                               "FrameWidth": 1920
                           },
                           "Pid": 256,
                           "StreamType": "Video"
                       },
                       {
                           "Channels": 1,
                           "Codec": "AAC",
                           "Pid": 257,
                           "SampleRate": 50,
                           "SampleSize": 16,
                           "StreamType": "Audio"
                       },
                       {
                           "StreamType": "Data",
                           "Codec": "SCTE35",
                           "Pid": 258
                       }
                   ]
               }
           ]
       }
   }

Exemple de API CLI métadonnées/réponse de la source

Voici un autre exemple de réponse du DescribeFlowSourceMetadataAPI/CLI. Dans cet exemple, il existe deux programmes. Chaque programme comporte un flux vidéo et deux flux audio. Le premier programme possède un flux de données SCTE -35. Le deuxième programme possède un type de flux non valide sur PID 139. Le type de flux non valide est indiqué par le code d'état dans la section des messages et le type de Unknown flux dans la section du programme.

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame",
    "TransportMediaInfo": {
        "Messages": [
            {
                "StatusCode": "InvalidType",
                "Message": "We could not determine the type of pid 139 on program 2"
            }
        ],
        "Programs": [
          {
                "ProgramNumber": 1,
                "ProgramPid": 16,
                "PcrPid": 56,
                "ProgramName": "Basketball HD",
                "Streams": [
                    {
                        "Codec": "H264",
                        "FrameRate": "59.94",
                        "FrameResolution": {
                            "FrameHeight": 1080,
                            "FrameWidth": 1920
                        },
                        "Pid": 126,
                        "StreamType": "Video"
                    },
                    {
                        "Channels": 1,
                        "Codec": "AAC",
                        "Pid": 127,
                        "SampleRate": 50,
                        "SampleSize": 16,
                        "StreamType": "Audio"
                    },
                    {
                        "Channels": 1,
                        "Codec": "AAC",
                        "Pid": 128,
                        "SampleRate": 50,
                        "SampleSize": 16,
                        "StreamType": "Audio"
                    },
                    {
                        "StreamType": "Data",
                        "Codec": "SCTE35",
                        "Pid": 129
                    }
                ]
          },
          {
                "ProgramNumber": 2,
                "ProgramPid": 26,
                "PcrPid": 66,
                "ProgramName": "Basketball SD",
                "Streams": [
                    {
                        "Codec": "H264",
                        "FrameRate": "29.97",
                        "FrameResolution": {
                            "FrameHeight": 480,
                            "FrameWidth": 640
                        },
                        "Pid": 136,
                        "StreamType": "Video"
                    },
                    {
                        "Channels": 1,
                        "Codec": "AAC",
                        "Pid": 137,
                        "SampleRate": 50,
                        "SampleSize": 16,
                        "StreamType": "Audio"
                    },
                    {
                        "Channels": 1,
                        "Codec": "AAC",
                        "Pid": 138,
                        "SampleRate": 50,
                        "SampleSize": 16,
                        "StreamType": "Audio"
                    },
                    {
                        "StreamType": "Unknown",
                        "Codec": "Unknown",
                        "Pid": 139
                    }
                ]
          }
       ]
    },
}