Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Benachrichtigungen in Kinesis Video Streams einrichten

Wenn ein Medienfragment zur Nutzung verfügbar ist, benachrichtigt Kinesis Video Streams die Kunden mithilfe von Amazon Simple Notification Service (Amazon-SNS) Benachrichtigungen.

In den folgenden Themen wird erklärt, wie Sie mit Benachrichtigungen beginnen können.

Benachrichtigungskonfigurationen verwalten

Verwenden Sie UpdateNotificationConfiguration und, um Benachrichtigungskonfigurationen zu verwaltenDescribeNotificationConfiguration. Weitere Informationen hierzu finden Sie unten.

UpdateNotificationConfiguration

Verwenden Sie diesen API Vorgang, um die Benachrichtigungsinformationen für einen Stream zu aktualisieren. Weitere Informationen zu dieser UpdateNotificationConfiguration Funktion finden Sie UpdateNotificationConfiguration im Amazon Kinesis Video Streams Developer Guide.

DescribeNotificationConfiguration

Verwenden Sie diesAPI, um eine Benachrichtigungskonfiguration zu beschreiben, die an einen Stream angehängt ist. Weitere Informationen zu dieser DescribeNotificationConfiguration Funktion finden Sie DescribeNotificationConfigurationim Amazon Kinesis Video Streams Developer Guide.

Über MKV Hersteller-Tags

Sie können den Kinesis Video Streams Streams-Producer verwendenSDK, um bestimmte Fragmente von Interesse zu taggen, indem Sie einen API Vorgang in der anzeigen. SDK In diesem Codeabschnitt finden Sie ein Beispiel dafür, wie das funktioniert. Beim Aufrufen SDK fügt der eine Reihe vordefinierter MKV Tags zusammen mit den Fragmentdaten hinzu. API Kinesis Video Streams erkennt diese speziellen MKV Tags und leitet Benachrichtigungen für die markierten Fragmente ein.

Alle Fragment-Metadaten, die zusammen mit den MKV Benachrichtigungs-Tags bereitgestellt werden, werden als Teil der SNS Amazon-Themen-Payload veröffentlicht.

Syntax für MKV Producer-Tags

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

MKVTag-Grenzwerte

In der folgenden Tabelle sind die Einschränkungen aufgeführt, die mit den Metadaten-Tags verbunden sind. Wenn das Limit für Metadaten-Tags anpassbar ist, können Sie über Ihren Account Manager eine Erhöhung beantragen.

SNSAmazon-Nachrichten

Dieses Thema enthält weitere Informationen zu SNS Amazon-Nachrichten und Themen-Payloads.

Payload SNS zum Thema Amazon

Jede Benachrichtigung, die über den vorherigen Workflow initiiert wurde, liefert die SNS Amazon-Themen-Payload, wie im folgenden Beispiel gezeigt. Dieses Beispiel ist eine SNS Amazon-Nachricht, die nach dem Verzehr von Benachrichtigungsdaten aus einer Amazon Simple Queue Service (Amazon-SQS) Warteschlange auftritt.

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

Sehen Sie sich Ihre SNS Amazon-Nachrichten an

Sie können Nachrichten nicht direkt aus einem SNS Amazon-Thema lesen, da es API dafür keine Möglichkeit gibt. Um die Nachrichten anzusehen, abonnieren Sie eine SQS Warteschlange für das SNS Thema oder wählen Sie ein anderes von Amazon SNS unterstütztes Ziel. Die effizienteste Option zum Anzeigen von Nachrichten ist jedoch die Verwendung von AmazonSQS.