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.
# Streaming mit einem GStreamer Plugin
**Anmerkung**
Amazon Rekognition Streaming Video Analysis steht ab dem 30. April 2026 nicht mehr für Neukunden zur Verfügung. Wenn Sie Streaming Video Analysis nutzen möchten, melden Sie sich vor diesem Datum an. Bestandskunden mit Konten, die diese Funktion innerhalb der letzten 12 Monate genutzt haben, können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der [Verfügbarkeit von Rekognition Streaming Video Analysis](https://docs.aws.amazon.com/rekognition/latest/dg/rekognition-streaming-video-analysis-availability-change.html).
Amazon Rekognition Video kann ein Live-Streaming-Video von einer Gerätekamera analysieren. Um auf Medieneingänge von einer Gerätequelle zugreifen zu können, müssen Sie die Installation durchführen. GStreamer GStreamer ist eine Multimedia-Framework-Software eines Drittanbieters, die Medienquellen und Verarbeitungstools in Workflow-Pipelines miteinander verbindet. Sie müssen auch das [Amazon Kinesis Video Streams Producer Plug-In](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) für GStreamer installieren. Diese Operation setzt voraus, dass Sie Ihre Amazon-Rekognition-Video- und Amazon-Kinesis-Ressourcen erfolgreich eingerichtet haben. Weitere Informationen finden Sie unter [Einrichtung Ihrer Amazon-Rekognition-Video- und Amazon-Kinesis-Ressourcen](setting-up-your-amazon-rekognition-streaming-video-resources.md).
## Schritt 1: Installieren von GStreamer
Laden Sie GStreamer, eine Multimedia-Plattform-Software eines Drittanbieters, herunter und installieren Sie es. Sie können eine Paketverwaltungssoftware wie Homebrew ([GStreamer on Homebrew](https://formulae.brew.sh/formula/gstreamer)) verwenden oder sie direkt von der [Freedesktop-Website](https://gstreamer.freedesktop.org/download/) herunterladen.
Überprüfen Sie die erfolgreiche Installation von GStreamer, indem Sie von Ihrem Befehlszeilenterminal aus einen Video-Feed mit einer Testquelle starten.
```
$ gst-launch-1.0 videotestsrc ! autovideosink
```
## Schritt 2: Installieren Sie das Kinesis Video Streams Producer Plug-In
In diesem Abschnitt laden Sie die [Amazon Kinesis Video Streams Producer Bibliothek](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) herunter und installieren das Kinesis Video Streams GStreamer Plug-In.
Erstellen Sie ein Verzeichnis und klonen Sie den Quellcode aus dem GitHub-Repository. Stellen Sie sicher, dass Sie den `--recursive`-Parameter angeben.
```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```
Folgen Sie den [Anweisungen der Bibliothek](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md), um das Projekt zu konfigurieren und zu erstellen. Stellen Sie sicher, dass Sie die plattformspezifischen Befehle für Ihr Betriebssystem verwenden. Verwenden Sie den `-DBUILD_GSTREAMER_PLUGIN=ON`-Parameter, wenn Sie `cmake` ausführen, um das Kinesis Video Streams GStreamer Plug-In zu installieren. Für dieses Projekt sind die folgenden zusätzlichen Pakete erforderlich, die in der Installation enthalten sind: GCC oder Clang, Curl, Openssl und Log4CPlus. Wenn Ihr Build aufgrund eines fehlenden Pakets fehlschlägt, überprüfen Sie, ob das Paket installiert ist und sich in Ihrem PATH befindet. Wenn Sie beim Erstellen auf den Fehler „C-kompiliertes Programm kann nicht ausgeführt werden“ stoßen, führen Sie den Build-Befehl erneut aus. Manchmal wird der richtige C-Compiler nicht gefunden.
Überprüfen Sie die Installation des Kinesis Video Streams Plug-Ins, indem Sie den folgenden Befehl ausführen.
```
$ gst-inspect-1.0 kvssink
```
Die folgenden Informationen, wie z. B. die Fabrik- und Plug-In-Details, sollten erscheinen:
```
Factory Details:
Rank primary + 10 (266)
Long-name KVS Sink
Klass Sink/Video/Network
Description GStreamer AWS KVS plugin
Author AWS KVS
Plugin Details:
Name kvssink
Description GStreamer AWS KVS plugin
Filename /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
Version 1.0
License Proprietary
Source module kvssinkpackage
Binary package GStreamer
Origin URL http://gstreamer.net/
...
```
## Schritt 3: GStreamer mit dem Kinesis Video Streams Plug-In ausführen
Bevor Sie mit dem Streaming von einer Gerätekamera zu Kinesis Video Streams beginnen, müssen Sie möglicherweise die Medienquelle in einen akzeptablen Codec für Kinesis Video Streams konvertieren. Um die Spezifikationen und Formatfunktionen der Geräte zu ermitteln, die derzeit an Ihr Gerät angeschlossen sind, führen Sie den folgenden Befehl aus.
```
$ gst-device-monitor-1.0
```
Um mit dem Streaming zu beginnen, starten Sie GStreamer mit dem folgenden Beispielbefehl und fügen Sie Ihre Anmeldeinformationen und Amazon-Kinesis-Video-Streams-Informationen hinzu. Sie sollten die Zugriffsschlüssel und die Region für die IAM-Servicerolle verwenden, die Sie erstellt haben, während Sie [Amazon Rekognition Zugriff auf Ihre Kinesis-Streams gewähren](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream). Weitere Information über IAM-Zugriffsschlüssel finden Sie unter [Verwalten von Zugriffsschlüsseln für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *IAM-Benutzerhandbuch*. Außerdem können Sie die Parameter für das Videoformat so anpassen, wie es Ihre Nutzung erfordert und auf Ihrem Gerät verfügbar ist.
```
$ gst-launch-1.0 autovideosrc device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 !
x264enc bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au,profile=baseline !
kvssink stream-name="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```
Weitere Startbefehle finden Sie unter [Beispiel für GStreamer Startbefehle](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch).
**Anmerkung**
Wenn Ihr Startbefehl mit einem Fehler endet, bei dem es sich nicht um eine Verhandlung handelt, überprüfen Sie die Ausgabe des Gerätemonitors und stellen Sie sicher, dass es sich bei den `videoconvert`-Parameterwerten um gültige Funktionen Ihres Geräts handelt.
Nach einigen Sekunden wird in Ihrem Kinesis-Videostrom ein Video-Feed von Ihrer Gerätekamera angezeigt. Um mit der Erkennung und Zuordnung von Gesichtern mit Amazon Rekognition zu beginnen, starten Sie Ihren Amazon-Rekognition-Video-Stromprozessor. Weitere Informationen finden Sie unter [Überblick über den Betrieb des Amazon-Rekognition-Video-Stromprozessors](streaming-video.md#using-rekognition-video-stream-processor).