Android 4.4.2下libusb等时传输返回空包问题求助

我之前在适配Android 4.4的UVC摄像头原生应用时，碰到过和你完全一致的问题——用libuvc的基础帧捕获示例在Android 5.0+上正常跑，但4.4系统里libusb的传输调用始终返回空数据，根本拿不到摄像头画面。下面是我踩坑后总结的几个核心原因和解决办法：

1. USB权限机制的版本差异是核心坑点 #

Android 5.0（API 21）引入了更灵活的USB权限请求模型，但Android 4.4（API 19）的权限逻辑要严格得多，而且libusb的内部权限处理逻辑在4.4下并不靠谱：

• 必须在AndroidManifest.xml中声明权限和Host特性：

  <uses-feature android:name="android.hardware.usb.host" />
  <uses-permission android:name="android.permission.USB_PERMISSION" />
  

• 不能完全依赖libuvc/libusb自动获取权限，必须手动通过Android原生UsbManager发起权限请求：

  UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE);
  UsbDevice targetDevice = ...; // 枚举到的UVC摄像头设备
  PendingIntent permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent("com.your.app.USB_PERMISSION"), 0);
  usbManager.requestPermission(targetDevice, permissionIntent);
  

• 要在广播接收器中确认权限授予后，再初始化libuvc的设备连接，否则libusb会因为权限不足，读取数据时返回空。

2. 升级libusb版本并适配4.4的传输逻辑 #

旧版本的libusb（比如1.0.20及以下）对Android 4.4的USB Host子系统支持存在兼容性问题，尤其是批量传输的同步/异步处理逻辑：

• 建议升级到libusb 1.0.24及以上版本，这个版本修复了不少Android平台的传输bug
• 针对4.4系统，尝试把libuvc中默认的异步传输改成同步传输（修改uvc_start_streaming的参数，把回调模式改成阻塞读取模式），我当时就是这么调整后，第一次拿到了非空的帧数据。

3. 手动校验设备端点信息 #

Android 4.4在枚举USB设备的接口和端点时，返回的信息可能和5.0+有差异，导致libuvc错误地绑定了无效的端点：

• 在初始化libuvc前，先用Android原生API枚举设备的接口和端点，确认视频流的批量输入端点：

  for (int i = 0; i < targetDevice.getInterfaceCount(); i++) {
      UsbInterface intf = targetDevice.getInterface(i);
      if (intf.getInterfaceClass() == UsbConstants.USB_CLASS_VIDEO) {
          for (int j = 0; j < intf.getEndpointCount(); j++) {
              UsbEndpoint endpoint = intf.getEndpoint(j);
              // UVC视频数据通常走批量输入端点
              if (endpoint.getType() == UsbConstants.USB_ENDPOINT_XFER_BULK 
                  && endpoint.getDirection() == UsbConstants.USB_DIR_IN) {
                  // 记录端点地址，后续可传递给libuvc做校验
              }
          }
      }
  }
  

• 修改libuvc的设备初始化逻辑，确保绑定的是正确的视频流端点，避免往无效端点读取数据导致空返回。

4. SELinux权限的特殊情况 #

部分定制的Android 4.4 ROM可能提前开启了SELinux强制模式，导致libusb无法访问/dev/bus/usb下的设备节点：

• 可以先通过adb命令临时关闭SELinux验证：setenforce 0，如果关闭后数据正常，说明是SELinux的问题
• 对于系统级应用，可以添加SELinux规则允许访问USB设备节点；如果是普通应用，建议引导用户切换到宽容模式（仅适合测试场景）。

我当时的解决组合是：手动处理USB权限 + 升级libusb到1.0.26 + 调整传输为同步模式，最终在Android 4.4设备上成功捕获到了UVC摄像头的画面。

内容的提问来源于stack exchange，提问作者Gamble