使用PendingIntent的BLE扫描在三星设备上无法工作的问题

你的问题主要出在广播接收器的IntentFilter配置错误，以及三星Android O设备对BLE扫描的特殊限制，另外接收器类名的写法也有坑，我来一步步帮你理清：

1. 修复接收器的IntentFilter配置 #

你在Manifest里给BleReceiver加的<intent-filter>完全错了：

<intent-filter>
    <action android:name="BluetoothDevice.ACTION_FOUND" />
    <action android:name="BluetoothDevice.EXTRA_UUID" />
    <action android:name="BluetoothDevice.EXTRA_RSSI" />
</intent-filter>

BluetoothDevice.EXTRA_UUID和BluetoothDevice.EXTRA_RSSI是Intent中携带的额外数据键，不是广播的Action！正确的做法是：

• 如果你用startScan的PendingIntent方式，系统会发送带有BluetoothDevice.ACTION_FOUND Action的广播，但因为你是通过PendingIntent指定了具体的接收器类，其实可以完全去掉<intent-filter>（显式广播不需要过滤器）；
• 如果保留过滤器，只需要保留BluetoothDevice.ACTION_FOUND这一个Action即可，多余的Action会导致三星设备无法匹配到广播。

修改后的接收器配置：

<receiver android:name="com.testapp.samsungoscan.BleReceiver" />
<!-- 或者保留正确的filter -->
<receiver android:name="com.testapp.samsungoscan.BleReceiver" >
    <intent-filter>
        <action android:name="android.bluetooth.device.action.FOUND" />
        <!-- 也可以用常量BluetoothDevice.ACTION_FOUND对应的字符串值 -->
    </intent-filter>
</receiver>

2. 三星Android O设备的BLE扫描额外要求 #

Android O（API 26）开始对后台扫描有严格限制，三星设备在这方面的限制可能更严格：

• 确保你的应用已经获得ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION权限，并且位置服务已经打开（三星设备可能强制要求位置服务开启才能扫描BLE设备）；
• 检查startScan的返回值：你已经打印了startScan == 0，如果返回值不是0，说明扫描启动失败，可以根据返回码查错误原因（比如SCAN_FAILED_ALREADY_STARTED、SCAN_FAILED_APPLICATION_REGISTRATION_FAILED等）；
• 尝试使用ScanSettings指定扫描模式，比如ScanSettings.SCAN_MODE_LOW_LATENCY，三星设备可能需要明确指定扫描模式才能正常工作：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val settings = ScanSettings.Builder()
        .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY)
        .build()
    val startScanResult = bleScanner.startScan(null, settings, getPendingIntent())
    Log.d("testApp", "Start scan result: $startScanResult")
}

3. 接收器类名写法的坑 #

你提到把接收器的android:name改成相对路径.BleReceiver时Nexus失效，索尼正常，这是因为：

• 当你用相对路径时，系统会把Manifest的package属性作为前缀拼接成完整类名；
• 如果你的BleReceiver所在的包和Manifest的package不一致，就会找不到类；
• 索尼设备可能对类名解析有容错，但Nexus（原生Android）严格遵循规范，所以必须保证类名写法正确：要么用完整的全类名（比如com.testapp.samsungoscan.BleReceiver），要么用相对路径且类所在包是Manifestpackage的子包。

最后验证步骤 #

1. 先修复Manifest中接收器的IntentFilter，去掉错误的Action；
2. 在三星设备上打开位置服务，确认应用已经获得位置权限；
3. 启动扫描后，查看startScan的返回值，如果是0说明启动成功，再检查接收器的onReceive是否被调用；
4. 如果还是不行，可以尝试用startScan的回调方式（ScanCallback）代替PendingIntent，看看是否能收到扫描结果，以此排除是PendingIntent的问题还是扫描本身的问题。

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