Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Kinesis 视频直播中的通知

当媒体片段可供使用时，Kinesis Video Streams 会使用Amazon Simple Notification Service（亚马逊 SNS）通知通知通知客户。以下主题说明了如何开始使用通知。

UpdateNotificationConfiguration

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

DescribeNotificationConfiguration

使用此 API 描述附加到数据流的通知配置。有关该DescribeNotificationConfiguration功能的更多信息，请参阅DescribeNotificationConfiguration亚马逊 Kinesis Video Streams 开发者指南。

制片人 MKV 标签

您可以使用 Kinesis Video Streams Producer SDK 通过在 SDK 中公开 API 操作来标记感兴趣的特定片段。在本节代码中查看其工作原理的示例。调用此 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 Simple Queue Service (Amazon 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 可以这样做。要查看消息，请在 SQS 队列中订阅 SNS 主题，或选择任何其他 Amazon SNS 支持的目的地。但是，查看消息的最有效选择是使用 Amazon SQS。