本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Kinesis Video Streams 的邊緣連接器
Kinesis Video Streams 元件 (aws.iot.EdgeConnectorForKVS
) 的邊緣連接器會從本機攝影機讀取視訊饋送,並將串流發佈到 Kinesis Video Streams。您可以將此元件設定為使用即時串流通訊協定 (RTSP) 從網際網路通訊協定 (IP) 攝影機讀取視訊饋送。然後,您可以在 Amazon 受管的 Grafana 或本機 Grafana 伺服器中設定儀表板,以監控影片串流並與之互動。
您可以將此元件與整合,以 AWS IoT TwinMaker 便在 Grafana 儀表板中顯示和控制視訊串流。 AWS IoT TwinMaker 是一項 AWS 服務,可讓您建立實體系統的運作數位雙胞胎。您可以使用視覺化 AWS IoT TwinMaker 來自感測器、攝影機和企業應用程式的資料,以便追蹤實體工廠、建築物或工業廠房。您也可以使用此資料來監視作業、診斷錯誤及修復錯誤。如需詳細資訊,請參閱什麼是 AWS IoT TwinMaker? 在《AWS IoT TwinMaker 使用者指南》中。
此元件會將其組態儲存在中 AWS IoT SiteWise,這是一項用於建立工業資料模型和儲存的 AWS 服務。在中 AWS IoT SiteWise,資產代表物件,例如裝置、設備或其他物件群組。若要設定和使用此元件,您可以為每個 Greengrass 核心裝置以及連接到每個核心裝置的每個 IP 攝影機建立 AWS IoT SiteWise 資產。每個資產都有您設定用來控制功能的屬性,例如即時串流、隨選上傳和本機快取。若要指定每個攝影機的 URL,請在中建立包 AWS Secrets Manager 含攝影機 URL 的密碼。如果攝影機需要驗證,您也可以在 URL 中指定使用者名稱和密碼。然後,您可以在 IP 攝影機的資產屬性中指定該密碼。
此元件會將每個攝影機的視訊串流上傳至 Kinesis 視訊串流。您可以在每個攝影機的 AWS IoT SiteWise 資產組態中指定目的地 Kinesis 視訊串流的名稱。如果 Kinesis 視訊串流不存在,此元件會為您建立它。
AWS IoT TwinMaker 提供您可以執行的指令碼來建立這些 AWS IoT SiteWise 資產和 Secrets Manager 密碼。如需有關如何建立這些資源以及如何安裝、設定和使用此元件的詳細資訊,請參閱《使AWS IoT TwinMaker 用指南》中的AWS IoT TwinMaker 視訊整合。
注意
Kinesis Video Streams 元件的邊緣連接器僅適用於下列項目: AWS 區域
-
美國東部 (維吉尼亞北部)
-
美國西部 (奧勒岡)
-
歐洲 (法蘭克福)
-
歐洲 (愛爾蘭)
-
亞太區域 (新加坡)
版本
此元件具有下列版本:
-
1.0.x
Type
此元件是一般元件 (aws.greengrass.generic
)。Greengrass 核會執行元件的生命週期指令碼。
如需詳細資訊,請參閱 元件類型。
作業系統
此元件只能安裝在 Linux 核心裝置上。
要求
此元件具有下列需求:
-
您只能將此元件部署到單一核心裝置,因為每個核心裝置的元件組態必須是唯一的。您無法將此元件部署到核心裝置群組。
-
安裝在核心設備上的 GStreamer
1.18.4 或更高版本。如需詳細資訊,請參閱安裝 GStreamer 。 在使用的設備上
apt
,您可以運行以下命令來安裝 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 資產。此 AWS IoT SiteWise 資產代表核心裝置。如需有關如何建立此資產的詳細資訊,請參閱AWS IoT TwinMaker 使用指南中的AWS IoT TwinMaker 視訊整合。
-
您連接到每個核心設備的每個 IP 攝像機的 AWS IoT SiteWise 資產。這些 AWS IoT SiteWise 資產代表將視訊串流至每個核心裝置的攝影機。每個攝影機的資產都必須與連線至相機的核心裝置相關聯。攝影機資產具有可讓您設定為指定 Kinesis 視訊串流、驗證密碼和視訊串流參數的內容。如需有關如何建立和設定攝影機資產的詳細資訊,請參閱AWS IoT TwinMaker 使用指南中的AWS IoT TwinMaker 視訊整合。
-
每個 IP 攝像機的 AWS Secrets Manager 秘密。這個密碼必須定義一個鍵值對,其中鍵是
RTSPStreamUrl
,並且該值是攝像機的 URL。如果相機需要驗證,請在此 URL 中包含使用者名稱和密碼。當您建立此元件所需的資源時,您可以使用指令碼來建立密碼。如需詳細資訊,請參閱AWS IoT TwinMaker 使用指南中的AWS IoT TwinMaker 視訊整合。您也可以使用 Secrets Manager 主控台和 API 來建立其他密碼。若要取得更多資訊,請參閱《AWS Secrets Manager 使用指南》中的〈建立密碼〉。
-
Greengrass 權杖交換角色必須允許下列 AWS Secrets Manager AWS IoT SiteWise、和 Kinesis Video Streams 動作,如下列範例 IAM 政策所示。
注意
此範例原則允許裝置取得名為
IPCamera1Url
和的密碼值IPCamera2Url
。設定每個 IP 攝影機時,您要指定包含該攝影機 URL 的密碼。如果攝影機需要驗證,您也可以在 URL 中指定使用者名稱和密碼。核心設備的令牌交換角色必須允許訪問每個 IP 攝像機連接的密碼。{ "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": [ "*" ] } ] }注意
如果您使用客戶管理的 AWS Key Management Service 金鑰來加密密碼,則裝置角色也必須允許該
kms:Decrypt
處理行動。
端點和連接埠
除了基本作業所需的端點和連接埠之外,此元件還必須能夠對下列端點和連接埠執行輸出要求。如需詳細資訊,請參閱 允許裝置流量透過 Proxy 或防火牆。
端點 | 連線埠 | 必要 | 描述 |
---|---|---|---|
|
443 | 是 |
將資料上傳至 Kinesis Video Streams。 |
|
443 | 是 |
將視訊串流中繼資料發佈至 AWS IoT SiteWise. |
|
443 | 是 |
將相機 URL 秘密下載到核心設備。 |
相依性
部署元件時, AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求,才能成功部署元件。本節列出此元件之已發行版本的相依性,以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass 主控台
下表列出此元件 1.0.0 至 1.0.5 版的相依性。
如需有關元件相依性的詳細資訊,請參閱元件方案參考。
組態
此元件提供下列組態參數,您可以在部署元件時自訂這些參數。
SiteWiseAssetIdForHub
-
代表此核心裝置的 AWS IoT SiteWise 資產 ID。如需有關如何建立此資產並使用該資產與此元件互動的詳細資訊,請參閱使AWS IoT TwinMaker 用指南中的AWS IoT TwinMaker 視訊整合。
範例:組態合併更新
{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }
授權
此元件包括下列協力廠商軟體/授權:
-
石英Job 計程序
/Apache 許可證 2.0 -
Java 綁定為 GStreamer 1.x
/GNU 較寬鬆的通用公共許可證
用量
若要設定此元件並與之互動,您可以在代表核心裝置的 AWS IoT SiteWise 資產以及其連線的 IP 攝影機上設定屬性。您也可以透過 Grafana 儀表板視覺化視訊串流並與之互動。 AWS IoT TwinMaker如需詳細資訊,請參閱AWS IoT TwinMaker 使用指南中的AWS IoT TwinMaker 視訊整合。
本機記錄檔
此元件使用下列記錄檔。
/logs/aws.iot.EdgeConnectorForKVS.log
/greengrass/v2
若要檢視此元件的記錄
-
在核心裝置上執行下列命令,即時檢視此元件的記錄檔。以 AWS IoT Greengrass 根資料夾的路徑取
代。/greengrass/v2
sudo tail -f
/logs/aws.iot.EdgeConnectorForKVS.log/greengrass/v2
變更記錄
下表說明元件每個版本中的變更。
版本 |
變更 |
---|---|
1.0.5 |
一般錯誤修正與改進。 |
1.0.4 |
|
1.0.3 |
一般錯誤修正與改進。 |
1.0.1 |
一般錯誤修正與改進。 |
1.0.0 |
初始版本。 |
另請參閱
-
什麼是 AWS IoT TwinMaker? 《AWS IoT TwinMaker 使用者指南》中的
-
AWS IoT TwinMaker AWS IoT TwinMaker 使用者指南中的視訊整合
-
什麼是 AWS IoT SiteWise? 《AWS IoT SiteWise 使用者指南》中的
-
《AWS Secrets Manager 使用者指南》中的什麼是 AWS Secrets Manager?
-
在AWS Secrets Manager 使用者指南中建立和管理密碼