View a markdown version of this page

Konektor tepi untuk Streaming Video Kinesis - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiLisensiPenggunaanFile log lokalChangelogLihat juga

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

Konektor tepi untuk Streaming Video Kinesis

Konektor tepi untuk komponen Kinesis Video Streams (aws.iot.EdgeConnectorForKVS) 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 Amazon Managed Grafana atau server Grafana lokal untuk memantau dan berinteraksi dengan aliran video.

Anda dapat mengintegrasikan komponen ini dengan 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 dari sistem fisik. Anda dapat menggunakannya AWS IoT TwinMaker untuk memvisualisasikan data dari sensor, kamera, dan aplikasi perusahaan 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 Panduan AWS IoT TwinMaker Pengguna.

Komponen ini menyimpan konfigurasinya di AWS IoT SiteWise, yang merupakan AWS layanan yang memodelkan dan menyimpan data industri. Di AWS IoT SiteWise, aset mewakili objek seperti perangkat, peralatan, atau kelompok objek lain. Untuk mengkonfigurasi 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 ini dan rahasia Manajer Rahasia. Untuk informasi selengkapnya tentang cara membuat sumber daya ini, dan cara menginstal, mengkonfigurasi, 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)

  • Asia Pasifik (Tokyo)

  • Asia Pacific (Seoul)

  • Asia Pasifik (Sydney)

  • Asia Pasifik (Mumbai)

  • Tiongkok (Beijing)

Versi

Komponen ini memiliki versi berikut:

  • 1.0.x

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). In ti 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 Meng instal 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

  • A AWS IoT SiteWise set untuk setiap perangkat inti. A AWS IoT SiteWise set ini mewakili perangkat inti. Untuk informasi selengkapnya tentang cara membuat aset ini, lihat integrasi AWS IoT TwinMaker video di Panduan AWS IoT TwinMaker Pengguna.

  • A AWS IoT SiteWise set untuk setiap kamera IP yang Anda sambungkan ke setiap perangkat inti. A AWS IoT SiteWise set ini mewakili kamera yang melakukan streaming 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 konfigurasi 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.

  • Rah AWS Secrets Manager asia untuk setiap kamera IP. Rahasia ini harus menentukan pasangan kunci-nilai, di mana kunci beradaRTSPStreamUrl, 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.

  • Per an pertukaran token Greengrass harus mengizinkan tindakan berikut AWS Secrets Manager, AWS IoT SiteWise, dan Kinesis Video Streams, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

    catatan

    Kebijakan contoh ini memungkinkan perangkat untuk mendapatkan nilai rahasia bernama IPCamera1Url danIPCamera2Url. Ketika Anda mengkonfigurasi 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 tersebut.

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 Diperlukan Deskripsi

kinesisvideo.region.amazonaws.com

 443 Ya

Unggah data ke Kinesis Video Streams.

data.iotsitewise.region.amazonaws.com

 443 Ya

Publikasikan metadata aliran video ke AWS IoT SiteWise.

secretsmanager.region.amazonaws.com

 443 Ya

Unduh rahasia URL kamera ke perangkat inti.

Dependensi

Saat Anda menerapkan komponen, AWS IoT Greengrass juga menerapkan 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
Pengelola 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 pihak ketiga berikut software/licensing:

Penggunaan

Untuk mengkonfigurasi dan berinteraksi dengan komponen ini, Anda dapat mengatur properti pada AWS IoT SiteWise aset yang mewakili perangkat inti dan kamera IP tempat 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.

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