Contoh: Kinesis Video Streams produser SDK GStreamer Plugin - kvssink

Topik ini menjelaskan cara membuat SDK produser Amazon Kinesis Video Streams untuk digunakan sebagai plugin GStreamer.

GStreamer adalah kerangka media populer yang digunakan oleh beberapa kamera dan sumber video untuk membuat saluran media khusus dengan menggabungkan plugin modular. Plugin Kinesis Video Streams GStreamer merampingkan integrasi saluran media GStreamer Anda yang ada dengan Kinesis Video Streamer. Setelah mengintegrasikan GStreamer, Anda dapat melakukan streaming video dari webcam atau kamera Real Time Streaming Protocol (RTSP) ke Kinesis Video Streams untuk pemutaran, penyimpanan, dan analisis lebih lanjut secara real-time atau nanti.

Plugin GStreamer secara otomatis mengelola transfer streaming video Anda ke Kinesis Video Streams dengan merangkum fungsionalitas yang disediakan oleh SDK produsen Kinesis Video Streams dalam elemen sink GStreamer,. kvssink Kerangka kerja GStreamer menyediakan lingkungan terkelola standar untuk membangun aliran media dari perangkat seperti kamera atau sumber video lainnya untuk pemrosesan, rendering, atau penyimpanan lebih lanjut.

Pipeline GStreamer biasanya terdiri dari tautan antara sumber (kamera video) dan elemen wastafel (baik pemutar untuk merender video, atau penyimpanan untuk pengambilan offline). Dalam contoh ini, Anda menggunakan elemen Producer SDK sebagai wastafel, atau tujuan media, untuk sumber video Anda (webcam atau kamera IP). Elemen plugin yang merangkum SDK kemudian mengirimkan aliran video ke Kinesis Video Streams.

Topik ini menjelaskan cara membangun saluran media GStreamer yang mampu mengalirkan video dari sumber video, seperti kamera web atau aliran RTSP, biasanya terhubung melalui tahap pengkodean menengah (menggunakan pengkodean) ke H.264 Kinesis Video Streams. Ketika streaming video Anda tersedia sebagai aliran video Kinesis, Anda dapat menggunakannya Tonton output dari kamera menggunakan pustaka parser untuk pemrosesan lebih lanjut, pemutaran, penyimpanan, atau analisis aliran video Anda.

Unduh, buat, dan konfigurasikan elemen GStreamer

Contoh Plugin GStreamer disertakan dengan SDK produser Kinesis Video Streams C ++. Untuk informasi tentang prasyarat dan pengunduhan SDK, lihat. Unduh dan konfigurasikan kode pustaka produser C++

Anda dapat membangun sink SDK GStreamer produser sebagai pustaka dinamis di macOS, Ubuntu, Raspberry Pi, atau Windows. Plugin GStreamer terletak di direktori Andabuild. Untuk memuat plugin ini, itu harus ada di AndaGST_PLUGIN_PATH. Jalankan perintah berikut:

export GST_PLUGIN_PATH=`pwd`/build

Jalankan elemen GStreamer

Untuk menjalankan GStreamer dengan elemen SDK produser Kinesis Video Streams sebagai sink, gunakan perintah. gst-launch-1.0 Gunakan elemen upstream yang sesuai untuk plugin GStreamer untuk digunakan. Misalnya, v4l2src untuk perangkat v4l2 pada sistem Linux, atau rtspsrc untuk perangkat RTSP. Tentukan kvssink sebagai wastafel (tujuan akhir pipeline) untuk mengirim video ke Producer SDK.

Selain memberikan kredensyal dan menyediakan wilayah, kvssink elemen memiliki parameter yang diperlukan berikut:

Untuk informasi tentang parameter kvssink opsional, lihatReferensi parameter elemen GStreamer.

Untuk informasi terbaru tentang plugin dan parameter GStreamer, lihat Plugin GStreamer. Anda juga dapat menggunakan gst-inspect-1.0 diikuti dengan nama elemen atau plugin GStreamer untuk mencetak informasinya dan untuk memverifikasi bahwa itu tersedia di perangkat Anda:

gst-inspect-1.0 kvssink

Jika bangunan kvssink gagal atau GST_PLUGIN_PATH tidak disetel dengan benar, output Anda akan terlihat mirip dengan ini:

No such element or plugin 'kvssink'

Contoh perintah peluncuran GStreamer

Contoh berikut menunjukkan cara menggunakan plugin kvssink GStreamer untuk melakukan streaming video dari berbagai jenis perangkat.

Contoh 1: Streaming video dari kamera RTSP di Ubuntu

Perintah berikut membuat pipeline GStreamer di Ubuntu yang mengalir dari kamera RTSP jaringan, menggunakan plugin rtspsrc GStreamer:

gst-launch-1.0 -v rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! h264parse ! kvssink stream-name="YourStreamName" storage-size=128

Contoh 2: Encode dan streaming video dari kamera USB di Ubuntu

Perintah berikut membuat pipeline GStreamer di Ubuntu yang mengkodekan aliran dari kamera USB dalam H.264 format, dan mengalirkannya ke Kinesis Video Streams. Contoh ini menggunakan plugin v4l2src GStreamer.

gst-launch-1.0 v4l2src do-timestamp=TRUE 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="YourStreamName" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion"

Contoh 3: Streaming video yang telah disandikan sebelumnya dari kamera USB di Ubuntu

Perintah berikut membuat pipeline GStreamer di Ubuntu yang mengalirkan video yang telah dikodekan kamera dalam format ke H.264 Kinesis Video Streams. Contoh ini menggunakan plugin v4l2src GStreamer.

gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! h264parse ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name="plugin" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion"

Contoh 4: Streaming video dari kamera jaringan di macOS

Perintah berikut membuat pipeline GStreamer di macOS yang mengalirkan video ke Kinesis Video Streams dari kamera jaringan. Contoh ini menggunakan plugin rtspsrc GStreamer.

gst-launch-1.0 rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! h264parse ! video/x-h264, format=avc,alignment=au ! kvssink stream-name="YourStreamName" storage-size=512  access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion"

Contoh 5: Streaming video dari kamera jaringan di Windows

Perintah berikut membuat pipeline GStreamer di Windows yang mengalirkan video ke Kinesis Video Streams dari kamera jaringan. Contoh ini menggunakan plugin rtspsrc GStreamer.

gst-launch-1.0 rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! video/x-h264, format=avc,alignment=au ! kvssink stream-name="YourStreamName" storage-size=512  access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion"

Contoh 6: Streaming video dari kamera di Raspberry Pi

Perintah berikut membuat pipeline GStreamer di Raspberry Pi yang mengalirkan video ke Kinesis Video Streams. Contoh ini menggunakan plugin v4l2src GStreamer.

gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! omxh264enc control-rate=1 target-bitrate=5120000 periodicity-idr=45 inline-header=FALSE ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1,profile=baseline ! kvssink stream-name="YourStreamName" access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion"

Contoh 7: Streaming audio dan video di Raspberry Pi dan Ubuntu

Lihat cara menjalankan perintah gst-launch-1.0 untuk mulai streaming audio dan video di dan Ubuntu. Raspberry-PI

Contoh 8: Streaming audio dan video dari sumber perangkat di macOS

Lihat cara menjalankan perintah gst-launch-1.0 untuk memulai streaming audio dan video di macOS.

Contoh 9: Unggah file MKV yang berisi audio dan video

Lihat cara menjalankan perintah gst-launch-1.0 untuk mengunggah file MKV yang berisi audio dan video. Anda akan memerlukan file uji MKV dengan media yang dikodekan h.264 dan AAC.

Jalankan elemen GStreamer dalam wadah Docker

Docker adalah platform untuk mengembangkan, menyebarkan, dan menjalankan aplikasi menggunakan kontainer. Menggunakan Docker untuk membuat pipeline GStreamer menstandarisasi lingkungan operasi untuk Kinesis Video Streams, yang merampingkan pembuatan dan penggunaan aplikasi.

Untuk menginstal dan mengkonfigurasi Docker, lihat berikut ini:

Setelah menginstal Docker, Anda dapat mengunduh Kinesis Video Streams C ++ Producer SDK (dan plugin GStreamer) dari Amazon Elastic Container Registry menggunakan salah satu perintah yang disediakan di bawah ini. docker pull

Untuk menjalankan GStreamer dengan elemen SDK produser Kinesis Video Streams sebagai sink di container Docker, lakukan hal berikut:

Otentikasi klien Docker Anda

Autentikasi klien Docker Anda ke registrasi Amazon ECR di mana Anda berniat untuk menarik citra Anda. Anda harus mendapatkan token otentikasi untuk setiap registri yang digunakan. Token berlaku selama 12 jam. Untuk informasi selengkapnya, lihat Autentikasi Registri dalam Panduan Pengguna Amazon Elastic Container Registry.

sudo aws ecr get-login-password --region us-west-2 | docker login -u AWS --password-stdin https://546150905175.dkr.ecr.us-west-2.amazonaws.com

Unduh gambar Docker untuk Ubuntu, macOS, Windows, atau Raspberry Pi

Unduh gambar Docker ke lingkungan Docker Anda menggunakan salah satu perintah berikut, tergantung pada sistem operasi Anda:

Unduh gambar Docker untuk Ubuntu

sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux:latest

Unduh gambar Docker untuk macOS

docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux:latest

Unduh gambar Docker untuk Windows

docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-windows:latest

Unduh gambar Docker untuk Raspberry Pi

sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-raspberry-pi:latest

Untuk memverifikasi bahwa gambar berhasil ditambahkan, gunakan perintah berikut:

docker images

Jalankan image Docker

Gunakan salah satu perintah berikut untuk menjalankan image Docker, tergantung pada sistem operasi Anda:

Jalankan image Docker di Ubuntu

sudo docker run -it --network="host" --device=/dev/video0 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux /bin/bash

Jalankan image Docker di macOS

sudo docker run -it --network="host" 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux /bin/bash

Jalankan gambar Docker di Windows

docker run -it 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-windows AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY RTSP_URL STREAM_NAME

Jalankan gambar Docker di Raspberry Pi

sudo docker run -it --device=/dev/video0 --device=/dev/vchiq -v /opt/vc:/opt/vc 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-raspberry-pi /bin/bash

Docker meluncurkan wadah dan memberi Anda prompt perintah untuk menggunakan perintah di dalam wadah.

Dalam wadah, atur variabel lingkungan menggunakan perintah berikut:

export LD_LIBRARY_PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$LD_LIBRARY_PATH
export PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin:$PATH
export GST_PLUGIN_PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$GST_PLUGIN_PATH

Mulai streaming untuk kvssink menggunakan gst-launch-1.0 untuk menjalankan pipeline yang sesuai untuk perangkat dan sumber video Anda. Misalnya saluran pipa, lihatContoh perintah peluncuran GStreamer.