Android BLE开发疑问：如何触发特征值读取、通知及写入文件？

Hey there! Let's break this down step by step since you're working off the BluetoothLeGatt sample and need to get up to speed quickly. I've been in your shoes before, so I know how frustrating the vague docs can be.

1. How to Trigger Characteristic Reads #

Reading a characteristic doesn't happen automatically—you need to explicitly call it once you have a reference to the target BluetoothGattCharacteristic. Here's how:

First, make sure you've discovered the services and characteristics of your Arduino device (the sample should handle this via discoverServices()). Once you have the characteristic you want to read:

// Replace with your actual characteristic instance
BluetoothGattCharacteristic targetChar = ...;
mBluetoothGatt.readCharacteristic(targetChar);

This call will trigger the onCharacteristicRead() callback in your BluetoothGattCallback implementation. The sample uses broadcastUpdate() here to send the read data to your UI layer via a local broadcast—you can reuse that pattern to pass the data where you need it.

2. Setting Up Notifications for Real-Time Data #

Notifications are for when your Arduino sends data to Android automatically (without Android asking first). To enable this, you need two key steps:

Step 1: Configure the Client Characteristic Descriptor

Most BLE devices use the standard CLIENT_CHARACTERISTIC_CONFIG descriptor to enable notifications. You need to write to this descriptor first:

BluetoothGattDescriptor descriptor = targetChar.getDescriptor(
        UUID.fromString("00002902-0000-1000-8000-00805f9b34fb")); // Standard UUID for config
descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
mBluetoothGatt.writeDescriptor(descriptor);

Step 2: Enable Notifications on the Characteristic

Right after writing the descriptor, call:

mBluetoothGatt.setCharacteristicNotification(targetChar, true);

Once this is set up, whenever your Arduino sends new data to that characteristic, Android will trigger onCharacteristicChanged() in your callback. Again, use broadcastUpdate() to pass this data to your UI or file-writing logic.

3. Writing BLE Data to a File #

Once you're receiving data (either from reads or notifications), you can write it to a file using standard Android I/O. Here's a simple implementation:

First, register a local broadcast receiver in your Activity/Fragment to catch the data from broadcastUpdate():

private BroadcastReceiver mGattDataReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (BluetoothLeService.ACTION_DATA_AVAILABLE.equals(intent.getAction())) {
            byte[] rawData = intent.getByteArrayExtra(BluetoothLeService.EXTRA_DATA);
            if (rawData != null) {
                writeDataToFile(rawData);
            }
        }
    }
};

// Register/unregister the receiver in onResume/onPause
@Override
protected void onResume() {
    super.onResume();
    LocalBroadcastManager.getInstance(this).registerReceiver(
            mGattDataReceiver, makeGattIntentFilter());
}

@Override
protected void onPause() {
    super.onPause();
    LocalBroadcastManager.getInstance(this).unregisterReceiver(mGattDataReceiver);
}

private IntentFilter makeGattIntentFilter() {
    IntentFilter filter = new IntentFilter();
    filter.addAction(BluetoothLeService.ACTION_DATA_AVAILABLE);
    // Add other actions if needed (e.g., connection status changes)
    return filter;
}

Then implement the file-writing method. For internal storage (no permissions needed):

private void writeDataToFile(byte[] data) {
    File dataFile = new File(getFilesDir(), "ble_sensor_data.txt");
    try (FileOutputStream fos = new FileOutputStream(dataFile, true)) {
        // Append the new data plus a newline for readability
        fos.write(data);
        fos.write("\n".getBytes(StandardCharsets.UTF_8));
    } catch (IOException e) {
        // Handle error (e.g., show a Toast, log the issue)
        Log.e("BLE_FILE", "Failed to write data: " + e.getMessage());
        Toast.makeText(this, "Failed to save data", Toast.LENGTH_SHORT).show();
    }
}

If you want to write to external storage, you'll need to request the WRITE_EXTERNAL_STORAGE permission (for Android 10 and below; Android 11+ uses scoped storage, but that's a bit more complex).

Quick Troubleshooting Tips #

• Double-check UUIDs: Make sure the service and characteristic UUIDs in your Android code match exactly what your Arduino BLE peripheral is advertising.
• Verify Arduino BLE Settings: Ensure your Arduino's characteristic has the NOTIFY or READ property enabled—if not, Android won't be able to read or receive notifications from it.
• Check Callback Errors: Look at onCharacteristicRead() and onDescriptorWrite() return statuses (the status parameter) to see if operations are failing (e.g., BluetoothGatt.GATT_SUCCESS means success).

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