

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

# Streaming menggunakan GStreamer plugin
<a name="streaming-using-gstreamer-plugin"></a>

Amazon Rekognition Video dapat menganalisis video streaming siaran langsung dari kamera perangkat. Untuk mengakses input media dari sumber perangkat, Anda perlu menginstal GStreamer. GStreamer adalah perangkat lunak kerangka kerja multimedia pihak ketiga yang menghubungkan sumber media dan alat pemrosesan bersama-sama dalam alur kerja pipa. Anda juga harus memasang [Plugin Produsen Amazon Kinesis Video Streams](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) untuk Gstreamer. Sebelum menjalankan proses ini, pastikan Anda telah berhasil mempersiapkan Amazon Rekognition Video dan sumber daya Amazon Kinesis. Untuk informasi selengkapnya, lihat [Mempersiapkan Amazon Rekognition Video Amazon dan sumber daya Amazon Kinesis](setting-up-your-amazon-rekognition-streaming-video-resources.md).

## Langkah 1: Memasang Gstreamer
<a name="step-1-install-gstreamer"></a>

 Unduh dan pasang Gstreamer, perangkat lunak platform multi-media pihak ke tiga. Anda dapat menggunakan perangkat lunak pengelolaan paket seperti Homebrew ([Gstreamer pada Homebrew](https://formulae.brew.sh/formula/gstreamer)) atau mendapatkannya langsung dari [Situs web Freedesktop](https://gstreamer.freedesktop.org/download/). 

 Verifikasi bahwa Gstreamer berhasil terpasang dengan meluncurkan umpan video dengan sumber uji dari terminal baris perintah Anda. 

```
$ gst-launch-1.0 videotestsrc ! autovideosink
```

## Langkah 2: Memasang plugin Produsen Kinesis Video Streams
<a name="step-2-install-kinesis-video-plugin"></a>

 Pada bagian ini, Anda akan mengunduh [ Pustaka Produsen Amazon Kinesis Video Streams](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) dan memasang plugin Gstreamer Kinesis Video Streams. 

 Buat direktori dan kloning kode sumber dari repositori Github. Pastikan untuk menyertakan parameter `--recursive`. 

```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```

Ikuti [instruksi yang diberikan oleh pustaka](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) untuk mengonfigurasi dan membangun proyek. Pastikan Anda menggunakan perintah khusus platform untuk sistem operasi Anda. Gunakan parameter `-DBUILD_GSTREAMER_PLUGIN=ON` ketika Anda menjalankan `cmake` untuk memasang plugin Gstreamer Kinesis Video Streams. Proyek ini memerlukan paket tambahan berikut yang disertakan dalam instalasi: GCC atau Clang, Curl, Openssl dan Log4cplus. Jika bangunan Anda gagal karena ketiadaan paket, verifikasi bahwa paket terpasang dan ada di PATH Anda. Jika Anda mengalami kesalahan “tidak dapat menjalankan program terhimpun C” saat membangun, jalankan perintah membangun lagi. Kadang-kadang, penghimpun C yang benar tidak ditemukan. 

 Verifikasi pemasangan plugin Kinesis Video Streams dengan menjalankan perintah berikut. 

```
$ gst-inspect-1.0 kvssink
```

 Informasi berikut, seperti detail pabrik dan plugin, akan muncul: 

```
Factory Details:
  Rank                     primary + 10 (266)
  Long-name                KVS Sink
  Klass                    Sink/Video/Network
  Description              GStreamer AWS KVS plugin
  Author                   AWS KVS <kinesis-video-support@amazon.com>
                
Plugin Details:
  Name                     kvssink
  Description              GStreamer AWS KVS plugin
  Filename                 /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
  Version                  1.0
  License                  Proprietary
  Source module            kvssinkpackage
  Binary package           GStreamer
  Origin URL               http://gstreamer.net/
  
  ...
```

## Langkah 3: Menjalankan Gstreamer dengan plugin Kinesis Video Streams
<a name="step-3-run-gstreamer-with-kinesis-video-plugin"></a>

 Sebelum memulai streaming dari kamera perangkat ke Kinesis Video Streams, Anda mungkin perlu mengonversi sumber media menjadi codec yang dapat diterima untuk Kinesis Video Streams. Untuk menentukan spesifikasi dan kemampuan format perangkat yang saat ini terhubung ke mesin Anda, jalankan perintah berikut.

```
$ gst-device-monitor-1.0
```

 Untuk memulai streaming, luncurkan Gstreamer dengan perintah contoh berikut dan tambahkan kredensial Anda dan informasi Amazon Kinesis Video Streams. Anda harus menggunakan access key dan wilayah untuk peran layanan IAM yang Anda buat saat [memberikan Amazon Rekognition akses ke aliran Kinesis Anda](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream). Untuk informasi selengkapnya tentang access key, lihat [Mengelola Access Key untuk Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dalam *Panduan Pengguna IAM*. Selain itu, Anda dapat menyesuaikan parameter argumen format video seperti yang disyaratkan oleh penggunaan Anda dan tersedia dari perangkat Anda. 

```
$ gst-launch-1.0 autovideosrc 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="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```

 Untuk perintah peluncuran lainnya, lihat [Contoh Perintah GStreamer Peluncuran](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch). 

**catatan**  
 Jika perintah peluncuran Anda berakhir dengan kesalahan non-negosiasi, periksa output dari Monitor Perangkat dan pastikan bahwa nilai parameter `videoconvert` sesuai dengan kemampuan perangkat Anda. 

 Anda akan melihat umpan video dari kamera perangkat pada aliran video Kinesis setelah beberapa detik. Untuk mulai mendeteksi dan mencocokkan wajah dengan Amazon Rekognition, mulai pemroses aliran Amazon Rekognition Video Anda. Untuk informasi selengkapnya, lihat [Ikhtisar operasi prosesor aliran Video Rekognition Amazon](streaming-video.md#using-rekognition-video-stream-processor). 