Configurazione delle notifiche in Kinesis Video Streams - Amazon Kinesis Video Streams

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 utilizzando notifiche ( Amazon Simple Notification Service Amazon SNS).

Nota

Amazon Kinesis Video Streams utilizza Amazon SNS Standard Topics per la comunicazione. Gli argomenti FIFO non sono attualmente supportati.

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

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

Nota

È necessario almeno un minuto per avviare la notifica dopo l'aggiornamento della configurazione della notifica. Attendi almeno un minuto prima di richiamare PutMedia dopo la chiamata di aggiornamento.

DescribeNotificationConfiguration

Usa questa 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 tag MKV del produttore

Puoi utilizzare l'SDK per produttori di Kinesis Video Streams per etichettare frammenti di interesse specifici esponendo un'operazione API nell'SDK. Guarda un esempio di come funziona in questa sezione di codice. Dopo aver chiamato questa API, l'SDK aggiungerà un set di tag MKV predefiniti insieme ai dati del frammento. Kinesis Video Streams riconoscerà questi tag MKV speciali e avvierà notifiche per i frammenti etichettati.

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

Sintassi per i tag MKV dei produttori

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

Limiti dei tag MKV

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

Limite Valore massimo Regolabile

Lunghezza della chiave dei metadati opzionale

128

No

Lunghezza del valore dei metadati opzionale

256

No

Numero massimo di metadati opzionali

10

Messaggi Amazon SNS

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

Payload tematico Amazon SNS

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

Visualizza i tuoi messaggi Amazon SNS

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

Per visualizzare i tuoi messaggi Amazon SNS utilizzando Amazon SQS
  1. Crea una coda Amazon SQS.

  2. Da AWS Management Console, apri l'argomento Amazon SNS impostato come destinazione in. NotificationConfiguration

  3. Scegli Crea abbonamento, quindi scegli la coda Amazon SQS creata nel primo passaggio.

  4. Esegui una PutMedia sessione con la configurazione di notifica abilitata e con i tag MKV di notifica aggiunti ai frammenti.

  5. Scegli la coda Amazon SQS nella console Amazon SQS, quindi seleziona Invia e ricevi messaggi per la coda Amazon SQS.

  6. Sondaggio per i messaggi. Questo comando dovrebbe mostrare tutte le notifiche generate dalla PutMedia sessione. Per informazioni sul polling, consulta Amazon SQS short and long polling.