边缘智能提供了 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 驱动实例。
说明
如果您是首次在当前节点上部署驱动实例，单击 立即部署。
- 在 新建驱动实例 对话框，选择 USB-Camera驱动 的最新版本，然后单击 确定。
提交部署请求后，系统将在节点上部署驱动实例。部署过程涉及到数据传输。根据现场网络环境不同，部署所需时间不同。请确保您的节点在线，并耐心等待部署完成。
驱动部署成功后，驱动实例状态 将变为 运行中。
步骤3：添加 USB 摄像头设备
在 USB-Camera 驱动实例页面，单击 添加设备。
在 添加设备 页面，您可以在 驱动信息 区域查看驱动相关信息，并参考下表说明完成 设备配置，然后单击 确定。
配置项
说明
子协议类型
选择 USB。
设备模板
选择您在创建设备模板中创建的设备模板。
本教程中选择 usb-camera。
点表
选择在创建点表中创建的点表。
本教程中选择 USB-Camera-pt。
设备名称
为设备设置一个名称。
本教程中使用 USB摄像头 作为设备名称。
标识符
为设备设置一个标识符。
本教程中使用 usb-camera-device 作为标识符。
设备路径
输入 USB 摄像头的设备文件路径。
当一个 USB 摄像头连接到 Linux 系统后，系统会自动为其创建一个设备文件，用来代表该摄像头设备。这个设备文件的路径通常为：/dev/video0。如果系统连接了多个摄像头设备，它们的设备文件路径依次为/dev/video0、/dev/video1、/dev/video2等。标签
为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
描述
为设备添加描述信息。
完成以上操作后，您可以在设备列表查看新添加的设备。最初，设备的 状态 为 添加中。当设备的状态变为 在线，表示设备已经添加成功。
步骤4：查看实时视频
完成以上操作后，您可以在边缘智能控制台查看 USB 摄像头的实时视频。
- 回到节点的 设备接入 页面，定位到新添加的设备，单击 操作 列的 直播。
- 在弹出的 设备直播 窗口，查看设备的实时视频。
在左侧视频界面，您可以通过相关操作按钮，暂停视频、刷新视频、取消静音、进入全屏模式查看。