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.
Anmerkung
Amazon Kinesis Video Streams verwendet Amazon SNS Standard Topics für die Kommunikation. FIFO-Themen werden derzeit nicht unterstützt.
In den folgenden Themen wird erklärt, wie Sie mit Benachrichtigungen beginnen können.
Themen
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.
Anmerkung
Nach der Aktualisierung der Benachrichtigungskonfiguration dauert es mindestens eine Minute, bis die Benachrichtigung initiiert wird. Warten Sie mindestens eine Minute, bevor Sie PutMedia
nach dem Aktualisierungsaufruf aufrufen.
DescribeNotificationConfiguration
Verwenden Sie diese API, 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-Tags des Herstellers
Sie können das Kinesis Video Streams Producer SDK verwenden, um bestimmte Fragmente von Interesse zu taggen, indem Sie eine API-Operation im SDK verfügbar machen. In diesem Codeabschnitt finden Sie ein Beispiel dafür, wie das
Alle Fragment-Metadaten, die zusammen mit den Notification MKV-Tags bereitgestellt werden, werden als Teil der Amazon SNS SNS-Themen-Payload veröffentlicht.
Syntax für MKV-Tags von Produzenten
|+ 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
Beschränkungen für MKV-Tags
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.
Limit | Maximaler Wert | Einstellbar |
---|---|---|
Optionale Länge des Metadatenschlüssels |
128 |
Nein |
Optionale Länge des Metadatenwerts |
256 |
Nein |
Maximale Anzahl optionaler Metadaten |
10 |
Ja |
Amazon SNS SNS-Nachrichten
Dieses Thema enthält weitere Informationen zu Amazon SNS SNS-Nachrichten und Themen-Payloads.
Nutzlast für Amazon SNS-Themen
Jede Benachrichtigung, die durch den vorherigen Workflow initiiert wurde, liefert die Amazon SNS SNS-Themennutzlast, wie im folgenden Beispiel gezeigt. Dieses Beispiel ist eine Amazon SNS SNS-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
} }
Ihre Amazon SNS SNS-Nachrichten anzeigen
Sie können Nachrichten nicht direkt aus einem Amazon SNS SNS-Thema lesen, da es dafür keine API 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 Amazon SQS.
So zeigen Sie Ihre Amazon SNS SNS-Nachrichten mit Amazon SQS an
-
Erstellen Sie eine Amazon SQS SQS-Warteschlange.
-
Öffnen Sie von der AWS Management Console aus das Amazon SNS SNS-Thema, das als Ziel festgelegt wurde, unter
NotificationConfiguration
. -
Wählen Sie Create Subscription und dann die Amazon SQS SQS-Warteschlange aus, die im ersten Schritt erstellt wurde.
-
Führen Sie eine
PutMedia
Sitzung mit aktivierter Benachrichtigungskonfiguration aus und fügen Sie den Fragmenten die MKV-Tags für Benachrichtigungen hinzu. -
Wählen Sie in der Amazon SQS SQS-Konsole die Amazon SQS SQS-Warteschlange aus und wählen Sie dann Nachrichten senden und empfangen für die Amazon SQS SQS-Warteschlange aus.
-
Fragen Sie nach Nachrichten ab. Dieser Befehl sollte alle von der
PutMedia
Sitzung generierten Benachrichtigungen anzeigen. Informationen zu Umfragen finden Sie unter Amazon SQS Short and Long Polling.