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

背景信息 #

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

USB-Camera 驱动介绍 #

查看官方 USB-Camera 驱动 #

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

驱动配置 #

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

准备工作 #

准备 USB 摄像头 #

使用 USB-Camera 驱动前，您需要将 USB 摄像头与节点通过 USB 接口连接起来，并获取摄像头在节点中的设备文件路径。
您可以通过命令ls/dev/video*来查看系统中的 USB 摄像头设备，如果有摄像头连接，就会看到类似下面的输出：

/dev/video0

这表明系统识别到了一个摄像头设备，它的设备文件路径是/dev/video0。

准备节点 #

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

• 为边缘节点配置网络
  需要保证节点与现场设备网络互通。
• 绑定节点
• 确保节点上的边缘智能软件版本不小于 v2.7.0。如果小于 v2.7.0，请升级节点软件。具体操作，请参见升级节点软件。
  

步骤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驱动。
     • 如果 视频流驱动 包含在列表中（驱动实例状态 是 运行中），您可跳过本步骤，直接前往步骤3：添加 USB 摄像头设备。
     • 如果设备所需驱动未包含在列表中，单击 驱动实例 列表右上方的 新建驱动实例。
5. 在 新建驱动实例 对话框，选择 USB-Camera驱动 的最新版本，然后单击 确定。

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

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

1. 在 驱动实例 列表选中 USB-Camera 驱动。
2. 在 基本信息 标签页，您可以选择以下方式添加设备：
   • 添加设备：一次添加一个设备实例。
   • 批量添加：一次添加一个或多个设备实例。最多可以同时添加 100 个设备实例，并批量设置一些设备参数。

添加设备 #

1. 在 基本信息 标签页，单击 添加设备。

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

   配置项	说明
   名称	为设备设置一个名称。 本教程中使用 USB摄像头 作为设备名称。
   标识符	为设备设置一个标识符。 本教程中使用 usb-camera-device 作为标识符。
   设备模板	选择您在创建设备模板中创建的设备模板。 本教程中选择 usb-camera。
   点表	选择在创建点表中创建的点表。 本教程中选择 gb28181-pt。
   子协议名称	选择 USB。
   设备路径	输入 USB 摄像头的设备文件路径。 当一个 USB 摄像头连接到 Linux 系统后，系统会自动为其创建一个设备文件，用来代表该摄像头设备。这个设备文件的路径通常为：/dev/video0。如果系统连接了多个摄像头设备，它们的设备文件路径依次为/dev/video0、/dev/video1、/dev/video2等。
   标签	为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
   描述	为设备添加描述信息。

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

批量添加 #

1. 在 基本信息 标签页，单击 批量添加。
2. 在 添加设备 页面，您可以选择以下两种方式添加设备：
   • 自定义添加：手动输入设备信息，完成设备添加。
   • 设备自发现：在网络中自动搜索并识别接入节点的 USB 设备，通过简单的配置实现 USB 摄像头的快速自动添加。

自定义添加

1. 在 添加设备 页面，您可以在 驱动信息 区域查看驱动相关信息，并参考下表说明完成 设备配置，然后单击 确定。

   配置项	说明
   子协议类型	选择 USB。
   设备模板	选择您在创建设备模板中创建的设备模板。 本教程中选择 usb-camera。
   点表	选择在创建点表中创建的点表。 本教程中选择 USB-Camera-pt。
   设备名称	为设备设置一个名称。 本教程中使用 USB摄像头 作为设备名称。
   标识符	为设备设置一个标识符。 本教程中使用 usb-camera-device 作为标识符。
   设备路径	输入 USB 摄像头的设备文件路径。 当一个 USB 摄像头连接到 Linux 系统后，系统会自动为其创建一个设备文件，用来代表该摄像头设备。这个设备文件的路径通常为：/dev/video0。如果系统连接了多个摄像头设备，它们的设备文件路径依次为/dev/video0、/dev/video1、/dev/video2等。
   标签	为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
   描述	为设备添加描述信息。

2. （可选）如果需要同时添加多个设备实例，在 添加设备 后的输入框中输入要添加的设备个数，然后单击 添加设备。系统会自动生成多个设备配置条目。

3. （可选）如果需要批量设置一些设备参数，先勾选右上角的 批量编辑所有配置项，然后修改某个参数值，系统会同步修改所有设备的对应参数值。

   说明

   勾选 批量编辑所有配置项 后，如果参数配置框置灰，表示该参数不支持批量设置。

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

设备自发现

1. 在 添加设备 页面，单击 设备自发现 页签。

2. 在 搜索设备 引导页下，完成以下操作。

   1. 在 USB-Camera 设备自发现 区域，单击 搜索设备。
      等待几秒后，可以看到已接入节点的所有 USB 摄像头设备及相关信息，包括添加状态、设备名称、设备路径、产品名称和序列号。
   2. 在设备列表中勾选需要添加的设备，然后单击 下一步。

3. 在 设备配置 引导页，您可以在 驱动信息 区域查看驱动相关信息。在 设备配置 区域，您需要完成以下配置。

   配置项	说明
   子协议类型	选择 USB。
   设备模板	选择您在创建设备模板中创建的设备模板。 本教程中选择 usb-camera。
   点表	选择在创建点表中创建的点表。 本教程中选择 USB-Camera-pt。
   设备名称	为设备设置一个名称。
   标识符	设备的标识符。设备自发现完成后自动填写，您也可以根据需要修改。
   设备路径	USB 摄像头在 Linux 系统中的设备文件路径，根据自发现自动填写，无需手动编辑。
   标签	为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
   描述	为设备添加描述信息。

4. （可选）如果需要批量设置一些设备参数，先勾选右上角的 批量编辑所有配置项，然后修改某个参数值，系统会同步修改所有设备的对应参数值。

   说明

   勾选 批量编辑所有配置项 后，如果参数配置框置灰，表示该参数不支持批量设置。

5. 完成以上配置后，单击 确定。

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

步骤4：查看实时视频 #

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

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