📄 UVC Camera 功能说明文档
近两年公司业务一致和USB摄像头相关,使用对比了UNIAPP插件市场好几款插件(600的、300的等等)要么功能缺少、要么对手机兼容性不好,于是自己经过认真研究、专研、分析,结合论坛需求开发了一款UNIAPP USB摄像头的原生插件。
该组件封装了对 UVC 摄像头的操作,包括设备连接、摄像头开关、分辨率调节、镜像调节、旋转调节、亮度对比度等等调节、拍照录像等。以下为部分可用的功能及其使用方式。



🧩 1. 基础控制功能
| 功能名称 | 描述 |
|---|---|
startCamera | 打开摄像头 |
stopCamera | 关闭摄像头 |
| onAttach | 设备连接事件回调 |
| onDeviceOpen | 设备打开事件回调 |
| onCameraOpen | 摄像头打开事件回调 |
| onCameraClose | 摄像头关闭事件回调 |
| onDeviceClose | 设备关闭事件回调 |
| onDetach | 设备拔出事件回调 |
| onCancel | 操作取消事件回调 |
🎥 2. 视频录制与拍照功能
| 功能名称 | 描述 |
|---|---|
| takePicture | 拍照功能 |
| startRecord | 开始录制视频 |
| stopRecord | 停止录制视频 |
🔍 3. 分辨率相关功能
| 功能名称 | 描述 |
|---|---|
| getPreviewSize | 获取当前分辨率 |
| getSupportedSizeList | 获取摄像头支持的所有分辨率列表 |
| setResolution(item) | 设置指定分辨率 |
🔄 4. 镜像与旋转功能
| 功能名称 | 描述 |
|---|---|
| setPreviewRotationAndMirror | 设置预览旋转角度和镜像模式 |
示例参数:
{
rotation: 90, // 旋转角度(0, 90, 180, 270)
mirror: 0 // 镜像模式(0:无镜像,1:水平镜像,2:垂直镜像)
}
⚙️ 5. 参数调节功能(滑块)
支持动态调节摄像头参数:
| 参数名 | 描述 |
|---|---|
| Brightness | 亮度 |
| Contrast | 对比度 |
| Saturation | 饱和度 |
| Hue | 色温 |
| WhiteBalance | 白平衡 |
| Sharpness | 锐度 |
📦 6. 系统级功能
| 功能名称 | 描述 |
|---|---|
| requestPermissions | 请求 Android 权限 |
| getAllUvcCameras | 获取所有连接的 UVC 摄像头设备信息 |
| getUVCControlParam | 获取摄像头亮度对比度参数区间 |
| resetAllControlParams | 重置所有摄像头参数 |
如需扩展功能或自定义参数,请参考 uvcData 数据结构及 methods 中的实现逻辑。
361





