Kinesis Video Streams 的边缘连接器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Kinesis Video Streams 的边缘连接器

Kinesis Video Streams 组件的边缘连接器 (aws.iot.EdgeConnectorForKVS) 读取来自本地摄像机的视频源,然后将直播发布到 Kinesis Video Streams。您可以将此组件配置为使用实时流协议 (RTSP) 从互联网协议 (IP) 摄像机读取视频源。然后,您可以在Amazon Managed Grafana或本地 Grafana 服务器来监控视频流并与之交互。

您可以将此组件与Amazon IoT TwinMaker 在 Grafana 仪表板中显示和控制视频流。Amazon IoT TwinMaker 是一个Amazon服务,使您能够构建物理系统的可操作数字孪生模型。您可以使用Amazon IoT TwinMaker 可视化来自传感器、摄像头和企业应用程序的数据,以便您跟踪物理工厂、建筑物或工业厂房。您还可以使用此数据来监控运营、进行诊断和修复错误。有关更多信息,请参阅 Amazon IoT TwinMaker 用户指南 什么是 Amazon IoT TwinMaker?

此组件将其配置存储在Amazon IoT SiteWise,这是一个Amazon建模和存储工业数据的服务。InAmazon IoT SiteWise、资产表示诸如设备、设备或其他对象组之类的对象。要配置和使用此组件,请创建Amazon IoT SiteWise每台 Greengrass 核心设备以及连接到每个核心设备的每台 IP 摄像机的资产。每个资源都有您配置的属性来控制功能,例如实时流式传输、按需上传和本地缓存。要为每个摄像机指定 URL,请在中创建密钥Amazon Secrets Manager其中包含摄像机的 URL。如果摄像机需要身份验证,您还可以在 URL 中指定用户名和密码。然后,在 IP 摄像机的资产属性中指定该密钥。

此组件将每个摄像机的视频流上传到 Kinesis 视频流。在中指定目标 Kinesis 视频流的名称Amazon IoT SiteWise每台摄像机的资产配置。如果 Kinesis 视频流不存在,此组件将为您创建。

Amazon IoT TwinMaker 提供了一个脚本,你可以运行它来创建这些Amazon IoT SiteWise资产和Secrets Manager 密钥。有关如何创建这些资源以及如何安装、配置和使用此组件的更多信息,请参阅Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

注意

Kinesis Video Streams 组件的边缘连接器仅在以下版本中可用Amazon Web Services 区域:

  • 美国东部(弗吉尼亚北部)

  • 美国西部(俄勒冈)

  • 欧洲(法兰克福)

  • 欧洲(爱尔兰)

  • 亚太地区(新加坡)

版本

此组件具有以下版本:

  • 1.0.x

类型

组件是一个通用组件 (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
  • 网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon IoT SiteWise每个核心设备的资产。该Amazon IoT SiteWise资产代表核心设备。有关如何创建此资产的更多信息,请参阅Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

  • 网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon IoT SiteWise您连接到每台核心设备的每台 IP 摄像机的资产。这些Amazon IoT SiteWiseassets 表示将视频流式传输到每个核心设备的摄像机。每个摄像机的资源必须与连接到摄像机的核心设备的资源相关联。摄像机资源具有一些属性,您可以配置这些属性来指定 Kinesis 视频流、身份验证密钥和视频流参数。有关如何创建和配置摄像机资产的更多信息,请参阅Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

  • 网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon Secrets Manager每台 IP 摄像机的秘密。此密钥必须定义密钥值对,其中密钥是RTSPStreamUrl,其值为摄像机的 URL。如果摄像机需要身份验证,请在此 URL 中包含用户名和密码。在创建此组件所需的资源时,可以使用脚本创建密钥。有关更多信息,请参阅 。Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

    您还可以使用 Secrets Manager 控制台和 API 创建其他密钥。有关更多信息,请参阅 。创建密钥中的Amazon Secrets Manager用户指南.

  • 这些区域有:Greengrass 代币交易所的角色必须允许以下Amazon Secrets Manager、Amazon IoT SiteWise和 Kinesis Video Streams 操作,如以下 IAM 策略示例中所示。

    注意

    此示例策略允许设备获取名为的 Secrets 的值IPCamera1UrlIPCamera2Url. 配置每台 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": [ "*" ] } ] }
    注意

    如果您使用客户托管Amazon Key Management Service密钥来加密密钥,则设备角色还必须允许kms:Decryptaction.

终端节点和端口

除了基本操作所需的端点和端口外,此组件还必须能够对以下端点和端口执行出站请求。有关更多信息,请参阅 允许设备通过代理或防火墙进行流量

端点 端口 必填 描述

kinesisvideo.region.amazonaws.com

443

将数据上传到 Kinesis Video Streams。

data.iotsitewise.region.amazonaws.com

443

将视频流元数据发布到Amazon IoT SiteWise.

secretsmanager.region.amazonaws.com

443

将摄像头 URL 密钥下载到核心设备。

附属物

部署组件时,Amazon IoT Greengrass还部署了其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本部分列出了的依赖项发布的版本以及定义每个依赖项的组件版本的语义版本约束。您也可以在组件的各个版本中查看组件的依赖项Amazon IoT Greengrass控制台. 在组件详细信息页面上,查找依赖项list。

下表列出了此组件 1.0.0 到 1.0.4 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
令牌交换服务 >=2.0.3 硬性
流管理器 >=2.0.9 硬性

有关组件依赖项的更多信息,请参阅组件配方参考.

配置

此组件提供以下配置参数,您可以在部署组件时对其进行自定义。

SiteWiseAssetIdForHub

的 IDAmazon IoT SiteWise代表此核心设备的资产。有关如何创建此资产并使用此资产与此组件交互的更多信息,请参阅Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

例如:配置合并更新

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

许可证

此组件包含以下第三方软件/许可:

用量

要配置此组件并与之交互,您可以在Amazon IoT SiteWise表示核心设备及其连接的 IP 摄像机的资产。您还可以通过以下方式在 Grafana 仪表板中对视频流进行可视化和交互Amazon IoT TwinMaker. 有关更多信息,请参阅 。Amazon IoT TwinMaker 视频集成中的Amazon IoT TwinMaker 用户指南.

本地日志

此组件使用以下日志文件。

/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看该组件的日志文件。Replace/greengrass/v2还有通往Amazon IoT Greengrass根文件夹。

    sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log

更改日志

下表介绍了组件各个版本的更改。

Version

更改

1.0.4

错误修复和改进
  • 修复了导致实时上传停止的问题。

1.0.3

常规错误修复和性能改进。

1.0.1

常规错误修复和性能改进。

1.0.0

初始版本。

另请参阅