Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des notifications dans Kinesis Video Streams

Lorsqu'un fragment multimédia est disponible pour consommation, Kinesis Video Streams en informe les clients à Amazon Simple Notification Service l'aide de notifications (Amazon SNS).

Les rubriques suivantes expliquent comment démarrer avec les notifications.

Gérer les configurations de notifications

Pour gérer les configurations de notification, utilisez UpdateNotificationConfiguration etDescribeNotificationConfiguration. Voir ci-dessous pour plus d'informations.

UpdateNotificationConfiguration

Utilisez cette opération d'API pour mettre à jour les informations de notification d'un flux. Pour plus d'informations sur UpdateNotificationConfiguration cette fonctionnalité, consultez UpdateNotificationConfiguration le manuel Amazon Kinesis Video Streams Developer Guide.

DescribeNotificationConfiguration

Utilisez cette API pour décrire une configuration de notification attachée à un flux. Pour plus d'informations sur DescribeNotificationConfiguration cette fonctionnalité, consultez DescribeNotificationConfigurationle manuel Amazon Kinesis Video Streams Developer Guide.

À propos des tags MKV du producteur

Vous pouvez utiliser le SDK Kinesis Video Streams Producer pour baliser des fragments spécifiques présentant un intérêt en exposant une opération d'API dans le SDK. Vous trouverez un exemple de ce fonctionnement dans cette section de code. Lors de l'appel de cette API, le SDK ajoutera un ensemble de balises MKV prédéfinies ainsi que les données du fragment. Kinesis Video Streams reconnaîtra ces balises MKV spéciales et lancera des notifications pour les fragments balisés.

Toutes les métadonnées de fragment fournies avec les balises Notification MKV seront publiées dans le cadre de la charge utile de la rubrique Amazon SNS.

Syntaxe pour les tags MKV du producteur

|+ Tags
| + Tag
|  // MANDATORY: Predefined MKV tag to trigger the notification for the fragment
|  + Simple
|   + Name: AWS_KINESISVIDEO_NOTIFICATION
|   + String
| // OPTIONAL: Key value pairs that will be sent as part of the Notification payload
|  + Simple
|   + Name: CUSTOM_KEY_1 // Max 128 bytes
|   + String:CUSTOM_VALUE_1 // Max 256 bytes
|  + Simple
|   + Name: CUSTOM_KEY_2 // Max 128 bytes
|   + String: CUSTOM_VALUE_2 // Max 256 bytes
           

Limites de balises MKV

Le tableau suivant répertorie les limites associées aux balises de métadonnées. Si la limite de balises de métadonnées est ajustable, vous pouvez demander une augmentation auprès de votre responsable de compte.

Messages Amazon SNS

Cette rubrique contient plus d'informations sur les messages Amazon SNS et les charges utiles.

Charge utile de la rubrique Amazon SNS

Toute notification initiée par le biais du flux de travail précédent fournira la charge utile du sujet Amazon SNS, comme indiqué dans l'exemple suivant. Cet exemple est un message Amazon SNS qui apparaît après avoir consommé les données de notification d'une file d'attente Amazon Simple Queue Service (Amazon SQS).

{
"Type" : "Notification",
"MessageId" : Message ID,
"TopicArn" : SNS ARN,
"Subject" : "Kinesis Video Streams Notification",
"Message" : "{\"StreamArn\":\Stream Arn,\"FragmentNumber\":\Fragment Number,\"FragmentStartProducerTimestamp\":FragmentStartProducerTimestamp,
                \"FragmentStartServerTimestamp\":FragmentStartServerTimestamp,\"NotificationType\":\"PERSISTED\",\"NotificationPayload\":{\ CUSTOM_KEY_1:\CUSTOM_VALUE_1,
                \CUSTOM_KEY_2:\CUSTOM_VALUE_2}}",
"Timestamp" : "2022-04-25T18:36:29.194Z",
"SignatureVersion" : Signature Version,
"Signature" : Signature,
"SigningCertURL" : Signing Cert URL,
"UnsubscribeURL" : Unsubscribe URL
}            

Subject: "Kinesis Video Streams Notification"
Message: 
{
    "StreamArn":Stream Arn,
    "FragmentNumber":Fragment Number,
    "FragmentStartProducerTimestamp":Fragment Start Producer Timestamp,
    "FragmentStartServerTimestamp":Fragment Start Server Timestamp,
    "NotificationType":"PERSISTED",
    "NotificationPayload":{
        CUSTOM_KEY_1:CUSTOM_VALUE_1,
        CUSTOM_KEY_2:CUSTOM_VALUE_2
    }
}

Afficher vos messages Amazon SNS

Vous ne pouvez pas lire les messages directement depuis une rubrique Amazon SNS car il n'existe aucune API pour le faire. Pour consulter les messages, abonnez une file d'attente SQS à la rubrique SNS ou choisissez une autre destination prise en charge par Amazon SNS. Cependant, l'option la plus efficace pour afficher les messages est d'utiliser Amazon SQS.