android uvccamera

### UVCCamera在Android上的视频采集

#### 使用UVCCamera进行视频采集的开发指南

对于希望利用USB Video Class (UVC)摄像头在Android平台上实现视频采集的应用开发者来说，理解如何集成并操作这些外设至关重要。为了简化这一过程，通常会借助第三方库来处理底层通信细节。

一个广泛使用的开源项目是`uvccamera` GitHub仓库[^3]，它提供了针对UVC摄像机的支持，并封装了一系列便于调用的方法用于初始化、配置参数以及获取图像帧等功能。此库兼容多种品牌型号的UVC相机，在遵循官方指导的前提下能够快速搭建起具备基本功能的应用程序原型。

当涉及到具体编码实践时，除了引入上述提到的依赖项之外，还需要注意权限管理方面的要求——即确保应用拥有访问外部存储空间及连接硬件配件所需的授权声明；另外就是界面设计部分，考虑到用户体验应当提供直观的操作方式让用户轻松完成诸如打开/关闭电源开关之类的动作。

下面是一份基于该类库构建简易版预览窗口的小例子：

import android.hardware.usb.UsbDevice;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    private UvcCameraHandler mCameraHandler; // 定义全局变量以便于后续控制
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        setContentView(R.layout.activity_main);

        // 初始化UVC Camera Handler实例对象
        mCameraHandler = new UvcCameraHandler(this, getLifecycle());

        // 设置回调监听器以响应设备插拔事件
        UsbManager usbManager = (UsbManager)getSystemService(Context.USB_SERVICE);
        HashMap<String, UsbDevice> deviceList = usbManager.getDeviceList();
        Iterator<UsbDevice> iterator = deviceList.values().iterator();

        while(iterator.hasNext()){
            final UsbDevice device = iterator.next();
            
            if(UvcCameraController.isSupported(device)){
                // 如果检测到支持的UVC设备，则请求用户授予相应权限
                PendingIntent pi = PendingIntent.getBroadcast(
                    this,
                    0,
                    new Intent(ACTION_USB_PERMISSION),
                    FLAG_UPDATE_CURRENT
                );
                
                usbManager.requestPermission(device, pi);    
            }
        }   
    }

    public void onPermissionsGranted(){
        try{
            // 获取已获得许可的第一个可用UVC设备作为目标源
            mCameraHandler.open(mSelectedDevice);
            
            // 启动预览服务并将画面显示至指定视图组件内
            SurfaceView previewSurface = findViewById(R.id.preview_surface_view);
            mCameraHandler.startPreview(previewSurface.getHolder());
        }catch(Exception e){
            Log.e(TAG,"Failed to start camera",e);
        }
    }
}

这段代码展示了怎样通过广播接收者捕获来自系统的通知消息从而得知是否有新的USB装置被接入系统之中，紧接着判断其是否属于可识别类型的UVC规格产品之后再向当前运行中的Activity申请必要的读写权利最后才正式开启实时影像流传输环节。