Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Konektor tepi untuk Kinesis Video Streams Konektor tepi untuk `aws.iot.EdgeConnectorForKVS` komponen Kinesis Video Streams () membaca umpan video dari kamera lokal dan menerbitkan aliran ke Kinesis Video Streams. Anda dapat mengonfigurasi komponen ini untuk membaca umpan video dari kamera Internet Protocol (IP) menggunakan Real Time Streaming Protocol (RTSP). Kemudian, Anda dapat mengatur dasbor di [Grafana Terkelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) atau server Grafana lokal untuk memantau dan berinteraksi dengan aliran video. Anda dapat mengintegrasikan komponen ini AWS IoT TwinMaker untuk menampilkan dan mengontrol aliran video di dasbor Grafana. AWS IoT TwinMaker adalah AWS layanan yang memungkinkan Anda membangun kembar digital operasional sistem fisik. Anda dapat menggunakan AWS IoT TwinMaker untuk memvisualisasikan data dari sensor, kamera, dan aplikasi perusahaan bagi Anda untuk melacak pabrik fisik, bangunan, atau pabrik industri Anda. Anda juga dapat menggunakan data ini untuk memantau operasi, mendiagnosis kesalahan, dan memperbaiki kesalahan. Untuk informasi lebih lanjut, lihat [Apa itu AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) dalam *AWS IoT TwinMaker User Guide*. Komponen ini menyimpan konfigurasinya di AWS IoT SiteWise, yang merupakan AWS layanan yang memodelkan dan menyimpan data industri. Dalam AWS IoT SiteWise, *aset* mewakili objek seperti perangkat, peralatan, atau kelompok objek lain. Untuk mengonfigurasi dan menggunakan komponen ini, Anda membuat AWS IoT SiteWise aset untuk setiap perangkat inti Greengrass dan untuk setiap kamera IP yang terhubung ke setiap perangkat inti. Setiap aset memiliki properti yang Anda konfigurasikan untuk mengontrol fitur, seperti streaming langsung, unggahan sesuai permintaan, dan caching lokal. Untuk menentukan URL untuk setiap kamera, Anda membuat rahasia AWS Secrets Manager yang berisi URL kamera. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Kemudian, Anda menentukan rahasia itu di properti aset untuk kamera IP. Komponen ini mengunggah aliran video setiap kamera ke aliran video Kinesis. Anda menentukan nama aliran video Kinesis tujuan dalam konfigurasi AWS IoT SiteWise aset untuk setiap kamera. Jika aliran video Kinesis tidak ada, komponen ini membuatnya untuk Anda. AWS IoT TwinMaker menyediakan skrip yang dapat Anda jalankan untuk membuat AWS IoT SiteWise aset dan rahasia Secrets Manager ini. Untuk informasi selengkapnya tentang cara membuat sumber daya ini, serta cara menginstal, mengonfigurasi, dan menggunakan komponen ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. **catatan** Konektor tepi untuk komponen Kinesis Video Streams hanya tersedia dalam hal berikut: Wilayah AWS AS Timur (Virginia Utara) AS Barat (Oregon) Eropa (Frankfurt) Eropa (Irlandia) Asia Pasifik (Singapura) Asia Pasifik (Tokyo) Asia Pacific (Seoul) Asia Pasifik (Sydney) Asia Pasifik (Mumbai) Tiongkok (Beijing) **Topics** + [Versi](#kvs-edge-connector-component-versions) + [Jenis](#kvs-edge-connector-component-type) + [Sistem operasi](#kvs-edge-connector-component-os-support) + [Persyaratan](#kvs-edge-connector-component-requirements) + [Dependensi](#kvs-edge-connector-component-dependencies) + [Konfigurasi](#kvs-edge-connector-component-configuration) + [Lisensi](#kvs-edge-connector-component-licenses) + [Penggunaan](#kvs-edge-connector-component-usage) + [File log lokal](#kvs-edge-connector-component-log-file) + [Changelog](#kvs-edge-connector-component-changelog) + [Lihat juga](#kvs-edge-connector-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 1.0.x ## Jenis Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Anda dapat menerapkan komponen ini hanya ke perangkat inti tunggal, karena konfigurasi komponen harus unik untuk setiap perangkat inti. Anda tidak dapat menerapkan komponen ini ke grup perangkat inti. + [GStreamer](https://gstreamer.freedesktop.org)1.18.4 atau yang lebih baru diinstal pada perangkat inti. Untuk informasi selengkapnya, lihat [Menginstal GStreamer](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c). Pada perangkat dengan`apt`, Anda dapat menjalankan perintah berikut untuk menginstal GStreamer. ``` sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools ``` + AWS IoT SiteWise Aset untuk setiap perangkat inti. AWS IoT SiteWise Aset ini mewakili perangkat inti. Untuk informasi selengkapnya tentang cara membuat aset ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. + AWS IoT SiteWise Aset untuk setiap kamera IP yang Anda sambungkan ke setiap perangkat inti. AWS IoT SiteWise Aset ini mewakili kamera yang mengalirkan video ke setiap perangkat inti. Setiap aset kamera harus dikaitkan dengan aset untuk perangkat inti yang terhubung ke kamera. Aset kamera memiliki properti yang dapat Anda konfigurasikan untuk menentukan aliran video Kinesis, rahasia otentikasi, dan parameter streaming video. Untuk informasi selengkapnya tentang cara membuat dan mengonfigurasi aset kamera, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. + AWS Secrets Manager Rahasia untuk setiap kamera IP. Rahasia ini harus mendefinisikan pasangan kunci-nilai, di mana kuncinya`RTSPStreamUrl`, dan nilainya adalah URL untuk kamera. Jika kamera memerlukan otentikasi, sertakan nama pengguna dan kata sandi di URL ini. Anda dapat menggunakan skrip untuk membuat rahasia saat Anda membuat sumber daya yang dibutuhkan komponen ini. Untuk informasi selengkapnya, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. Anda juga dapat menggunakan konsol Secrets Manager dan API untuk membuat rahasia tambahan. Untuk informasi selengkapnya, lihat [Membuat rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan AWS Secrets Manager Pengguna*. + Peran [pertukaran token Greengrass](device-service-role.md) harus mengizinkan tindakan AWS Secrets Manager berikut,, dan AWS IoT SiteWise Kinesis Video Streams, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. **catatan** Kebijakan contoh ini memungkinkan perangkat untuk mendapatkan nilai rahasia bernama **IPCamera1Url** dan**IPCamera2Url**. Saat Anda mengonfigurasi setiap kamera IP, Anda menentukan rahasia yang berisi URL untuk kamera itu. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Peran pertukaran token perangkat inti harus memungkinkan akses ke rahasia untuk setiap kamera IP untuk terhubung. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url", "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] } ``` ------ **catatan** Jika Anda menggunakan AWS Key Management Service kunci yang dikelola pelanggan untuk mengenkripsi rahasia, peran perangkat juga harus mengizinkan `kms:Decrypt` tindakan. ### Titik akhir dan port Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat [Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `kinesisvideo.region.amazonaws.com` | 443 | Ya | Unggah data ke Kinesis Video Streams. | | `data.iotsitewise.region.amazonaws.com` | 443 | Ya | Publikasikan metadata streaming video ke. AWS IoT SiteWise | | `secretsmanager.region.amazonaws.com` | 443 | Ya | Unduh rahasia URL kamera ke perangkat inti. | ## Dependensi Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk [versi yang dirilis](#kvs-edge-connector-component-changelog) dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk versi 1.0.0 hingga 1.0.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=2.0.3 | Keras | | [Manajer aliran](stream-manager-component.md) | >=2.0.9 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `SiteWiseAssetIdForHub` ID AWS IoT SiteWise aset yang mewakili perangkat inti ini. Untuk informasi selengkapnya tentang cara membuat aset ini dan menggunakannya untuk berinteraksi dengan komponen ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [Penjadwal Pekerjaan Kuarsa/Lisensi](http://www.quartz-scheduler.org/) Apache 2.0 + [Binding Java untuk GStreamer 1.x/GNU](https://github.com/gstreamer-java/gst1-java-core) Lesser General Public License v3.0 ## Penggunaan Untuk mengonfigurasi dan berinteraksi dengan komponen ini, Anda dapat mengatur properti pada AWS IoT SiteWise aset yang mewakili perangkat inti dan kamera IP tempat ia terhubung. Anda juga dapat memvisualisasikan dan berinteraksi dengan aliran video di dasbor Grafana melalui. AWS IoT TwinMaker Untuk informasi selengkapnya, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. ## File log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.0.5 | Perbaikan bug umum dan perbaikan. | | 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/kvs-edge-connector-component.html) | | 1.0.3 | Perbaikan bug umum dan perbaikan. | | 1.0.1 | Perbaikan bug umum dan perbaikan. | | 1.0.0 | Versi awal. | ## Lihat juga + [Apa itu AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) di *Panduan AWS IoT TwinMaker Pengguna* + [AWS IoT TwinMaker integrasi video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) dalam *Panduan AWS IoT TwinMaker Pengguna* + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) di *Panduan AWS IoT SiteWise Pengguna* + [Memperbarui nilai atribut](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html) dalam *Panduan AWS IoT SiteWise Pengguna* + [Apa itu AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) dalam *AWS Secrets Manager Panduan Penggguna* + [Membuat dan mengelola rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html) di *Panduan AWS Secrets Manager Pengguna*