Versi Jenis Sistem operasi Persyaratan Dependensi Konfigurasi Lisensi Penggunaan Berkas log lokal Changelog Lihat juga

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 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? 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 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)

Versi

Komponen ini memiliki versi berikut:

1.0.x

Jenis

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

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 1.18.4 atau yang lebih baru diinstal pada perangkat inti. Untuk informasi selengkapnya, lihat Menginstal GStreamer.

Pada perangkat denganapt, 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 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 di Panduan AWS IoT TwinMaker Pengguna.
AWS Secrets Manager Rahasia untuk setiap kamera IP. Rahasia ini harus mendefinisikan pasangan kunci-nilai, di mana kuncinyaRTSPStreamUrl, 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 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 di Panduan AWS Secrets Manager Pengguna.

Peran pertukaran token Greengrass 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 danIPCamera2Url. 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.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:secretsmanager:region:account-id:secret:IPCamera1Url",
        "arn:aws:secretsmanager:region:account-id: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.

Titik Akhir	Port	Wajib	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 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 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	>=2.0.3	Keras
Manajer aliran	>=2.0.9	Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

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 di Panduan AWS IoT TwinMaker Pengguna.

contoh Contoh: Pembaruan gabungan konfigurasi


{
  "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

Penjadwal Pekerjaan Kuarsa/Lisensi Apache 2.0
Binding Java untuk GStreamer 1.x/GNU 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 di Panduan AWS IoT TwinMaker Pengguna.

Berkas 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	Perbaikan bug dan peningkatan Memperbaiki masalah yang menyebabkan pengunggahan langsung berhenti.
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? di Panduan AWS IoT TwinMaker Pengguna
AWS IoT TwinMaker integrasi video dalam Panduan AWS IoT TwinMaker Pengguna
Apa itu AWS IoT SiteWise? di Panduan AWS IoT SiteWise Pengguna
Memperbarui nilai atribut dalam Panduan AWS IoT SiteWise Pengguna
Apa itu AWS Secrets Manager? dalam AWS Secrets Manager Panduan Penggguna
Membuat dan mengelola rahasia di Panduan AWS Secrets Manager Pengguna

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Manajer aplikasi Docker

Greengrass CLI