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 IoTTwinMaker?中的Amazon IoT TwinMaker 用户指南.

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

此组件将每台摄像机的视频流上传到 Kinesis Video Streams。您可以在Amazon IoT SiteWise每台摄像机的资产配置。如果 Kinesis Video Streams 不存在,则此组件将为您创建它。

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 SiteWise资产代表将视频传输到每个核心设备的摄像机。每个摄像机的资产必须与连接到相机的核心设备的资产相关联。相机资产具有可以配置为指定 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 策略所示。

    注意

    此示例策略允许设备获取名为的密钥值。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控制台. 在组件详细信息页面上,查找依赖项列表。

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

依赖关系 兼容的版本 依赖项类型
Greengrass 核 >=2.0.0 硬性
令牌兑换服务 ^2.0.0 硬性
流管理器 ^2.0.0 硬性

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

配置

此组件提供了以下配置参数,您可以在部署组件时自定义这些参数。

SiteWiseAssetIdForHub

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

例如:更新配置合并

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

许可证

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

用量

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

本地日志文件

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

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

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。Replace/绿草/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

初始版本。

另请参阅