Android USB设备权限申请失败求助（相机识别为USB设备）

核心问题分析 #

你尝试的两种权限申请方法里，第一种从根上就错了：ACTION_USB_PERMISSION不属于Android普通运行时权限，不能用RequestPermissionContracts去申请，ContextCompat.checkSelfPermission也无法检测它的状态——这个权限是UsbManager针对单个USB设备的专属权限，只能通过第二种方法（UsbManager.requestPermission）申请，但你的第二种方法缺少关键步骤，导致弹窗不触发。

另外，未获权限时调用claimInterface崩溃是必然的，因为该方法要求必须拥有目标USB设备的访问权限。

可能原因及对应解决办法 #

1. 未注册USB权限结果广播接收器 #

UsbManager.requestPermission是通过广播返回权限申请结果的，如果没有注册对应的广播接收器，系统无法将权限状态回调给你的应用，甚至会直接跳过弹窗（因为不知道给谁返回结果）。

解决办法：
动态注册广播接收器（推荐在Activity中使用）：

// 定义自定义权限动作，避免与其他应用冲突
private const val ACTION_USB_PERMISSION = "com.your.app.USB_PERMISSION"

private val usbPermissionReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (ACTION_USB_PERMISSION == intent?.action) {
            synchronized(this) {
                val device = intent.getParcelableExtra<UsbDevice>(UsbManager.EXTRA_DEVICE)
                if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
                    device?.let {
                        // 权限授予成功，执行设备连接逻辑
                        connectToCamera(it)
                    }
                } else {
                    Toast.makeText(context, "USB权限被拒绝，无法访问相机", Toast.LENGTH_SHORT).show()
                }
            }
        }
    }
}

// 在Activity onCreate中注册接收器
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...其他初始化代码
    val filter = IntentFilter(ACTION_USB_PERMISSION)
    registerReceiver(usbPermissionReceiver, filter)
}

// 在Activity销毁时注销接收器，避免内存泄漏
override fun onDestroy() {
    super.onDestroy()
    unregisterReceiver(usbPermissionReceiver)
}

2. PendingIntent配置错误 #

Android 12及以上版本对PendingIntent的FLAG有严格要求，同时要确保动作与广播接收器的过滤规则一致。

解决办法：
修正PendingIntent的创建代码，与自定义的ACTION_USB_PERMISSION匹配：

val usbManager = getSystemService(Context.USB_SERVICE) as UsbManager
// 确保m_device是你筛选出的目标USB相机设备，不能为null
m_device?.let { device ->
    val permissionIntent = PendingIntent.getBroadcast(
        this,
        0,
        Intent(ACTION_USB_PERMISSION),
        // Android 12+需要FLAG_MUTABLE，旧版本用FLAG_UPDATE_CURRENT
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            PendingIntent.FLAG_MUTABLE
        } else {
            PendingIntent.FLAG_UPDATE_CURRENT
        }
    )
    usbManager.requestPermission(device, permissionIntent)
}

3. 目标USB设备未正确获取 #

如果m_device是null，或者不是你要访问的相机设备，requestPermission自然不会触发弹窗。

解决办法：
通过UsbManager枚举所有USB设备，根据相机的VID/PID筛选目标设备：

val usbManager = getSystemService(Context.USB_SERVICE) as UsbManager
val deviceList = usbManager.deviceList
// 替换成你的相机VID和PID（示例中是7758，即0x1E6E）
val targetVid = 7758
val targetPid = 1234 // 替换为实际PID
val targetDevice = deviceList.values.find { it.vendorId == targetVid && it.productId == targetPid }
targetDevice?.let {
    // 这里调用requestPermission申请权限
} ?: run {
    Toast.makeText(this, "未检测到目标USB相机", Toast.LENGTH_SHORT).show()
}

4. USB设备已被其他应用/系统占用 #

如果系统相机或其他应用已经占用了该USB相机，你的应用无法申请到权限，弹窗也不会显示。

解决办法：
关闭所有可能占用该USB设备的应用（包括系统相机），重新插拔USB设备后再测试。

5. Manifest配置遗漏 #

确保Manifest中已添加USB主机模式所需的配置：

<!-- 声明支持USB主机模式 -->
<uses-feature android:name="android.hardware.usb.host" android:required="true"/>
<!-- USB设备访问权限 -->
<uses-permission android:name="android.permission.USB_PERMISSION"/>

避免崩溃的关键操作 #

在调用claimInterface前，必须确保：

1. 已通过广播接收器确认权限已授予
2. m_connection和m_device均不为null

修正后的连接逻辑示例：

private fun connectToCamera(device: UsbDevice) {
    val usbManager = getSystemService(Context.USB_SERVICE) as UsbManager
    val connection = usbManager.openDevice(device) ?: run {
        Toast.makeText(this, "无法打开USB设备", Toast.LENGTH_SHORT).show()
        return
    }
    val intf = device.getInterface(0) ?: return
    val endpoint = intf.getEndpoint(0) ?: return
    // 确保权限已授予后再调用claimInterface
    if (connection.claimInterface(intf, true)) {
        Log.i("serial", "接口获取成功")
        // 后续数据读取逻辑
    } else {
        Log.i("serial", "接口获取失败")
        connection.close()
    }
}

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