Android 10及以上版本USB设备插拔后权限留存与设备识别的解决方案咨询

阿华AIGC实验室

2026-4-27

解决Android 10+ USB设备重连时重复权限请求的方案

我在开发USB相关应用时也遇到过和你一模一样的问题，尤其是OTG设备频繁插拔的时候，每次弹权限框确实太影响用户体验了。结合官方文档和实际项目经验，整理了几个可行的解决方案，你可以根据自己的应用场景来选择：

方案一：配置USB意图过滤器+设置应用为首选客户端

这是官方推荐的标准流程，能从根源上解决重复弹窗的问题。

在Manifest中配置USB设备过滤
在你的AndroidManifest.xml里添加针对目标USB设备的意图过滤器和元数据，让系统识别到你的应用支持该设备：

<activity android:name=".UsbDeviceActivity">
    <intent-filter>
        <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    </intent-filter>
    <meta-data
        android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
        android:resource="@xml/usb_device_filter" />
</activity>

然后在res/xml目录下创建usb_device_filter.xml，填写你要适配的设备VID（厂商ID）和PID（产品ID）：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <usb-device vendor-id="1234" product-id="5678" />
    <!-- 可添加多个设备条目 -->
</resources>

请求成为设备的首选客户端
当用户第一次授予权限后，调用UsbManager.setPreferredDevice方法，把当前设备设为应用的首选设备。后续设备插拔时，系统会自动授予权限，不再弹出对话框：

UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE);
UsbDevice targetDevice = ...; // 已获取到的目标USB设备

if (usbManager.hasPermission(targetDevice)) {
    // 直接设置为首选设备
    usbManager.setPreferredDevice(targetDevice);
} else {
    // 先请求权限，在权限回调中设置首选
    PendingIntent permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent("com.your.app.USB_PERMISSION"), 0);
    usbManager.requestPermission(targetDevice, permissionIntent);
}

注意：如果有多个应用都配置了同一设备的过滤器，用户需要首次选择一次首选应用，之后就无需重复操作了。

方案二：使用Android 11+的MANAGE_USB权限

如果你的应用面向Android 11（API 30）及以上版本，且属于系统级或用户高度信任的应用，可以申请MANAGE_USB权限——这是应用级权限，不需要为单个设备重复请求权限。

在Manifest中添加权限

<uses-permission android:name="android.permission.MANAGE_USB" />

引导用户手动授予权限
该权限无法通过代码直接请求，需要引导用户到应用设置页面开启：
```
Intent intent = new Intent(Settings.ACTION_APP_USAGE_SETTINGS);
intent.setData(Uri.parse("package:" + getPackageName()));
startActivity(intent);
```
一旦开启，应用就能直接访问所有USB设备，无需再弹权限框。缺点是需要用户手动跳转设置，适合企业级、定制化场景。

方案三：自定义设备标识（替代SerialNumber）

如果无法获取SerialNumber或不想依赖权限，可以结合设备的固定属性做唯一标识：

VID + PID组合：大部分USB设备的厂商ID（VID）和产品ID（PID）是固定的，若场景中同类型设备只有一个，用device.getVendorId()+device.getProductId()即可唯一识别。
扩展描述符组合：若有多个同类型设备，可读取设备的制造商名称、产品名称等固定描述符，和VID+PID组合做标识。
缓存已授权设备信息：首次获取到SerialNumber后，将其与VID+PID一起保存到SharedPreferences。后续设备连接时，先通过VID+PID匹配，再对比缓存的SerialNumber（若能获取），即可识别同一设备。

方案四：前台服务持久化权限

Android 10+对后台应用权限限制严格，使用前台服务可让应用更稳定地持有USB权限，避免后台被杀死导致权限丢失：

创建前台服务
继承Service类，在onCreate中注册USB广播接收器并启动前台通知：

public class UsbForegroundService extends Service {
    private static final int NOTIFICATION_ID = 1001;
    private BroadcastReceiver usbReceiver;

    @Override
    public void onCreate() {
        super.onCreate();
        // 注册USB广播监听
        IntentFilter filter = new IntentFilter();
        filter.addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED);
        filter.addAction(UsbManager.ACTION_USB_DEVICE_DETACHED);
        usbReceiver = new UsbBroadcastReceiver();
        registerReceiver(usbReceiver, filter);
        // 启动前台通知
        Notification notification = new NotificationCompat.Builder(this, "usb_service_channel")
                .setContentTitle("USB设备服务")
                .setContentText("正在监听USB连接")
                .setSmallIcon(R.drawable.ic_usb)
                .build();
        startForeground(NOTIFICATION_ID, notification);
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        return START_STICKY;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        unregisterReceiver(usbReceiver);
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}