Android设备不支持Bluetooth Advertisements问题求助

1. 确认设备硬件支持BLE Peripheral模式 #

蓝牙低功耗（BLE）广播功能要求设备支持BLE Peripheral角色，很多旧机型或中低端设备仅支持Central角色（只能扫描无法广播）。你可以通过以下代码直接检测：

BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
boolean isLeSupported = bluetoothAdapter != null && getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE);
boolean isAdvertisingSupported = bluetoothAdapter != null && bluetoothAdapter.getBluetoothLeAdvertiser() != null;

如果isAdvertisingSupported返回false，说明硬件或系统不支持广播功能，只能更换设备测试。

2. 修正Manifest配置 #

检查你的AndroidManifest.xml是否满足以下要求：

• 必须声明BLE硬件特性：

  <uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />
  

• 根据系统版本配置对应权限：
  • Android 12+（API 31及以上）：

    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    

  • Android 6.0-11（API 23-30）：

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    

  • Android 5.x（API 21-22）：

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

3. 确保动态权限已申请 #

• Android 6.0及以上，必须在代码中动态申请位置权限；Android 12+还需动态申请BLUETOOTH_ADVERTISE和BLUETOOTH_CONNECT权限。示例代码：

  // Android 12+权限申请
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
      requestPermissions(new String[]{
              Manifest.permission.BLUETOOTH_ADVERTISE,
              Manifest.permission.BLUETOOTH_CONNECT,
              Manifest.permission.ACCESS_FINE_LOCATION
      }, REQUEST_CODE_PERMISSIONS);
  } else {
      // 低版本权限申请
      requestPermissions(new String[]{
              Manifest.permission.ACCESS_FINE_LOCATION,
              Manifest.permission.BLUETOOTH_ADMIN,
              Manifest.permission.BLUETOOTH
      }, REQUEST_CODE_PERMISSIONS);
  }
  

  只有权限申请通过后，才能正常调用BLE广播相关API。

4. 检查蓝牙状态 #

确保设备蓝牙已开启，可通过代码检测并引导用户开启：

if (bluetoothAdapter != null && !bluetoothAdapter.isEnabled()) {
    Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
    startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}

5. 排除ROM阉割问题 #

部分定制ROM（如部分旧款小米、华为机型）可能阉割了BLE Peripheral功能，即使硬件支持也无法使用。这种情况下只能更换其他设备测试。

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