使用官方 USB-Camera 驱动

边缘智能提供了 USB-Camera 驱动程序，允许您快捷添加 USB 摄像头到一体机。添加设备到一体机后，您可以查看设备的实时视频。本文介绍了 USB-Camera 驱动的使用方法。

背景信息

USB 摄像头是一种连接到计算机或其他设备的视频监控设备，通过 USB 接口传输视频信号，通常用于视频通话、网络会议、实时视频监控等应用。
您可以使用边缘智能提供的 USB-Camera 驱动快速接入 USB 摄像头到一体机，获取实时视频数据并上传数据到云端进行查看。

USB-Camera 驱动介绍

查看官方 USB-Camera 驱动

您可以在边缘智能控制台的 设备管理 > 驱动模板 页面，查看官方 USB-Camera驱动。

驱动配置

官方 USB-Camera 驱动的子协议配置和点表配置说明见下表。

准备工作

准备 USB 摄像头

使用 USB-Camera 驱动前，您需要将 USB 摄像头与一体机通过 USB 接口连接起来，并获取摄像头在一体机中的设备路径。

准备一体机

使用 USB-Camera 驱动前，您需要准备一台边缘一体机，并完成以下工作：

• 为一体机配置网络
  需要保证一体机与现场设备网络互通。
• 为一体机绑定项目

步骤1：配置视频流设备模板

创建设备模板

1. 登录边缘智能控制台。

2. 在左侧导航栏顶部的 我的项目 区域，选择您的项目。

3. 在左侧导航栏，选择 设备管理 > 设备模板。

4. 单击 创建设备模板。

5. 在 创建设备模板 对话框，完成以下配置，并单击 确定。

   配置项	说明
   名称	为设备模板设置一个名称。 本教程中使用 usb-camera。
   设备类型	选择 视频流设备。
   描述	为设备模板添加描述信息。

   

创建成功后，在 设备模板 页面可以看到新创建的设备模板。

发布物模型

您可以通过物模型定义设备功能，并发布一个版本使其生效。

1. 找到新创建的设备模板，单击模板名称。
2. 在 模板详情 页面，单击 物模型定义 页签，然后单击 编辑。
   在 编辑物模型 页面，可以看到，对于 视频流设备 模板，默认模块 中包含以下 3 个自定义功能。
   • Snapshot：服务。调用 Snapshot，可以截取当前视频流直播画面。
   • ContinuousMove：属性，用于控制摄像头云台。
   • LocalStreamUri：属性，表示本地视频流 URI。该 URI 用于视频流数据在一体机内部流转。例如一体机内部的应用需要处理视频数据。
     目前 USB-Camera 驱动仅支持视频流功能，不支持视频截图和云台操作，所以需要删除物模型自带的 Snapshot 和 ContinuousMove 功能。单击对应功能 操作 下的 删除，经二次确认后即可删除。
     操作完成后，如下图所示。
     
3. 配置好物模型后，单击左下角的 确定。
4. 在 发布新版本 对话框，设置 版本号 和 描述，然后单击 确定。
   

发布成功后，您将会得到如下图所示的物模型。

创建点表

物模型定义完成后，需要为物模型属性创建点表。

1. 在 模板详情 页面，单击 点表 页签，然后单击 创建点表。

2. 在 创建点表 页面，完成以下配置，并单击 确认。

   类别	配置项	说明
   基本信息	名称	为点表设置一个名称。 本教程中使用 USB-Camera-pt 作为点表名称。
   	驱动模板	选择 USB-Camera 驱动。
   配置信息	LocalStreamUri - 采样周期	使用默认配置 10000ms。

创建成功后，您将得到一个如下图所示的点表。

步骤2：部署 USB-Camera 驱动

您必须在一体机上部署 USB-Camera 驱动，然后才可以添加 USB 摄像头到一体机。

1. 在左侧导航栏，单击 一体机。
2. 在 一体机 页面，找到要部署 USB-Camera 驱动的一体机，单击一体机名称。
3. 单击 设备接入 页签。
4. 在 驱动实例 右侧，单击 新建驱动实例，创建 USB-Camera 驱动实例。

   说明

   如果您是首次在当前一体机上部署驱动实例，单击 立即部署。

5. 在 新建驱动实例 对话框，选择 USB-Camera驱动 的最新版本，然后单击 确定。

提交部署请求后，系统将在一体机上部署驱动实例。部署过程涉及到数据传输。根据现场网络环境不同，部署所需时间不同。请确保您的一体机在线，并耐心等待部署完成。
驱动部署成功后，驱动实例状态 将变为 运行中。

步骤3：添加 USB 摄像头设备

1. 在 USB-Camera 驱动实例页面，单击 添加设备。

2. 在 添加设备 面板，完成以下参数配置，并单击 确定。

   配置项	说明
   名称	为设备设置一个名称。 本教程中使用 USB摄像头 作为设备名称。
   标识符	为设备设置一个标识符。 本教程中使用 usb-camera-device 作为标识符。
   设备模板	选择您在创建设备模板中创建的设备模板。 本教程中选择 usb-camera。
   子协议名称	选择 USB。
   设备路径	输入 USB 摄像头在一体机中的设备路径。
   点表	选择在创建点表中创建的点表。 本教程中选择 USB-Camera-pt。
   标签	为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
   描述	为设备添加描述信息。

完成以上操作后，您可以在设备列表查看新添加的设备。最初，设备的 状态 为 添加中。当设备的状态变为 在线，表示设备已经添加成功。

步骤4：部署北向通道

将 USB 摄像头添加到一体机后，您还需要在一体机上部署北向通道，才能使一体机的视频流数据上报到边缘智能控制台供您查看。

1. 在左侧导航栏，选择 设备管理 > 北向通道。

2. 单击 创建北向通道。

3. 在 创建北向通道 页面，完成以下配置，并单击 确定。

   类别	配置项	说明
   基本信息	名称	为北向通道设置一个名称。 本教程中使用 live-data-to-cloud。
   	类型	选择 直播上云。
   	描述	为北向通道添加描述。
   部署到一体机	N/A	从一体机列表中选择目标一体机，部署该北向通道。

等待北向通道在一体机上部署成功。

步骤5：查看实时视频

完成以上操作后，您可以在边缘智能控制台查看 USB 摄像头的实时视频。

1. 回到一体机的 设备接入 页面，定位到新添加的设备，单击 操作 列的 直播。
   
2. 在弹出的 设备直播 窗口，查看设备的实时视频。
   在左侧视频界面，您可以通过相关操作按钮，暂停视频、刷新视频、取消静音、进入全屏模式查看。