Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione delle notifiche in Kinesis Video Streams

Quando un frammento multimediale è disponibile per l'utilizzo, Kinesis Video Streams invia una notifica ai clienti Amazon Simple Notification Service utilizzando notifiche (Amazon). SNS

I seguenti argomenti spiegano come iniziare a utilizzare le notifiche.

Gestire le configurazioni delle notifiche

Per gestire le configurazioni delle notifiche, usa UpdateNotificationConfiguration e. DescribeNotificationConfiguration Guardare qui di seguito per ulteriori informazioni.

UpdateNotificationConfiguration

Utilizzate questa API operazione per aggiornare le informazioni di notifica per uno stream. Per ulteriori informazioni sulla UpdateNotificationConfiguration funzionalità, consulta UpdateNotificationConfiguration la Amazon Kinesis Video Streams Developer Guide.

DescribeNotificationConfiguration

Usalo API per descrivere una configurazione di notifica allegata a uno stream. Per ulteriori informazioni sulla DescribeNotificationConfiguration funzionalità, consulta DescribeNotificationConfigurationla Amazon Kinesis Video Streams Developer Guide.

Informazioni sui MKV tag del produttore

Puoi utilizzare il produttore di Kinesis Video SDK Streams per etichettare frammenti specifici di interesse API esponendo un'operazione in. SDK Guarda un esempio di come funziona in questa sezione di codice. Dopo averlo chiamatoAPI, SDK aggiungeranno una serie di MKV tag predefiniti insieme ai dati del frammento. Kinesis Video Streams riconoscerà MKV questi tag speciali e avvierà notifiche per i frammenti etichettati.

Tutti i metadati dei frammenti forniti insieme ai MKV tag di notifica verranno pubblicati come parte del payload dell'SNSargomento Amazon.

Sintassi per i tag producer MKV

|+ 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
           

MKVlimiti dei tag

La tabella seguente elenca le limitazioni associate ai tag dei metadati. Se il limite dei tag di metadati è regolabile, puoi richiederne un aumento tramite il tuo account manager.

SNSMessaggi Amazon

Questo argomento contiene ulteriori informazioni sui SNS messaggi Amazon e sui payload degli argomenti.

Payload SNS tematico Amazon

Qualsiasi notifica avviata tramite il flusso di lavoro precedente fornirà il payload dell'SNSargomento Amazon, come illustrato nell'esempio seguente. Questo esempio è un SNS messaggio Amazon che si verifica dopo aver consumato i dati di notifica da una coda 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
    }
}

Visualizza i tuoi SNS messaggi Amazon

Non puoi leggere i messaggi direttamente da un SNS argomento di Amazon perché non API è possibile farlo. Per visualizzare i messaggi, iscriviti a una SQS coda all'SNSargomento o scegli qualsiasi altra destinazione SNS supportata da Amazon. Tuttavia, l'opzione più efficiente per visualizzare i messaggi è usare AmazonSQS.