安装与配置指南：UVCAndroid - 安卓UVC相机开发库

最新推荐文章于 2025-03-07 09:47:04 发布

郝会州Oliver

最新推荐文章于 2025-03-07 09:47:04 发布

阅读量886

点赞数 3

本文链接：https://blog.csdn.net/gitblog_09655/article/details/142221650

版权

安装与配置指南：UVCAndroid - 安卓UVC相机开发库

UVCAndroid 项目地址: https://gitcode.com/gh_mirrors/uv/UVCAndroid

项目基础介绍

UVCAndroid 是一款专为非root权限下的Android设备设计的UVC（Universal Video Class）相机通用开发库。这个项目基于先前的UVCCamera进行了重构和优化，引入了最新的libjpeg-turbo、libusb以及libuvc库版本，并且其拍照和录像功能灵感源自Google的CameraX库。它支持多预览、多摄像头功能，非常适合需要集成USB摄像头到Android应用的开发者。项目的主要编程语言是Java和C/C++。

关键技术和框架

UVC协议: 用于与USB摄像设备通信的核心标准。
libjpeg-turbo: 加速JPEG编码和解码的库。
libusb: 提供USB设备访问的跨平台库。
libuvc: 专门处理UVC设备的库，简化USB视频类设备的编程。
Android框架API: 利用Android系统的API来实现相机预览、图像捕捉和视频录制。
R8/ProGuard: 用于代码混淆和优化。

安装和配置步骤

准备工作

确保开发环境: 安装最新版Android Studio及相应的Android SDK（最低要求API Level 21，即Android 5.0 Lollipop）。
Git: 安装Git客户端以便克隆项目源码。
JITPACK.IO: 因为依赖可能不是直接从Maven Central或JCenter获取，你需要配置项目以使用JITPACK仓库。

克隆项目源码

git clone https://github.com/shiyinghan/UVCAndroid.git

添加依赖

在你的项目的build.gradle(位于项目根目录) 文件的repositories块中添加JITPACK仓库：

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
        // ...其他默认仓库
    }
}

然后，在你的应用级别的build.gradle文件中添加UVCAndroid的依赖：

dependencies {
    implementation 'com.herohan:UVCAndroid:1.0.7'
}

配置代码混淆

如果你的应用使用了ProGuard或者开启了R8，需加入以下规则避免混淆关键类：

proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'

// 防止相关回调和类被混淆
-keep class com.herohan.uvcapp.** { *; }
-keep class com.serenegiant.usb.** { *; }
-keepclassmembers class * implements com.serenegiant.usb.IButtonCallback { *; }
-keepclassmembers class * implements com.serenegiant.usb.IFrameCallback { *; }
-keepclassmembers class * implements com.serenegiant.usb.IStatusCallback { *; }