Contoh: Plugin produsen Kinesis Video SDK GStreamer Streams - kvssink

Topik ini menjelaskan cara membangun produsen Amazon Kinesis Video SDK Streams untuk digunakan GStreamer sebagai plugin.

Topik

• Unduh, bangun, dan konfigurasikan GStreamer elemen
• Jalankan GStreamer elemen
• Contoh perintah GStreamer peluncuran
• Jalankan GStreamer elemen dalam wadah Docker
• GStreamerreferensi parameter elemen

GStreameradalah kerangka media populer yang digunakan oleh beberapa kamera dan sumber video untuk membuat saluran media khusus dengan menggabungkan plugin modular. Plugin Kinesis GStreamer Video Streams merampingkan integrasi pipeline media yang ada dengan Kinesis Video Streams. GStreamer Setelah mengintegrasikanGStreamer, 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 lebih baru.

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

GStreamerPipeline 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 SDK elemen Produser 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 bagaimana membangun saluran GStreamer media yang mampu mengalirkan video dari sumber video, seperti kamera web atau RTSP streaming, biasanya terhubung melalui tahap pengkodean menengah (menggunakan pengkodean H.264) ke 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, bangun, dan konfigurasikan GStreamer elemen

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

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

export GST_PLUGIN_PATH=`pwd`/build

catatan

Di macOS, Anda hanya dapat melakukan streaming video dari kamera jaringan saat berjalan GStreamer di wadah Docker. Streaming video dari USB kamera di macOS dalam wadah Docker tidak didukung.

Jalankan GStreamer elemen

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

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

• stream-name— Nama tujuan Kinesis Video Streams.

Untuk informasi tentang parameter kvssink opsional, lihatGStreamerreferensi parameter elemen.

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

gst-inspect-1.0 kvssink

Jika bangunan kvssink gagal atau GST _ PLUGIN _ tidak PATH disetel dengan benar, output Anda akan terlihat mirip dengan ini:

No such element or plugin 'kvssink'

Contoh perintah GStreamer peluncuran

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

Contoh 1: Streaming video dari RTSP kamera di Ubuntu

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

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 USB kamera di Ubuntu

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

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 di Ubuntu USB

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

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 GStreamer pipeline di macOS yang mengalirkan video ke Kinesis Video Streams dari kamera jaringan. Contoh ini menggunakan plugin rtspsrcGStreamer.

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 GStreamer pipeline di Windows yang mengalirkan video ke Kinesis Video Streams dari kamera jaringan. Contoh ini menggunakan plugin rtspsrcGStreamer.

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 GStreamer pipeline pada Raspberry Pi yang mengalirkan video ke Kinesis Video Streams. Contoh ini menggunakan plugin v4l2srcGStreamer.

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 Raspberry-PI dan Ubuntu.

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 MKV file yang berisi audio dan video

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

Jalankan GStreamer elemen dalam wadah Docker

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

Untuk menginstal dan mengkonfigurasi Docker, lihat berikut ini:

• Petunjuk unduhan Docker

• Memulai dengan Docker

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

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

Otentikasi klien Docker Anda

Otentikasi klien Docker Anda ke ECR registri Amazon tempat Anda ingin menarik gambar 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.

contoh : Otentikasi dengan Amazon ECR

Untuk mengautentikasi dengan AmazonECR, salin dan tempel perintah berikut seperti yang ditunjukkan.

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

Jika berhasil, output akan mencetak Login Succeeded.

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 GStreamer peluncuran.