View a markdown version of this page

Streaming video ke aliran video Kinesis Anda - Amazon Kinesis Video Streams
Memanfaatkan perangkat kerasMasalah runtime

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Streaming video ke aliran video Kinesis Anda

Untuk menjalankan aplikasi sampel, Anda memerlukan informasi berikut:

  1. Atur kredensil dan wilayah.

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

    Untuk metode otentikasi lainnya, lihatBerikan kredensyal ke kvssink.

    catatan

    SDK produsen C ++ menggunakan Wilayah AS Barat (Oregon) (us-west-2) secara default. Untuk menggunakan default, Wilayah AWS buat aliran video Kinesis Anda di Wilayah AS Barat (Oregon).

    Untuk menggunakan Wilayah yang berbeda untuk aliran video Kinesis Anda, setel variabel lingkungan berikut ke Wilayah Anda (misalnya,us-east-1):

    export AWS_DEFAULT_REGION=us-east-1

  2. Tergantung pada media masukan Anda, pilih salah satu dari yang berikut ini:

    Sample GStreamer video

    Pipeline GStreamer ini menghasilkan streaming video uji langsung dengan pola pengujian standar yang berjalan pada 10 frame per detik dengan resolusi 640x480 piksel. Hamparan ditambahkan menampilkan waktu dan tanggal sistem saat ini. Video kemudian dikodekan ke dalam H.264 format dan keyframe dihasilkan paling banyak setiap 10 frame, menghasilkan durasi fragmen (juga dikenal sebagai ukuran sekelompok gambar (GoP)) 1 detik. kvssink mengambil aliran video, mengemasnya ke dalam format wadah Matroska (MKV), dan mengunggahnya ke aliran H.264-encoded video Kinesis Anda.

    Jalankan perintah berikut:

    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"

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Contoh pipa video GStreamer terlihat seperti ini:

    Gambar pola uji standar dengan cap tanggal dan waktu yang dilapis.
    USB web cam

    Jalankan perintah berikut agar GStreamer mendeteksi kamera USB Anda secara otomatis:

    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"

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Daripada membiarkan GStreamer mendeteksi otomatis, Anda dapat menggunakan v4l2src dengan pengenal perangkat tertentu. Jalankan perintah berikut:

    gst-device-monitor-1.0

    Dalam output, Anda akan melihat beberapa perangkat dan awal pipeline GStreamer untuk cara menggunakan perangkat:

    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 ! ...

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Raspberry Pi camera module 1

    Jika Anda menggunakan modul kamera Pi 1 atau modul kamera Pi 2 denganbcm2835-v4l2, gunakan yang berikut ini:

    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"

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Raspberry Pi camera module 2 or 3

    Jika Anda menggunakan libcamera tumpukan modern, gunakan pipeline GStreamer berikut:

    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"

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Sample RTSP camera

    Untuk contoh ini, kami gunakan Gst-Rtsp-Server untuk meng-host umpan kamera demo RTSP secara lokal. Kami kemudian membuat pipeline GStreamer untuk mengunggah umpan kamera RTSP itu ke aliran video Kinesis yang ditentukan.

    Untuk mengatur Gst-Rtsp-Server Raspberry Pi Anda

    1. Instal perpustakaan ketergantungan yang diperlukan untuk membangun proyek. Gst-Rtsp-Server Pastikan Anda memiliki prasyarat perangkat lunak yang diinstal juga. Ketik berikut ini ke terminal Anda:

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

    2. Unduh GStreamer versi 1.22 di Raspberry Pi Anda.

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

    3. Ubah direktori ke direktori contoh di gst-rtsp-server.

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

    4. Kompilasi test-launch.c menjadi executable yang disebut test-launch menggunakan gcc.

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

    5. Jalankan executable dengan argumen berikut. Catatan: GStreamer mungkin membutuhkan waktu untuk memuat untuk pertama kalinya.

      ./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"

      Anda akan melihat output berikut:

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

    6. Verifikasi aliran video RTSP. Anda dapat menggunakan penampil RTSP apa pun. Misalnya, pemutar media VLC. Untuk menggunakan pemutar media VLC untuk melihat streaming langsung Anda, buka terminal baru dan ketik:

      sudo apt-get install vlc

      untuk menginstal pemutar media VLC. Lalu ketik:

      vlc rtsp://127.0.0.1:8554/test

      Jendela VLC akan muncul dengan streaming langsung. Jika tidak, periksa apakah executable tes-launch masih berjalan dan periksa output untuk kesalahan apa pun.

      Cara lain untuk memverifikasi aliran RTSP adalah dengan menggunakan utilitas gst-discoverer-1.0. Jenis:

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

      Output yang diharapkan terlihat seperti ini:

      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

    Untuk mengirim umpan RTSP ke Kinesis Video Stream Anda menggunakan kvssink

    Pipeline GStreamer ini digunakan rtspsrc untuk terhubung ke server RTSP untuk mengambil aliran video RTP. Ini melewati bingkai kertph264depay, yang mengekstrak bingkai H.264-encoded video dari paket RTP. h264parsemengelompokkan frame video ke dalam format kvssink dapat memahami. kvssinkmengambil aliran H.264-encoded video, mengemasnya ke dalam format wadah Matroska (MKV), dan mengunggahnya ke aliran video Kinesis Anda.

    Jalankan perintah berikut:

    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"

    Untuk menghentikan pipa GStreamer, pilih jendela terminal dan tekan CTRL+C.

Memanfaatkan perangkat keras

Beberapa model Raspberry Pi hadir dengan encoder yang dipercepat perangkat keras H.264 . Anda dapat menggunakannya sebagai penggantix264enc, yang merupakan encoder perangkat lunak.

  1. Pastikan plugin GStreamer diinstal:

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

  2. Jenis:

    gst-inspect-1.0 | grep h264

    Tentukan apakah elemen-elemen berikut tersedia:

    • omxh264enc

    • v4l2h264enc

    Jika tersedia, Anda dapat menggunakannya. Berikut adalah beberapa contoh pipeline menggunakan elemen-elemen tersebut:

    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"

    v4l2h264encdanv4l2convert:

    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"

Masalah runtime

Berikut ini adalah beberapa masalah runtime yang sering ditemui, dan cara memecahkan masalah mereka.

Tidak ada elemen seperti “xxxxxxxxx”

Jika Anda menerima kesalahan seperti berikut ini, itu berarti Anda kehilangan plugin GStreamer:

WARNING: erroneous pipeline: no element "videoconvert"

Resolusi:

Berdasarkan elemen mana yang hilang, tentukan tindakan yang sesuai:

Kesalahan “Aktivasi kumpulan buffer gagal”

Jika Anda menerima kesalahan seperti berikut ini berarti pipeline yang digunakan digunakanv4l2src, tetapi seharusnya digunakan libcamerasrc sebagai gantinya.

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)

Misalnya, jika Anda menggunakan pipeline berikut dengan modul kamera 2 tanpa libcamerasrc diinstal, Anda mungkin mengalami kesalahan ini ketika GStreamer mencoba mendeteksi elemen mana yang akan digunakan secara otomatis.

gst-launch-1.0 autovideosrc ! videoconvert ! autovideosink

Resolusi:

Pastikan libcamerasrc yang diinstal dan menggunakannya sebagai elemen sumber, bukanv4l2src. Ketik berikut ini untuk menginstal elemen libcamerasrc GStreamer:

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

Setelah libcamerasrc diinstal, jika Anda menggunakan autovideosrc elemen, GStreamer harus secara otomatis beralih untuk menggunakan sumber yang benar libcamerasrc alih-alih. v4l2src

Kesalahan bus

Jika Anda menerima kesalahan Bus segera setelah memulai kvssink (biasanya, sekitar waktu panggilan HTTP untuk PutMedia selesai), itu berarti Raspberry Pi Anda tidak mendukung akses memori yang tidak selaras. Log akan terlihat seperti berikut:

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 menggunakan akses memori yang tidak selaras untuk mengoptimalkan penggunaan memori, yang tidak didukung oleh semua perangkat.

Resolusi:

Untuk menggunakan SDK dalam mode akses memori yang selaras, Anda perlu secara eksplisit menyetel flag ALIGNED_MEMORY_MODEL CMake ON saat mengkompilasikvssink, karena default ke. OFF Lihat Unduh dan buat SDK produser Kinesis Video Streams C ++ untuk instruksi lebih rinci.

Stempel waktu membeku dan pipa berhenti

Saat menggunakan x264enc dalam pipeline GStreamer, Anda mungkin mengalami situasi di mana timeline pipeline melambat secara signifikan atau benar-benar berhenti dalam beberapa detik.

Ini terjadi karena pengaturan x264enc default dapat memperkenalkan latensi pengkodean tinggi, yang melebihi kapasitas buffer input default. Akibatnya, buffer input terisi, menyebabkan elemen hulu terblokir dan pipa macet.

Untuk informasi selengkapnya, lihat dokumentasi GStreamer.

Resolusi:

Konfigurasikan x264enc dengan opsi zerolatency penyetelan. Ini secara signifikan mengurangi latensi pengkodean dengan mengoptimalkan skenario waktu nyata, memastikan frame diproses dan dikeluarkan lebih cepat.

Contoh konfigurasi:

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

Meskipun solusi ini secara efektif mencegah penghentian pipa, ini dapat memengaruhi efisiensi dan kualitas pengkodean. Untuk skenario yang membutuhkan latensi rendah dan kualitas tinggi, pertimbangkan pendekatan alternatif, seperti menggunakan pengoptimalan perangkat keras atau menemukan kamera web yang menghasilkan H.264 secara langsung, melewatkan langkah pengkodean ini.

Untuk informasi selengkapnya, lihat Memanfaatkan perangkat keras.

Tidak dapat menjalankan beberapa pipeline dari perangkat v4l2 yang sama secara bersamaan

Perangkat seperti hanya /dev/video0 dapat diakses oleh satu proses pada satu waktu. Jika beberapa proses mencoba mengaksesnya pada saat yang sama, yang kedua menunggu sampai yang pertama selesai.

Resolusi:

Buat perangkat loopback, memungkinkan beberapa proses untuk menggunakan antarmuka loopback secara bersamaan. Untuk informasi selengkapnya, lihat Stack Exchange.

Kesalahan aliran data internal

Saat Anda membuat pipeline GStreamer, Anda menghubungkan elemen dengan menautkan pad sumber dari satu elemen ke bantalan wastafel elemen lain. Proses penautan ini memungkinkan aliran data dari elemen sumber ke elemen sink, membentuk pipa data.

Pesan kesalahan “Pad link failed” di log menunjukkan bahwa GStreamer mengalami masalah saat mencoba membuat koneksi (tautan) antara bantalan dua elemen di pipeline Anda.

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

Resolusi:

Tentukan elemen mana yang gagal terhubung satu sama lain. Untuk mempersempit ruang lingkup pipa, hapus elemen dari pipa. Ganti elemen paling kanan dengan fakesink dan hapus elemen satu per satu.

Anda mungkin perlu menyesuaikan elemen capsfilter, and/or mengubah elemen mana yang digunakan pipeline Anda.

Kasus umum meminta framerate atau resolution kamera tidak mendukung. Gunakan gst-device-monitor-1.0 di terminal untuk mendapatkan dukunganframerates,resolutions, danformats. Anda dapat menggunakan elemen GStreamer skala video untuk menyesuaikan resolusi video, dan videorate untuk menyesuaikan kecepatan bingkai video.

Untuk memeriksa format yang didukung untuk elemen GStreamer individual, ketik terminalgst-inspect-1.0 element-name.