你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在 Azure IoT 操作中，ONVIF（预览版）的连接器可用于发现和使用连接到 Azure IoT 操作群集的 ONVIF 兼容相机。
Azure IoT 操作中的资产是用于表示物理资产或设备的逻辑实体。 Azure IoT 操作资产可以具有描述其行为和特征的自定义属性、数据点、流和事件。 资产与一个或多个设备相关联。 Azure IoT 操作将资产定义存储在 Azure 设备注册表中。
Azure IoT 操作中的设备是一个逻辑实体，用于定义与物理资产或设备的连接。 如果没有设备，数据无法从物理设备或资产流向 MQTT 中转站。 配置设备和资产时，将建立与物理资产或设备的连接，而数据点值、事件和流将到达 Azure IoT 操作实例。 设备具有一个或多个入站终结点。 Azure IoT 操作将设备定义存储在 Azure 设备注册表中。
适用于 Azure IoT 操作的 ONVIF 连接器（预览版）发现连接到 Azure IoT 操作实例的 ONVIF 兼容 相机，并将其注册到 Azure 设备注册表中。 注册相机后，管理操作的示例包括：
- 检索和更新相机的配置以调整输出图像配置。
- 控制相机平移、倾斜和缩放（PTZ）。
媒体连接器可以访问这些相机公开的媒体源。
媒体连接器、ONVIF 连接器、Azure IoT 操作连接器和配套服务，使您能够使用 Azure IoT 操作来实施用例，例如：
- 排队和停留时间的跟踪，用于记录客户排队所花费的时间。
- 订单准确性，通过将物品与 POS 收据进行比较来跟踪正确的订单。
- 相机检测缺陷和质量保证，以检测装配线上产品中的任何缺陷。
- 安全监测，如碰撞检测、安全区域检测和个人安全设备检测。
本文介绍如何使用操作体验 Web UI 执行以下操作：
- 为合规相机添加具有 ONVIF 终结点的设备。
- 查看在 ONVIF 终结点上发现的命名空间资产和设备。
- 创建表示 ONVIF 相机公开的媒体终结点的设备。
- 创建一个资产，用于从媒体终结点捕获快照并将其发布到 MQTT 中转站。
Prerequisites
若要配置设备和资产，需要运行 Azure IoT 操作实例。
要登录到操作体验 Web UI，则需要至少具有包含 Kubernetes - Azure Arc 实例的资源组参与者权限的 Microsoft Entra ID 帐户。 无法使用 Microsoft 帐户 (MSA) 登录。 在 Azure 租户中创建合适的 Microsoft Entra ID 帐户：
- 使用用于部署 Azure IoT 操作的同一租户和用户名登录到 Azure 门户。
- 在 Azure 门户中，前往“Microsoft Entra ID”部分，选择“用户”“+ 新用户”>“新建用户”>。 新建用户并记下密码，稍后登录时需要此密码。
- 在 Azure 门户中，前往包含 Kubernetes - Azure Arc 实例的资源组。 在“访问控制 (IAM)”页上，选择“+ 添加”“添加角色分配”>。
- 在“添加角色分配”页上，选择“特权管理员角色”。 选择“参与者”，然后选择“下一步”。
- 在“成员”页上，将新用户添加到角色。
- 选择“查看并分配”以完成新用户的设置。
现在可以使用新的用户帐户登录到 操作体验 Web 界面。
可从 Azure IoT 操作群集访问的 ONVIF 兼容相机。
管理和控制相机
ONVIF 的连接器使你可以：
- 读取相机信息和功能。
- 发现 ONVIF 相机公开的媒体 URI。
- 配置 ONVIF 设备，例如，通过更新设置或选择预设。
- 使用 PTZ 命令控制相机硬件。
ONVIF 符合性
ONVIF 具有多种合规性类别，例如发现、设备、媒体、图像处理、分析、事件和平移/倾斜/变焦 (PTZ) 服务。 若要了解详细信息，请参阅 ONVIF - 配置文件、加载项和规范。
Azure IoT Operations 中 ONVIF 的连接器侧重于对实现以下配置文件的相机设备的支持：
连接器支持以下功能：
- 发现设备信息和功能。
- 监控来自设备的事件。
- 发现设备公开的媒体 URI。 ONVIF 的连接器使这些 URI 可供媒体连接器使用。
- 图像控制，例如滤镜以及接收运动和篡改事件。
- 控制设备 PTZ。
为 ONVIF 部署连接器
当您部署 Azure IoT 操作的预览版时，部署包括三个预览连接器。 可以通过在 Azure 门户中检查是否为实例启用了预览功能来验证您是否拥有 Azure IoT Operations 的预览实例。
在操作体验 Web UI 中使用预览连接器（ONVIF、媒体和 HTTP/REST）之前，管理员必须将连接器模板实例添加到 Azure IoT 操作实例。
所有三个预览连接器都可以将捕获的数据发布到 MQTT 代理。
若要将连接器模板实例添加到 Azure IoT 操作实例，请执行以下操作：
在 Azure 门户中，转到 Azure IoT 操作实例，选择“连接器模板”，然后选择“添加连接器模板实例”：
在“添加 Akri 连接器模板”向导的第一页上，选择要添加的连接器模板类型，例如 ONVIF、媒体或 HTTP REST。 然后选择“元数据”。
在“元数据”页上，接受默认值，然后选择“设备入站终结点类型”。
在“设备入站终结点类型”页上，接受默认值，然后选择“诊断配置”。
在“诊断配置”页上，接受默认值，然后选择“运行时配置”。
在 “运行时配置 ”页上，接受默认值，然后选择“ 查看：
在“审阅”页上，查看连接器模板实例的详细信息，然后选择“创建”以创建连接器模板实例。
OT 用户现在可以使用操作体验 Web UI 来创建具有预览连接器终结点的设备。
使用 ONVIF 终结点创建设备
要添加包含 ONVIF 端点的合规摄像机设备，请执行以下步骤：
在操作体验 Web UI 中，从左侧导航窗格中选择“设备”：
选择“新建”。 在“设备详细信息”页上，输入设备的名称，例如
my-onvif-camera。 然后在 Microsoft.Onvif 磁贴上选择“新建”。 输入 ONVIF 相机的详细信息，例如：
选择“应用”将终结点添加到设备。 “设备详细信息”页现在显示 ONVIF 终结点。
在“设备详细信息”页上，选择“下一步”。
在“添加自定义属性”页上，可以选择更新或向设备添加自定义属性。 完成后选择“下一步”。
“摘要”页显示设备的详细信息。 查看详细信息，然后选择“创建”以创建设备。 几分钟后，“设备”页会显示新设备。
查看发现的资产和设备
使用 ONVIF 终结点创建设备后，ONVIF 的连接器会自动发现终结点上可用的资产和设备。 若要查看操作体验 Web UI 中发现的资产和设备，请从左侧导航窗格中选择“发现”：
如果选择从发现的 ONVIF 资产导入和创建资产，则可以创建表示 ONVIF 兼容相机功能的资产。 例如，可以创建一个资产，用于从 ONVIF 相机捕获事件，或者允许你控制 ONVIF 相机。
使用媒体终结点创建设备
若要从发现的设备创建具有媒体终结点的设备，请执行以下步骤：
在作体验 Web UI 中，从左侧导航窗格中选择“发现”。 然后选择“发现的设备”。
选择在上一部分创建的设备，例如
my-onvif-camera。 然后选择“导入并创建设备”。“设备详细信息”页显示发现的媒体终结点。 输入设备的名称，例如
my-onvif-camera-media，为每个终结点选择身份验证方法：
小窍门
可以通过选择该终结点并选择“删除入站终结点”来删除不想使用的入站终结点。
然后选择下一步。
在“添加自定义属性”页上，可以选择更新、删除或向设备添加自定义属性。 完成后选择“下一步”。
在“摘要”页上，查看设备的详细信息。 选择“创建”以创建设备。 几分钟后，“设备”页会显示新设备。
创建媒体资产以捕获快照
现在可以使用发现的媒体设备创建一个资产，用于从相机捕获快照并将其发布到 MQTT 中转站。 若要创建媒体资产，请执行以下步骤：
在操作体验 Web UI 中，从左侧导航窗格中选择“资产”。 然后选择“创建命名空间资产”。
在“资产详细信息”页上，输入资产的名称，例如
my-onvif-camera-media-asset。 然后选择要用于捕获快照的已发现终结点。
更新媒体资产的任何自定义属性，然后选择“下一步”。
在“流”页，选择“添加流”。 使用以下设置配置流：
-
流名称：
myassetvideo -
目标：
MQTT -
主题：
myassetvideo - 任务类型
-
流类型：
snapshot-to-mqtt
将其他设置保留为默认值。 然后选择“添加”。 流将添加到资产配置：
-
流名称：
选择“下一步”转到“摘要”页。 查看资产的详细信息，然后选择“创建”以创建资产。 几分钟后，“资产”页将显示新资产。
媒体资产现在配置为从符合 ONVIF 的相机捕获快照，并将其发布到 MQTT 代理。
为事件管理和控制创建 ONVIF 资产
ONVIF 兼容的相机可以生成诸如运动检测和响应控制命令（如平移、倾斜和缩放）的事件。 可以从已发现的 ONVIF 设备创建 ONVIF 资产，用于捕获这些事件，并使你能够控制相机。
在操作体验中添加 ONVIF 设备后，会自动创建发现的 ONVIF 资产：
若要为事件管理和控制创建 ONVIF 资产，请执行以下操作：
选择发现的资产，然后选择“导入并创建资产”。
在“资产详细信息”页上，输入资产的名称和说明。 已为你选择设备入站终结点。
在“事件”页上，选择“管理事件组”，选择要从相机捕获的事件类型。 可以从事件组中进行选择，例如运动检测和相机篡改：
对于保留的每个事件组，请配置它发布到的 MQTT 主题：
在“操作”页上，选择“管理管理组”以选择要用于控制 ONVIF 相机的操作，例如平移、倾斜和缩放。
对于保留的每个管理组，请配置它订阅的 MQTT 主题：
查看 ONVIF 资产配置的摘要，然后选择“创建”以创建资产。 几分钟后，“资产”页将显示新资产。
管理和控制相机
若要与 ONVIF 相机交互，可以发布 ONVIF 连接器订阅的 MQTT 消息。 消息格式基于 ONVIF 网络接口规范。
Azure IoT 操作连接器用于 ONVIF PTZ 演示的示例应用程序显示如何使用 ONVIF 的连接器执行以下操作：
- 使用媒体资产定义从相机的媒体服务中检索一个配置文件令牌。
- 使用相机的 PTZ 功能控制其位置和方向时，请使用配置文件令牌。
示例应用程序使用 Azure IoT Operations MQTT 中转站发送命令，以便与 ONVIF 的连接器交互。 若要了解详细信息，请参阅 使用 MQTT 代理发布和订阅 MQTT 消息。