非推奨のonCharacteristicReadに対応する

この記事はAndroidスマホ用のアプリ開発の中で、
今後の開発で再使用性が高いと思われるコーディングをまとめたものです。
Javaの開発経験、XML構文規則、Androidのアプリ開発経験がある方を対象としています。
Androidのアプリ開発でお役にたててれば、嬉しいです。
（これからAndroidのアプリ開発やJavaでの開発を始めたい方への案内は、記事の最後で紹介します）

この記事のテーマ

Android13で非推奨になったonCharacteristicReadに対応する

リンク

ポイント
BluetoothGattCallback(onCharacteristicRead)
1. Android12までの実装
2. Android13以降の実装
これからAndroidのアプリ開発やJavaでの開発を始めたい方へ

ポイント

BLEのGATT通信でキャラクタリスティックが読み込まれたときのコールバックonCharacteristicReadですが、Andorid13で非推奨となりました。
今回は、非推奨になったonCharacteristicReadをAndroid13以降に対応する実装を紹介します。

BluetoothGattCallback(onCharacteristicRead)

BluetoothGattCallback | API reference | Android Developers

BluetoothGattCallback(onCharacteristicRead)

BluetoothGatt.readCharacteristicで指定したBluetoothGattCharacteristicの読み込みはBluetoothGattCallbackのonCharacteristicReadで値を取得します。
Android13以降では、onCharacteristicReadで値を直接取得できるよう、引数が追加されました。

Android12までの実装

BluetoothGattCharacteristic.getValueで値を取得します。

    private BluetoothLowEnergyController.gattResponse   gattResponse;
    public interface gattResponse {
        void response(byte[] data);
    }
    :
        @Override
        public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status ) {
            if (status == BluetoothGatt.GATT_SUCCESS) {
                if (characteristic.getUuid().equals(UUID_READ)) {
                    byte[] data = characteristic.getValue();
                    gattResponse.response(data);
                    return;
                }
            }
            gattResponse.response(new byte[]{});
        }
    :

Android13以降の実装

onCharacteristicReadに追加されたbyte[]を取得する値として処理します。
Android112以下に対応する場合、Build.VERSION.SDK_INTで分岐させて、それぞれ処理します。

    private BluetoothLowEnergyController.gattResponse   gattResponse;
    public interface gattResponse {
        void response(byte[] data);
    }
    :
        @Override
        public void onCharacteristicRead(@NonNull BluetoothGatt gatt, @NonNull BluetoothGattCharacteristic characteristic, @NonNull byte[] data, int status) {
            if (status == BluetoothGatt.GATT_SUCCESS) {
                if (characteristic.getUuid().equals(UUID_READ)) {
                    gattResponse.response(data);
                    return;
                }
            }
            gattResponse.response(new byte[]{});
        }
        @SuppressWarnings("deprecation")
        @Override
        public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status ) {
            if (status == BluetoothGatt.GATT_SUCCESS) {
                if (characteristic.getUuid().equals(UUID_READ)) {
                    byte[] data = characteristic.getValue();
                    gattResponse.response(data);
                    return;
                }
            }
            gattResponse.response(new byte[]{});
        }
    :

今回は、ここまでです。

非推奨のonCharacteristicReadに対応しているAndroidアプリです。