Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configurar las notificaciones en Kinesis Video Streams

Cuando un fragmento multimedia está disponible para su consumo, Kinesis Video Streams notifica a los clientes mediante notificaciones Amazon Simple Notification Service (SNSAmazon).

En los temas siguientes se explica cómo empezar a utilizar las notificaciones.

Administra las configuraciones de notificaciones

Para gestionar las configuraciones de notificaciones, utilice UpdateNotificationConfiguration yDescribeNotificationConfiguration. Para obtener más información, consulte las secciones siguientes.

UpdateNotificationConfiguration

Utilice esta API operación para actualizar la información de notificación de una transmisión. Para obtener más información sobre la UpdateNotificationConfiguration función, consulte UpdateNotificationConfiguration la Guía para desarrolladores de Amazon Kinesis Video Streams.

DescribeNotificationConfiguration

APIUtilícelo para describir una configuración de notificaciones adjunta a una transmisión. Para obtener más información sobre la DescribeNotificationConfiguration función, consulte DescribeNotificationConfigurationla Guía para desarrolladores de Amazon Kinesis Video Streams.

Acerca de las MKV etiquetas de productor

Puede utilizar el SDK productor de Kinesis Video Streams para etiquetar fragmentos específicos de interés exponiendo API una operación en elSDK. Consulte un ejemplo de cómo funciona esto en esta sección de código. Al llamar a estoAPI, SDK añadirán un conjunto de MKV etiquetas predefinidas junto con los datos del fragmento. Kinesis Video Streams reconocerá estas etiquetas MKV especiales e iniciará notificaciones para los fragmentos etiquetados.

Todos los metadatos de fragmentos proporcionados junto con las MKV etiquetas de notificación se publicarán como parte de la carga útil del SNS tema de Amazon.

Sintaxis de las etiquetas de productor 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
           

MKVlímites de etiquetas

En la siguiente tabla se enumeran las limitaciones asociadas a las etiquetas de metadatos. Si el límite de etiquetas de metadatos es ajustable, puedes solicitar un aumento a través de tu administrador de cuentas.

SNSMensajes de Amazon

Este tema contiene más información sobre los SNS mensajes de Amazon y las cargas útiles de los temas.

Carga útil de SNS temas de Amazon

Cualquier notificación iniciada a través del flujo de trabajo anterior entregará la carga útil del SNS tema de Amazon, como se muestra en el siguiente ejemplo. Este ejemplo es un SNS mensaje de Amazon que aparece después de consumir datos de notificación de una cola Amazon Simple Queue Service (de 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
    }
}

Ver tus SNS mensajes de Amazon

No puedes leer los mensajes directamente de un SNS tema de Amazon porque no API está permitido hacerlo. Para ver los mensajes, suscríbete a una SQS lista de espera para el SNS tema o elige cualquier otro destino SNS compatible con Amazon. Sin embargo, la opción más eficiente para ver los mensajes es usar AmazonSQS.