Android 10下Nearby服务权限申请问题及弹窗优化诉求

针对你遇到的两个核心问题——权限验证仍报错、权限弹窗出现无关的麦克风描述，我来一步步帮你梳理解决方案：

一、正确申请Nearby BLE功能所需权限 #

在Android 10（API 29）中，使用Nearby的BLE功能权限要求比旧版本更严格，仅申请ACCESS_FINE_LOCATION不足以满足需求，需要完成以下配置：

1. 清单文件声明必要权限 #

在AndroidManifest.xml中补充完整权限声明：

<!-- 蓝牙基础操作权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!-- 精确定位权限（BLE扫描必须依赖） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 10+ 后台位置权限（若需后台接收iBeacon信号则必须） -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 声明应用依赖BLE硬件 -->
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

2. 动态申请权限（按顺序请求） #

Android 10中，ACCESS_FINE_LOCATION（前台位置）和ACCESS_BACKGROUND_LOCATION（后台位置）需分步骤动态申请，不能一次性请求。示例代码如下：

private static final int REQUEST_FINE_LOCATION = 100;
private static final int REQUEST_BACKGROUND_LOCATION = 101;

// 启动前校验权限
private void checkPermissionsBeforeNearby() {
    // 先检查前台位置权限
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                REQUEST_FINE_LOCATION);
    } else {
        // 前台权限已授予，再检查后台位置权限（仅Android 10+需要）
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            checkBackgroundLocationPermission();
        } else {
            // 低版本直接初始化Nearby服务
            initNearbyService();
        }
    }
}

// 检查并请求后台位置权限
private void checkBackgroundLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_BACKGROUND_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION},
                REQUEST_BACKGROUND_LOCATION);
    } else {
        initNearbyService();
    }
}

// 权限申请结果回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_FINE_LOCATION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                checkBackgroundLocationPermission();
            } else {
                initNearbyService();
            }
        } else {
            Toast.makeText(this, "需要开启位置权限才能使用iBeacon功能", Toast.LENGTH_SHORT).show();
        }
    } else if (requestCode == REQUEST_BACKGROUND_LOCATION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            initNearbyService();
        } else {
            Toast.makeText(this, "后台位置权限未开启，后台将无法接收iBeacon信号", Toast.LENGTH_SHORT).show();
        }
    }
}

// 初始化你的Nearby服务
private void initNearbyService() {
    // 你的原有代码
    Nearby.getMessagesClient(this, new MessagesOptions.Builder()
                    .setPermissions(NearbyPermissions.BLE)
                    .build())
            .subscribe(getNearbyPendingIntent(), options);
}

关键提醒 #

• Android 10强制要求后台位置权限单独请求，必须在用户先授予前台位置权限后再发起，否则系统会直接拒绝申请。
• 如果你的应用仅在前台使用iBeacon功能，可以省略ACCESS_BACKGROUND_LOCATION的申请，但要注意后台时Nearby服务会停止工作。

二、移除权限弹窗中的麦克风描述 #

权限弹窗出现麦克风描述，是因为Nearby Messages库默认在清单中声明了RECORD_AUDIO权限（用于音频配对功能），但你已经指定了仅使用BLE权限，完全可以移除这个无关权限。

在AndroidManifest.xml中添加以下代码即可：

<!-- 移除Nearby库自带的RECORD_AUDIO权限，避免弹窗显示麦克风相关描述 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" tools:node="remove" />

注意：修改清单后需要卸载旧版本应用重新安装，才能让权限变更生效。

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