Verwenden Sie die C++-Producer-Bibliothek

Sie können die von Amazon Kinesis Video Streams bereitgestellte C++-Producer-Bibliothek verwenden, um Anwendungscode zu schreiben, um Mediendaten von einem Gerät an einen Kinesis-Videostream zu senden.

Objektmodell

Die C++-Bibliothek stellt die folgenden Objekte zur Verfügung, um das Senden von Daten an einen Kinesis-Videostream zu verwalten:

• KinesisVideoProducer: Enthält Informationen zu Ihrer Medienquelle und Ihren AWS Anmeldeinformationen und verwaltet Rückrufe, um über Kinesis Video Streams Streams-Ereignisse zu berichten.

• KinesisVideoStream: Stellt den Kinesis-Videostream dar. Enthält Informationen zu den Parametern des Videostreams, wie Name, Datenaufbewahrungsdauer und Medieninhaltstyp.

Fügen Sie Medien in den Stream ein

Sie können die in der C++-Bibliothek bereitgestellten Methoden verwenden (z. B.PutFrame), um Daten in das KinesisVideoStream Objekt einzufügen. Die Bibliothek verwaltet dann den internen Status der Daten. Das umfasst beispielsweise folgende Aufgaben:

• Durchführen der Authentifizierung.

• Überwachen auf Netzwerklatenz. Wenn die Latenz zu hoch ist, verwirft die Bibliothek gegebenenfalls Frames.

• Überwachen des Status des laufenden Streamings.

Callback-Schnittstellen

Ein Layer stellt eine Reihe von Callback-Schnittstellen für die Kommunikation mit dem Anwendungslayer bereit. Verfügbare Callback-Schnittstellen:

• Schnittstelle für Service-Callbacks (CallbackProvider): Die Bibliothek ruft Ereignisse auf, die über diese Schnittstelle abgerufen wurden, wenn sie einen Stream erstellt, eine Stream-Beschreibung abruft und einen Stream löscht.

• Schnittstelle für Ereignisse im Client-Bereitschaftsstatus oder bei niedrigem Speicherbedarf (ClientCallbackProvider): Die Bibliothek ruft Ereignisse auf dieser Schnittstelle auf, wenn der Client bereit ist oder wenn er feststellt, dass ihm möglicherweise nicht mehr genügend Speicherplatz oder Arbeitsspeicher zur Verfügung steht.

• Callback-Schnittstelle für Stream-Ereignisse (StreamCallbackProvider): Die Bibliothek ruft Ereignisse auf dieser Schnittstelle auf, wenn Stream-Ereignisse auftreten, z. B. wenn der Stream in den Bereitschaftszustand wechselt, Frames gelöscht wurden oder Streamfehler auftreten.

Kinesis Video Streams bietet Standardimplementierungen für diese Schnittstellen. Sie können auch Ihre eigene benutzerdefinierte Implementierung bereitstellen, z. B. wenn Sie eine benutzerdefinierte Netzwerklogik benötigen oder wenn Sie der Benutzeroberfläche einen niedrigen Speicherzustand anzeigen möchten.

Weitere Informationen zu Callbacks in den Producer-Bibliotheken finden Sie unter. Callbacks von Produzenten SDK

Verfahren: Verwenden Sie den C++-Producer SDK

Dieses Verfahren zeigt, wie Sie den Kinesis Video Streams Streams-Client und Medienquellen in einer C++-Anwendung verwenden, um Daten an Ihren Kinesis-Videostream zu senden.

In dieser Vorgehensweise werden die folgenden Schritte beschrieben: