Streamen Sie Video in Ihren Kinesis-Videostream - Amazon Kinesis Video Streams
Verwenden Sie HardwareProbleme mit der Laufzeit

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.

Streamen Sie Video in Ihren Kinesis-Videostream

Zur Ausführung der Beispielanwendung benötigen Sie die folgenden Informationen:

  1. Stellen Sie die Anmeldeinformationen und die Region ein.

    export AWS_ACCESS_KEY_ID=YourAccessKey
export AWS_SECRET_ACCESS_KEY=YourSecretKey
export AWS_DEFAULT_REGION=us-west-2

    Weitere Authentifizierungsmethoden finden Sie unterGeben Sie Anmeldeinformationen ein für kvssink.

    Anmerkung

    Das C++-Producer-SDK verwendet standardmäßig die Region USA West (Oregonus-west-2) (). Um die Standardeinstellung zu verwenden, AWS-Region erstellen Sie Ihren Kinesis-Videostream in der Region USA West (Oregon).

    Um eine andere Region für Ihren Kinesis-Videostream zu verwenden, legen Sie die folgende Umgebungsvariable auf Ihre Region fest (z. B.us-east-1):

    export AWS_DEFAULT_REGION=us-east-1

  2. Wählen Sie je nach Eingabemedium eine der folgenden Optionen aus:

    Sample GStreamer video

    Diese GStreamer Pipeline generiert einen Live-Testvideostream mit einem Standardtestmuster, das mit 10 Bildern pro Sekunde und einer Auflösung von 640 x 480 Pixeln läuft. Es wird ein Overlay hinzugefügt, das die aktuelle Systemzeit und das aktuelle Systemdatum anzeigt. Das Video wird dann in das H.264-Format codiert und Keyframes werden höchstens alle 10 Frames generiert, was zu einer Fragmentdauer (auch bekannt als Größe einer Bildergruppe (GoP)) von 1 Sekunde. kvssink nimmt den H.264-codierten Videostream, packt ihn in das Matroska (MKV) -Containerformat und lädt ihn in Ihren Kinesis-Videostream hoch.

    Führen Sie den folgenden Befehl aus:

    gst-launch-1.0 -v videotestsrc is-live=true \
  ! video/x-raw,framerate=10/1,width=640,height=480 \
  ! clockoverlay time-format="%a %B %d, %Y %I:%M:%S %p" \
  ! x264enc bframes=0 key-int-max=10 \
  ! h264parse \
  ! kvssink stream-name="YourStreamName"

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

    Die GStreamer Beispielvideopipeline sieht wie folgt aus:

    Bild des Standardtestmusters mit überlagertem Datums- und Zeitstempel.
    USB web cam

    Führen Sie den folgenden Befehl aus, damit Ihre USB-Kamera GStreamer automatisch erkannt wird:

    gst-launch-1.0 autovideosrc \
  ! videoconvert \
  ! video/x-raw,format=I420,width=640,height=480 \
  ! x264enc bframes=0 key-int-max=45 tune=zerolatency byte-stream=true speed-preset=ultrafast \
  ! h264parse \
  ! video/x-h264,stream-format=avc,alignment=au,profile=baseline \
  ! kvssink stream-name="YourStreamname"

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

    Anstatt die GStreamer automatische Erkennung zu verwenden, können Sie es v4l2src mit einer bestimmten Gerätekennung verwenden. Führen Sie den folgenden Befehl aus:

    gst-device-monitor-1.0

    In der Ausgabe sehen Sie einige Geräte und den Beginn einer GStreamer Pipeline zur Verwendung des Geräts:

    Device found:

    name  : H264 USB Camera: USB Camera
    class : Video/Source
    caps  : video/x-h264, stream-format=(string)byte-stream, alignment=(string)au, width=(int)1920, height=(int)1080, pixel-aspect-ratio=(fraction)1/1, colorimetry=(string){ 2:4:7:1 }, framerate=(fraction){ 30/1, 25/1, 15/1 };
            ...
    properties:
        device.path = /dev/video4
        udev-probed = false
        device.api = v4l2
        v4l2.device.driver = uvcvideo
        v4l2.device.card = "H264\ USB\ Camera:\ USB\ Camera"
        v4l2.device.bus_info = usb-3f980000.usb-1.3
        v4l2.device.version = 265767 (0x00040e27)
        v4l2.device.capabilities = 2216689665 (0x84200001)
        v4l2.device.device_caps = 69206017 (0x04200001)
    gst-launch-1.0 v4l2src device=/dev/video4 ! ...

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

    Raspberry Pi camera module 1

    Wenn Sie das Pi-Kameramodul 1 oder das Pi-Kameramodul 2 mit verwendenbcm2835-v4l2, verwenden Sie Folgendes:

    gst-launch-1.0 v4l2src device=/dev/video0 \
  ! videoconvert \
  ! video/x-raw,format=I420,width=640,height=480 \
  ! x264enc bframes=0 key-int-max=45 bitrate=500 tune=zerolatency \
  ! h264parse ! video/x-h264,stream-format=avc,alignment=au,profile=baseline \
  ! kvssink stream-name="YourStreamname"

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

    Raspberry Pi camera module 2 or 3

    Wenn Sie den modernen libcamera Stack verwenden, verwenden Sie die folgende GStreamer Pipeline:

    gst-launch-1.0 libcamerasrc \
  ! video/x-raw,width=640,height=480,framerate=30/1,format=I420 \
  ! videoconvert \
  ! x264enc speed-preset=ultrafast tune=zerolatency byte-stream=true key-int-max=75 \
  ! video/x-h264,level='(string)4' \
  ! h264parse \
  ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 \
  ! kvssink stream-name="YourStreamname"

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

    Sample RTSP camera

    In diesem Beispiel verwenden wir, Gst-Rtsp-Server um lokal einen Demo-RTSP-Kamera-Feed zu hosten. Anschließend erstellen wir eine GStreamer Pipeline, um diesen RTSP-Kamera-Feed in den angegebenen Kinesis-Videostream hochzuladen.

    Zur Einrichtung Gst-Rtsp-Server auf Ihrem Raspberry Pi

    1. Installieren Sie die erforderlichen Abhängigkeitsbibliotheken, um das Gst-Rtsp-Server Projekt zu erstellen. Stellen Sie sicher, dass Sie auch die erforderlichen Softwarekomponenten installiert haben. Geben Sie Folgendes in Ihr Terminal ein:

      sudo apt-get update
sudo apt-get install libgstrtspserver-1.0

    2. Laden Sie die Version 1.22 von GStreamer auf Ihren Raspberry Pi herunter.

      git clone https://gitlab.freedesktop.org/gstreamer/gstreamer.git --single-branch -b 1.22

    3. Ändern Sie die Verzeichnisse in das Beispielverzeichnis in der gst-rtsp-server.

      cd gstreamer
cd subprojects
cd gst-rtsp-server
cd examples

    4. Kompilieren Sie die Datei test-launch.c mithilfe von gcc in eine ausführbare Datei namens test-launch.

      gcc -o test-launch test-launch.c `pkg-config --cflags --libs gstreamer-rtsp-server-1.0`

    5. Führen Sie die ausführbare Datei mit den folgenden Argumenten aus. Hinweis: GStreamer Das erste Laden kann einige Zeit in Anspruch nehmen.

      ./test-launch "videotestsrc is-live=true ! video/x-raw,height=480,width=640,framerate=10/1 ! videoconvert ! x264enc tune=zerolatency bitrate=512 key-int-max=25 bframes=0 ! h264parse ! rtph264pay ! name=pay0 pt=96"

      Die Ausgabe sollte folgendermaßen aussehen:

      stream ready at rtsp://127.0.0.1:8554/test

    6. Überprüfen Sie den RTSP-Videostream. Sie können einen beliebigen RTSP-Viewer verwenden. Zum Beispiel VLC Media Player. Um Ihren Live-Stream mit dem VLC Media Player anzusehen, öffnen Sie ein neues Terminal und geben Sie Folgendes ein:

      sudo apt-get install vlc

      um den VLC Media Player zu installieren. Geben Sie dann Folgendes ein:

      vlc rtsp://127.0.0.1:8554/test

      Ein VLC-Fenster mit dem Live-Stream sollte erscheinen. Wenn nicht, überprüfen Sie, ob die ausführbare Teststartdatei noch läuft, und überprüfen Sie die Ausgabe auf Fehler.

      Eine andere Möglichkeit, den RTSP-Stream zu überprüfen, ist die Verwendung des Dienstprogramms gst-discoverer-1.0. Type:

      gst-discoverer-1.0 "rtsp://127.0.0.1:8554/test"

      Die erwartete Ausgabe sieht wie folgt aus:

      Analyzing rtsp://127.0.0.1:8554/test
Done discovering rtsp://127.0.0.1:8554/test

Properties:
  Duration: 99:99:99.999999999
  Seekable: no
  Live: yes
  unknown #0: application/x-rtp
    video #1: H.264 (Constrained Baseline Profile)
      Stream ID: 359314d7d4bba383223927d7e57d4244d0800e629c626be81c505055c62170e2/video:0:0:RTP:AVP:96
      Width: 640
      Height: 480
      Depth: 24
      Frame rate: 10/1
      Pixel aspect ratio: 1/1
      Interlaced: false
      Bitrate: 0
      Max bitrate: 0

    Um den RTSP-Feed mit kvssink an Ihren Kinesis Video Stream zu senden

    Diese GStreamer Pipeline wird verwendetrtspsrc, um eine Verbindung zum RTSP-Server herzustellen, um den RTP-Videostream abzurufen. Sie leitet die Frames an den weiterrtph264depay, der die H.264-codierten Videoframes aus den RTP-Paketen extrahiert. h264parsegruppiert die Videoframes in das Format, das ich verstehen kann. kvssink kvssinknimmt den H.264-codierten Videostream, packt ihn in das Matroska (MKV) -Containerformat und lädt ihn in Ihren Kinesis-Videostream hoch.

    Führen Sie den folgenden Befehl aus:

    gst-launch-1.0 -v rtspsrc location="rtsp://127.0.0.1:8554/test" short-header=true \
  ! rtph264depay \
  ! h264parse \
  ! video/x-h264,format=avc,alignment=au \
  ! kvssink stream-name="YourStreamName"

    Um die GStreamer Pipeline zu beenden, wählen Sie das Terminalfenster aus und drücken Sie STRG+C.

Verwenden Sie Hardware

Einige Raspberry Pi-Modelle sind mit hardwarebeschleunigten H.264-Encodern ausgestattet. Sie können sie anstelle vonx264enc, einem Software-Encoder, verwenden.

  1. Stellen Sie sicher, dass die GStreamer Plugins installiert sind:

    sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-bad

  2. Type:

    gst-inspect-1.0 | grep h264

    Stellen Sie fest, ob die folgenden Elemente verfügbar sind:

    • omxh264enc

    • v4l2h264enc

    Wenn sie verfügbar sind, können Sie sie verwenden. Hier sind einige Pipeline-Beispiele, die diese Elemente verwenden:

    omxh264enc:

    gst-launch-1.0 v4l2src device=/dev/video0 \
  ! videoconvert \
  ! video/x-raw,format=I420,width=640,height=480 \
  ! omxh264enc control-rate=2 target-bitrate=512000 periodicity-idr=45 inline-header=FALSE \
  ! h264parse ! video/x-h264,stream-format=avc,alignment=au,profile=baseline \
  ! kvssink stream-name="raspberry"

    v4l2h264encundv4l2convert:

    gst-launch-1.0 libcamerasrc \
  ! video/x-raw,width=640,height=480,framerate=30/1,format=I420 \
  ! v4l2convert \
  ! v4l2h264enc extra-controls="controls,repeat_sequence_header=1" \
  ! video/x-h264,level='(string)4' \
  ! h264parse \
  ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1 \
  ! kvssink stream-name="test-stream"

Probleme mit der Laufzeit

Im Folgenden finden Sie einige häufig auftretende Laufzeitprobleme und deren Behebung.

Kein solches Element „xxxxxxxxx“

Wenn du eine Fehlermeldung wie die folgende erhältst, bedeutet das, dass dir ein GStreamer Plugin fehlt:

WARNING: erroneous pipeline: no element "videoconvert"

Auflösung

Ermitteln Sie anhand des fehlenden Elements die entsprechende Aktion:

Fehler „Die Aktivierung des Pufferpools ist fehlgeschlagen“

Wenn Sie einen Fehler wie den folgenden erhalten, bedeutet dies, dass die verwendete Pipeline verwendet wirdv4l2src, aber sie sollte libcamerasrc stattdessen verwenden.

ERROR bufferpool gstbufferpool.c:572:gst_buffer_pool_set_active:source:pool0:src start failed
WARN v4l2src gstv4l2src.c:976:gst_v4l2src_decide_allocation: error: Failed to allocate required memory.
WARN v4l2src gstv4l2src.c:976:gst_v4l2src_decide_allocation: error: Buffer pool activation failed
WARN basesrc gstbasesrc.c:3352:gst_base_src_prepare_allocation: Subclass failed to decide allocation
Error received from element source: Failed to allocate required memory.
WARN basesrc gstbasesrc.c:3132:gst_base_src_loop: error: Internal data stream error.
Debugging information: ../sys/v4l2/gstv4l2src.c(976): gst_v4l2src_decide_allocation (): /GstPipeline:live-kinesis-pipeline/GstV4l2Src:source:
Buffer pool activation failed
WARN basesrc gstbasesrc.c:3132:gst_base_src_loop: error: streaming stopped, reason not-negotiated (-4)

Wenn Sie beispielsweise die folgende Pipeline verwenden, bei der das Kameramodul 2 nicht libcamerasrc installiert GStreamer ist, kann dieser Fehler auftreten, wenn Sie versuchen, automatisch zu erkennen, welche Elemente verwendet werden sollen.

gst-launch-1.0 autovideosrc ! videoconvert ! autovideosink

Auflösung

Stellen Sie sicher, dass das installiert libcamerasrc ist, und verwenden Sie es nicht als v4l2src Quellelement. Geben Sie Folgendes ein, um das libcamerasrc GStreamer Element zu installieren:

sudo apt-get update
sudo apt-get install gstreamer1.0-libcamera

Wenn Sie libcamerasrc das autovideosrc Element nach der Installation verwenden, GStreamer sollten Sie automatisch zur Verwendung der richtigen Quelle wechseln, libcamerasrc anstatt vonv4l2src.

Busfehler

Wenn Sie kurz nach dem Start einen Busfehler erhalten kvssink (normalerweise etwa zu dem Zeitpunkt, zu dem der HTTP-Aufruf PutMedia abgeschlossen ist), bedeutet dies, dass Ihr Raspberry Pi keinen unausgerichteten Speicherzugriff unterstützt. Die Protokolle werden wie folgt aussehen:

INFO Camera camera.cpp:1197 configuring streams: (0) 640x480-YUV420
INFO RPI pisp.cpp:1450 Sensor: /base/axi/pcie@120000/rp1/i2c@88000/imx708@1a - Selected sensor format: 1536x864-SBGGR10_1X10 - Selected CFE format: 1536x864-PC1B
[INFO ] kinesisVideoStreamFormatChanged(): Stream format changed.
[DEBUG] setRequestHeader(): Appending header to request: user-agent -> AWS-SDK-KVS-CPP-CLIENT/3.4.2/1.5.3 GCC/12.2.0 Linux/6.6.51+rpt-rpi-v8 aarch64 CPPSDK
[DEBUG] setRequestHeader(): Appending header to request: x-amzn-stream-name -> demo-stream
[DEBUG] setRequestHeader(): Appending header to request: x-amzn-producer-start-timestamp -> 1732012345.678
[DEBUG] setRequestHeader(): Appending header to request: x-amzn-fragment-acknowledgment-required -> 1
[DEBUG] setRequestHeader(): Appending header to request: x-amzn-fragment-timecode-type -> ABSOLUTE
[DEBUG] setRequestHeader(): Appending header to request: transfer-encoding -> chunked
[DEBUG] setRequestHeader(): Appending header to request: connection -> keep-alive
[INFO ] putStreamResultEvent(): Put stream result event. New upload handle 0
[WARN ] notifyDataAvailable(): [demo-stream] Failed to un-pause curl with error: 43. Curl object 0xe2f6f418
Bus error

Kinesis Video Streams PIC verwendet unausgerichteten Speicherzugriff, um die Speichernutzung zu optimieren, was nicht von allen Geräten unterstützt wird.

Auflösung

Um das SDK im Modus „Aligned Memory Access“ zu verwenden, müssen Sie das ALIGNED_MEMORY_MODEL CMake Flag ON beim Kompilieren explizit auf setzenkvssink, da es standardmäßig auf eingestellt ist. OFF Eine detailliertere Laden Sie das Kinesis Video Streams C++ Producer SDK herunter und erstellen Sie es Anleitung finden Sie unter.

Der Zeitstempel friert ein und die Pipeline gerät ins Stocken

Bei x264enc der Verwendung in einer GStreamer Pipeline können Situationen auftreten, in denen sich die Timeline der Pipeline erheblich verlangsamt oder innerhalb weniger Sekunden vollständig zum Stillstand kommt.

Dies liegt daran, dass die x264enc Standardeinstellungen zu einer hohen Kodierungslatenz führen können, die die Kapazität des Standardeingabepuffers übersteigt. Infolgedessen füllt sich der Eingabepuffer, wodurch Upstream-Elemente blockiert werden und die Pipeline zum Stillstand kommt.

Weitere Informationen finden Sie in der GStreamer -Dokumentation.

Auflösung

Konfigurieren Sie x264enc mit der zerolatency Tuning-Option. Dadurch wird die Latenz bei der Kodierung erheblich reduziert, da für Echtzeitszenarien optimiert wird und sichergestellt wird, dass Frames schneller verarbeitet und ausgegeben werden.

Beispielkonfiguration:

... ! x264enc tune=zerolatency byte-stream=true speed-preset=ultrafast bframes=0 key-int-max=60 ! ...
Anmerkung

Diese Lösung verhindert zwar effektiv ein Blockieren der Pipeline, kann sich jedoch auf die Effizienz und Qualität der Kodierung auswirken. Für Szenarien, die sowohl eine geringe Latenz als auch eine hohe Qualität erfordern, sollten Sie alternative Ansätze in Betracht ziehen, z. B. Hardwareoptimierungen oder die Suche nach einer Webcam, die H.264 direkt ausgibt, und diesen Kodierungsschritt überspringen.

Weitere Informationen finden Sie unter Verwenden Sie Hardware.

Es können nicht mehrere Pipelines gleichzeitig von demselben v4l2 Gerät aus ausgeführt werden

Auf Geräte wie /dev/video0 kann jeweils nur von einem Prozess zugegriffen werden. Wenn mehrere Prozesse gleichzeitig versuchen, darauf zuzugreifen, wartet der zweite, bis der erste abgeschlossen ist.

Auflösung

Erstellen Sie ein Loopback-Gerät, sodass mehrere Prozesse die Loopback-Schnittstelle gleichzeitig verwenden können. Weitere Informationen finden Sie unter Stack Exchange.

Interner Datenstream-Fehler

Wenn Sie eine GStreamer Pipeline erstellen, verbinden Sie Elemente, indem Sie das Quell-Pad eines Elements mit dem Sink-Pad eines anderen Elements verknüpfen. Dieser Verbindungsprozess ermöglicht den Datenfluss vom Quellelement zum Senkenelement und bildet so eine Datenpipeline.

Die Fehlermeldung „Pad Link failed“ im Protokoll weist darauf hin, dass beim Versuch, eine Verbindung (Link) zwischen den Pads zweier Elemente in Ihrer Pipeline herzustellen, ein Problem GStreamer aufgetreten ist.

Pad link failed
Error received from element udpsrc0: Internal data stream error.

Auflösung

Stellen Sie fest, welche Elemente nicht miteinander verknüpft werden können. Um den Umfang der Pipeline einzugrenzen, entfernen Sie Elemente aus der Pipeline. Ersetzen Sie das Element ganz rechts durch Elemente fakesink und entfernen Sie sie nacheinander.

Möglicherweise müssen Sie die Capsfilter-Elemente anpassen und and/or ändern, welche Elemente Ihre Pipeline verwendet.

Häufig wird nach einem framerate oder gefragtresolution, das die Kamera nicht unterstützt. Verwenden Sie gst-device-monitor-1.0 im Terminal, um die unterstützten frameratesresolutions, und zu erhaltenformats. Sie können das GStreamer Videoscale-Element verwenden, um die Videoauflösung anzupassen, und mit Videorate können Sie die Videobildrate anpassen.

Geben gst-inspect-1.0 element-name Sie in das Terminal ein, um die unterstützten Formate für ein einzelnes GStreamer Element zu überprüfen.