边缘智能提供了 USB-Camera 驱动程序，允许您快捷添加 USB 摄像头到节点（一体机）。添加设备到节点后，您可以查看设备的实时视频。本文介绍了 USB-Camera 驱动的使用方法。
背景信息
USB 摄像头是一种连接到计算机或其他设备的视频监控设备，通过 USB 接口传输视频信号，通常用于视频通话、网络会议、实时视频监控等应用。
您可以使用边缘智能提供的 USB-Camera 驱动快速接入 USB 摄像头到节点，获取实时视频数据并上传数据到云端进行查看。
USB-Camera 驱动介绍
查看官方 USB-Camera 驱动
您可以在边缘智能控制台的 设备管理 > 驱动模板 页面，查看官方 USB-Camera驱动。
驱动配置
官方 USB-Camera 驱动的子协议配置和点表配置说明见下表。
配置项 | 名称 | 参数名称 | 说明 |
|---|---|---|---|
子协议配置 | USB | 设备路径 | 表示设备文件路径。 |
点表配置 | N/A | 采样周期 | 表示每隔多久采集一次数据。单位：毫秒。默认值：10000。 |
准备工作
准备 USB 摄像头
使用 USB-Camera 驱动前，您需要将 USB 摄像头与节点通过 USB 接口连接起来，并获取摄像头在节点中的设备文件路径。
您可以通过命令ls/dev/video*来查看系统中的 USB 摄像头设备，如果有摄像头连接，就会看到类似下面的输出：
/dev/video0
这表明系统识别到了一个摄像头设备，它的设备文件路径是/dev/video0。
准备节点
使用 USB-Camera 驱动前，您需要准备一台边缘智能节点，并完成以下工作：
步骤1：配置视频流设备模板
创建设备模板
登录边缘智能控制台。
在左侧导航栏顶部的 我的项目 区域，选择您的项目。
在左侧导航栏，选择 设备管理 > 设备模板。
单击 创建设备模板。
在 创建设备模板 对话框，完成以下配置，并单击 确定。
配置项
说明
名称
为设备模板设置一个名称。
本教程中使用 usb-camera。
设备类型
选择 视频流设备。
品类选择
本教程不选择品类。关于品类的说明，请参见创建设备模板。
描述
为设备模板添加描述信息。
创建成功后，在 设备模板 页面可以看到新创建的设备模板。
发布物模型
您可以通过物模型定义设备功能，并发布一个版本使其生效。
- 找到新创建的设备模板，单击模板名称。
- 在 模板详情 页面，单击 物模型定义 页签，然后单击 编辑。
在 编辑物模型 页面，可以看到，对于 视频流设备 模板，默认模块 中包含以下 3 个自定义功能。- Snapshot：服务。调用 Snapshot，可以截取当前视频流直播画面。
- ContinuousMove：属性，用于控制摄像头云台。
- LocalStreamUri：属性，表示本地视频流 URI。该 URI 用于视频流数据在节点内部流转。例如节点内部的应用需要处理视频数据。
目前 USB-Camera 驱动仅支持视频流功能，不支持视频截图和云台操作，所以需要删除物模型自带的 Snapshot 和 ContinuousMove 功能。单击对应功能 操作 下的 删除，经二次确认后即可删除。
操作完成后，如下图所示。
- 配置好物模型后，单击右下角的 保存。
- 在 发布新版本 对话框，设置 版本号 和 描述，然后单击 确定。
发布成功后，您将会得到如下图所示的物模型。
创建点表
物模型定义完成后，需要为物模型属性创建点表。
在 模板详情 页面，单击 点表 页签，然后单击 创建点表。
在 创建点表 页面，完成以下配置，并单击 确认。
类别
配置项
说明
基本信息
名称
为点表设置一个名称。
本教程中使用 USB-Camera-pt 作为点表名称。
驱动模板
选择 USB-Camera 驱动。
配置信息
LocalStreamUri - 采样周期
使用默认配置 10000ms。
创建成功后，您将得到一个如下图所示的点表。
步骤2：部署 USB-Camera 驱动
您必须在节点上部署 USB-Camera 驱动，然后才可以添加 USB 摄像头到节点。
- 在左侧导航栏，单击 节点管理。
- 在 节点管理 页面，找到要部署 USB-Camera 驱动的节点，单击节点名称。
- 单击 设备接入 页签。
- 根据节点上是否部署过驱动实例，执行相应操作：
- 如果节点上未部署过任何驱动实例，单击页面提示信息中的 立即部署。
- 如果节点上部署过驱动实例，请检查 驱动实例 列表是否包含 USB-Camera驱动。
- 如果 视频流驱动 包含在列表中（驱动实例状态 是 运行中），您可跳过本步骤，直接前往步骤3：添加 USB 摄像头设备。
- 如果设备所需驱动未包含在列表中，单击 驱动实例 列表右上方的 新建驱动实例。
- 如果节点上未部署过任何驱动实例，单击页面提示信息中的 立即部署。
- 在 新建驱动实例 对话框，选择 USB-Camera驱动 的最新版本，然后单击 确定。
提交部署请求后，系统将在节点上部署驱动实例。部署过程涉及到数据传输。根据现场网络环境不同，部署所需时间不同。请确保您的节点在线，并耐心等待部署完成。
驱动部署成功后，驱动实例状态 将变为 运行中。
步骤3：添加 USB 摄像头设备
- 在 驱动实例 列表选中 USB-Camera 驱动。
- 在 基本信息 标签页，您可以选择以下方式添加设备：
添加设备
在 基本信息 标签页，单击 添加设备。
在 添加设备 面板，完成以下配置，然后单击 确定。
配置项
说明
名称
为设备设置一个名称。
本教程中使用 USB摄像头 作为设备名称。
标识符
为设备设置一个标识符。
本教程中使用 usb-camera-device 作为标识符。
设备模板
选择您在创建设备模板中创建的设备模板。
本教程中选择 usb-camera。
点表
选择在创建点表中创建的点表。
本教程中选择 gb28181-pt。
子协议名称
选择 USB。
设备路径
输入 USB 摄像头的设备文件路径。
当一个 USB 摄像头连接到 Linux 系统后，系统会自动为其创建一个设备文件，用来代表该摄像头设备。这个设备文件的路径通常为：/dev/video0。如果系统连接了多个摄像头设备，它们的设备文件路径依次为/dev/video0、/dev/video1、/dev/video2等。标签
为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
描述
为设备添加描述信息。
完成以上操作后，您可以在设备列表查看新添加的设备。最初，设备的 状态 为 添加中。当设备的状态变为 在线，表示设备已经添加成功。
批量添加
- 在 基本信息 标签页，单击 批量添加。
- 在 添加设备 页面，您可以选择以下两种方式添加设备：
自定义添加
在 添加设备 页面，您可以在 驱动信息 区域查看驱动相关信息，并参考下表说明完成 设备配置，然后单击 确定。
配置项
说明
子协议类型
选择 USB。
设备模板
选择您在创建设备模板中创建的设备模板。
本教程中选择 usb-camera。
点表
选择在创建点表中创建的点表。
本教程中选择 USB-Camera-pt。
设备名称
为设备设置一个名称。
本教程中使用 USB摄像头 作为设备名称。
标识符
为设备设置一个标识符。
本教程中使用 usb-camera-device 作为标识符。
设备路径
输入 USB 摄像头的设备文件路径。
当一个 USB 摄像头连接到 Linux 系统后，系统会自动为其创建一个设备文件，用来代表该摄像头设备。这个设备文件的路径通常为：/dev/video0。如果系统连接了多个摄像头设备，它们的设备文件路径依次为/dev/video0、/dev/video1、/dev/video2等。标签
为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
描述
为设备添加描述信息。
（可选）如果需要同时添加多个设备实例，在 添加设备 后的输入框中输入要添加的设备个数，然后单击 添加设备。系统会自动生成多个设备配置条目。
（可选）如果需要批量设置一些设备参数，先勾选右上角的 批量编辑所有配置项，然后修改某个参数值，系统会同步修改所有设备的对应参数值。
说明
勾选 批量编辑所有配置项 后，如果参数配置框置灰，表示该参数不支持批量设置。
完成以上操作后，您可以在设备列表查看新添加的设备。最初，设备的 状态 为 添加中。当设备的状态变为 在线 后，表示设备已经添加成功。
设备自发现
在 添加设备 页面，单击 设备自发现 页签。
在 搜索设备 引导页下，完成以下操作。
- 在 USB-Camera 设备自发现 区域，单击 搜索设备。
等待几秒后，可以看到已接入节点的所有 USB 摄像头设备及相关信息，包括添加状态、设备名称、设备路径、产品名称和序列号。 - 在设备列表中勾选需要添加的设备，然后单击 下一步。
- 在 USB-Camera 设备自发现 区域，单击 搜索设备。
在 设备配置 引导页，您可以在 驱动信息 区域查看驱动相关信息。在 设备配置 区域，您需要完成以下配置。
配置项
说明
子协议类型
选择 USB。
设备模板
选择您在创建设备模板中创建的设备模板。
本教程中选择 usb-camera。
点表
选择在创建点表中创建的点表。
本教程中选择 USB-Camera-pt。
设备名称
为设备设置一个名称。
标识符
设备的标识符。设备自发现完成后自动填写，您也可以根据需要修改。
设备路径
USB 摄像头在 Linux 系统中的设备文件路径，根据自发现自动填写，无需手动编辑。
标签
为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
描述
为设备添加描述信息。
（可选）如果需要批量设置一些设备参数，先勾选右上角的 批量编辑所有配置项，然后修改某个参数值，系统会同步修改所有设备的对应参数值。
说明
勾选 批量编辑所有配置项 后，如果参数配置框置灰，表示该参数不支持批量设置。
完成以上配置后，单击 确定。
完成以上操作后，您可以在 设备实例 列表查看新添加的设备。此时，设备的 状态 为 添加中。当设备的状态变为 在线，表示设备已经添加成功。
步骤4：查看实时视频
完成以上操作后，您可以在边缘智能控制台查看 USB 摄像头的实时视频。
- 回到节点的 设备接入 页面，定位到新添加的设备，单击 操作 列的 直播。
- 在弹出的 设备直播 窗口，查看设备的实时视频。
在视频界面，您可以通过相关操作按钮，暂停视频、刷新视频、取消静音、进入全屏模式查看。