As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar notificações no Kinesis Video Streams

Quando um fragmento de mídia está disponível para consumo, o Kinesis Video Streams notifica os clientes Amazon Simple Notification Service usando notificações (Amazon). SNS

Os tópicos a seguir explicam como começar a usar as notificações.

Gerenciar configurações de notificação

Para gerenciar as configurações de notificação, use UpdateNotificationConfiguration e. DescribeNotificationConfiguration Veja a seguir mais informações.

UpdateNotificationConfiguration

Use essa API operação para atualizar as informações de notificação de um stream. Para obter mais informações sobre o UpdateNotificationConfiguration recurso, consulte o UpdateNotificationConfiguration Guia do desenvolvedor do Amazon Kinesis Video Streams.

DescribeNotificationConfiguration

Use isso API para descrever uma configuração de notificação anexada a um stream. Para obter mais informações sobre o DescribeNotificationConfiguration recurso, consulte o DescribeNotificationConfigurationGuia do desenvolvedor do Amazon Kinesis Video Streams.

Sobre MKV etiquetas de produtores

Você pode usar o produtor do Kinesis Video SDK Streams para marcar fragmentos específicos de interesse API expondo uma operação no. SDK Veja um exemplo de como isso funciona nesta seção de código. Ao chamar issoAPI, eles SDK adicionarão um conjunto de MKV tags predefinidas junto com os dados do fragmento. O Kinesis Video Streams reconhecerá MKV essas tags especiais e iniciará notificações para os fragmentos marcados.

Todos os metadados de fragmentos fornecidos junto com as MKV tags de notificação serão publicados como parte da carga útil de SNS tópicos da Amazon.

Sintaxe para etiquetas de produtores 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
           

MKVlimites de tags

A tabela a seguir lista as limitações associadas às tags de metadados. Se o limite da tag de metadados for ajustável, você poderá solicitar um aumento por meio do seu gerente de conta.

SNSMensagens da Amazon

Este tópico contém mais informações sobre SNS mensagens e cargas de tópicos da Amazon.

Carga útil de SNS tópicos da Amazon

Qualquer notificação iniciada por meio do fluxo de trabalho anterior fornecerá a carga útil do SNS tópico da Amazon, conforme mostrado no exemplo a seguir. Este exemplo é uma SNS mensagem da Amazon que ocorre após consumir dados de notificação de uma fila 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
    }
}

Veja suas SNS mensagens da Amazon

Você não pode ler mensagens diretamente de um SNS tópico da Amazon porque não API há como fazer isso. Para ver as mensagens, inscreva-se em uma SQS fila para o SNS tópico ou escolha qualquer outro destino SNS compatível com a Amazon. No entanto, a opção mais eficiente para visualizar mensagens é usar a AmazonSQS.