View a markdown version of this page

Streaming video ke aliran video Kinesis - 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

Untuk menjalankan aplikasi sampel, Anda memerlukan informasi berikut:

  1. Tetapkan kredenSIAL 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 kredensi ke kvssink.

    catatan

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

    Untuk menggunakan Region yang berbeda untuk streaming 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 input 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 grup gambar (GoP)) 1 detik. kvssink mengambil 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 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 pipeline GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Contoh saluran video GStreamer terlihat seperti ini:

    Gambar pola uji standar dengan cap tanggal dan waktu yang dilapisi.
    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 pipeline GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Alih-alih membiarkan GStreamer mendeteksi secara otomatis, Anda dapat menggunakannya v4l2src dengan pengenal perangkat tertentu. Jalankan perintah berikut:

    gst-device-monitor-1.0

    Pada 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 pipeline 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 pipeline 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 pipeline GStreamer, pilih jendela terminal dan tekan CTRL+C.

    Sample RTSP camera

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

    Untuk mengatur Gst-Rtsp-Server pada Raspberry Pi Anda

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

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

    2. Unduh versi 1.22 dari GStreamer 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 eksekusi yang disebut test-launch menggunakan gcc.

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

    5. Jalankan yang dapat dieksekusi 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 eksekusi test-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 Stream Video Kinesis Anda menggunakan kvssink

    Pipeline GStreamer ini digunakan rtspsrc untuk terhubung ke server RTSP untuk mengambil aliran video RTP. Ini meneruskan bingkai kertph264depay, yang mengekstrak bingkai H.264-encoded video dari paket RTP. h264parsemengelompokkan bingkai video ke dalam format yang kvssink dapat dimengerti. 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 pipeline 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 memecahkannya.

Tidak ada elemen seperti “xxxxxxxxx”

Jika Anda menerima kesalahan seperti berikut, 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 pipa yang digunakan sedang menggunakanv4l2src, tetapi seharusnya digunakan sebagai gant libcamerasrc inya.

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 secara otomatis elemen mana yang akan digunakan.

gst-launch-1.0 autovideosrc ! videoconvert ! autovideosink

Resolusi:

Pastikan libcamerasrc itu diinstal dan gunakan 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 alih- libcamerasrc alih. v4l2src

Kesalahan bus

Jika Anda menerima kesalahan Bus segera setelah memulai kvssink (biasanya, sekitar waktu panggilan HTTP selesai), itu berarti Raspberry Pi Anda tidak mendukung akses memori yang tidak selaras. PutMedia 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 mengatur flag CM ALIGNED_MEMORY_MODEL ake ke ON saat mengkompilasikvssink, karena defaultnya adalah. OFF Lihat Unduh dan buat SDK produser Kinesis Video Streams C++ untuk instruksi lebih rinci.

Stempel waktu membeku dan pipa terhenti

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

Hal ini terjadi karena pengaturan x264enc default dapat memperkenalkan latensi pengkodean tinggi, yang melebihi kapasitas buffer input default. Akibatnya, buffer input terisi, menyebabkan elemen hulu tersumbat dan pipa terhenti.

Untuk informasi selengkapnya, lihat dokumentasi GStreamer.

Resolusi:

Konfigur x264enc asikan dengan opsi zerolatency penyetelan. Ini secara signifikan mengurangi latensi pengkodean dengan mengoptimalkan skenario real-time, memastikan frame diproses dan output 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 web cam 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 secara bersamaan, 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 menghubungkan 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 “Tautan pad gagal” di log menunjukkan bahwa GStreamer mengalami masalah saat mencoba membuat koneksi (tautan) antara bantalan dua elemen dalam 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, lepaskan 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 adalah meminta framerate atau resolution yang tidak didukung kamera. Gunakan gst-device-monitor-1.0 di terminal untuk mendapatkan yang didukungframerates,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 gst-inspect-1.0 element-name terminal.