📄 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
中的实现逻辑。