【亲测免费】 安装与配置指南：UVCAndroid - 安卓UVC相机开发库

项目基础介绍

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: 用于代码混淆和优化。

安装和配置步骤

准备工作

1. 确保开发环境: 安装最新版Android Studio及相应的Android SDK（最低要求API Level 21，即Android 5.0 Lollipop）。
2. Git: 安装Git客户端以便克隆项目源码。
3. 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 { *; }

使用示例

• 引入依赖后，你可以参照项目中的sample目录下的例子来开始使用UVCAndroid。
• 初始化相机、预览、拍照和录像等功能的具体实现代码应参考提供的样例代码。

注意事项

• 确保测试设备支持USB On-The-Go (OTG) 并且兼容UVC设备。
• 对于实际应用，还需要处理USB设备的动态插入和移除事件。

至此，您已成功配置UVCAndroid到您的项目中，接下来就是根据具体应用场景调整和测试了。祝您开发顺利！

---

以上即是针对UVCAndroid项目的安装与配置详细指南，遵循此步骤可帮助开发者快速集成该库至自己的Android应用中。