本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Kinesis Video Streams 中设置通知

当媒体片段可供使用时，Kinesis Video Streams 会使用 Amazon Simple Notification Service （SNS亚马逊）通知通知客户。

以下主题说明了如何开始使用通知。

管理通知配置

要管理通知配置，请使用UpdateNotificationConfiguration和DescribeNotificationConfiguration。有关更多信息，请参阅下文。

UpdateNotificationConfiguration

使用此API操作更新直播的通知信息。有关该UpdateNotificationConfiguration功能的更多信息，请参阅UpdateNotificationConfiguration 《亚马逊 Kinesis Video Streams 开发者指南》。

DescribeNotificationConfiguration

用它API来描述附加到直播的通知配置。有关该DescribeNotificationConfiguration功能的更多信息，请参阅DescribeNotificationConfiguration《亚马逊 Kinesis Video Streams 开发者指南》。

关于制作人MKV标签

你可以使用 Kinesis Video Streams SDK 制作器通过在中公开API操作来标记感兴趣的特定片段。SDK请在此段代码中查看其工作原理示例。调用此API函数后，SDK将添加一组预定义的MKV标签以及片段数据。Kinesis Video Streams 将识别这些MKV特殊标签，并针对已标记的片段启动通知。

随通知MKV标签一起提供的任何片段元数据都将作为 Amazon SNS 主题有效负载的一部分发布。

制作者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
           

MKV标签限制

下表列出了与元数据标签相关的限制。如果元数据标签限制是可调整的，您可以通过您的客户经理申请增加限制。

亚马逊SNS消息

本主题包含有关 Amazon SNS 消息和主题有效载荷的更多信息。

Amazon SNS 主题有效负载

通过上一个工作流程启动的任何通知都将传送 Amazon SNS 主题有效负载，如以下示例所示。此示例是在使用来自 Amazon Simple Queue Service （亚马逊SQS）队列的通知数据之后出现的 Amazon SNS 消息。

{
"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
    }
}

查看您的亚马逊SNS消息

您无法直接从 Amazon SNS 主题中阅读消息，因为这样做是不API可能的。要查看消息，请为该SNS主题订阅SQS队列，或选择任何其他 Amazon SNS 支持的目的地。但是，查看消息的最有效方法是使用 Amazon SQS。