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 à l'aide de notifications Amazon Simple Notification Service (SNSAmazon).

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 API opération 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-le 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 MKV tags de producteur

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

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

Syntaxe pour les MKV tags 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
           

MKVlimites de balises

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.

SNSMessages Amazon

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

Charge utile du SNS sujet Amazon

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

{
"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 SNS messages Amazon

Vous ne pouvez pas lire les messages directement depuis un SNS sujet Amazon, car cela n'est pas API possible. Pour consulter les messages, inscrivez une SQS file d'attente au SNS sujet ou choisissez une autre destination SNS prise en charge par Amazon. Cependant, l'option la plus efficace pour consulter les messages est d'utiliser AmazonSQS.