

tb4117-uvc-v0.2 是一款面向 USB 摄像头调试场景的轻量工具,主要用来在安卓端验证 UVC 协议、查看设备识别情况与实时画面。它不追求大而全的相机功能,装上之后接上支持 UVC 的摄像头,就能直接确认设备是否被系统正确枚举、画面是否正常输出,省去自己编译测试程序的步骤。

应用启动后会主动扫描当前接入的 USB 视频类设备,把识别到的摄像头名称、设备节点以及支持的分辨率列表逐项显示出来。不用去命令行里翻设备信息,界面里选中对应摄像头就能进入预览。
v0.2 版本把分辨率格式的展示方式改成了可滚动列表,设备支持多组格式时不再挤在单页里,最多能查看 12 组格式信息。
进入预览界面后,软件会同步显示当前分辨率、帧率等基础参数,方便对照摄像头是否工作在预期模式下。画面流畅度主要取决于设备本身的性能,应用侧只做了轻量缓冲处理。
如果出现偏色、画面比例不对等情况,可以结合参数显示快速判断是摄像头输出本身的问题,还是应用适配的问题。

应用没有社交分享、云存储之类的附加模块,安装完成打开即可使用。对于需要频繁插拔设备做对比测试的情况,这种轻量设计能减少后台服务对手机的额外占用。
第一次使用前,先确认手机是否支持 OTG 功能。多数中高端安卓机型默认具备,部分入门机型需要在系统设置里手动打开 OTG 开关。
连接摄像头时优先使用原装或质量可靠的 OTG 转接头,劣质转接线容易因供电不足导致设备反复掉线。
插拔 USB 设备之前,建议先在应用内退出预览界面。热插拔虽然方便,但频繁操作可能导致应用无响应,严重时需要重启手机才能恢复。
打开应用后如果提示找不到设备,先检查 OTG 是否开启,再更换转接头测试,排除线材问题。
预览分辨率不是越高越好,部分摄像头在高分辨率下帧率会明显下降。调试阶段可以先用低分辨率确认通路正常,再逐步往上调。
安卓端首次连接时可能会弹出 USB 权限请求对话框,记得点允许,并勾选默认使用该设备。电脑端通常即插即用,不需要额外授权。
应用本身不申请通讯录、短信等无关权限。如果安装时看到额外的权限请求,建议核对安装包来源是否正规。

· 遇到闪退:先清理后台再重新打开,连续闪退可以尝试卸载重装。
· 画面黑屏:优先排查摄像头供电和转接头兼容性。
· 画面卡顿:关闭其他占用 USB 总线的应用。
· 提示缺少依赖:部分设备需要额外的系统组件支持,可搜索相关关键词查找对应解决方案。
1. 将 OTG 转接头插入手机充电口。
2. 把 UVC 摄像头接到转接头的 USB 口上。
3. 打开应用,如果弹出 USB 权限请求,点击允许。
4. 应用自动识别设备后,在列表里选中摄像头进入预览。
5. 如果没有反应,检查手机设置里 OTG 功能是否开启,部分机型默认关闭需要手动启用。
从功能定位来看,它就是一个本地设备调试工具,不涉及账号登录,也不收集个人数据,权限申请集中在 USB 设备访问这一块。只要安装包来源正规,日常用来做摄像头联调没有太大问题。下载后可以核对一下应用权限列表,确认没有多余的敏感权限再使用。

v0.2(2026-01-15)
· 新增多分辨率格式的自动枚举展示,设备支持列表由单页显示改为可滚动查看,最多展示 12 组格式信息。
· 优化预览启动速度,提升约 30%,从点击设备到画面出现平均耗时缩短至 1.2 秒以内。
· 优化 USB 权限请求弹窗逻辑,减少重复授权提示。
· 修复部分安卓 12 机型上连接设备后偶发闪退的问题。
· 修复分辨率切换时画面比例短暂拉伸的显示异常。
· 修复退出预览后 USB 设备未及时释放、导致再次连接失败的 bug。