Central_hr_coded example

### Android 中 PHY_LE_CODED 配置与使用 在蓝牙低功耗 (Bluetooth Low Energy, BLE) 技术中，PHY_LE_CODED 是一种物理层编码方式，旨在提高远距离通信的可靠性。对于 Android 设备而言，在 API Level 28 及以上版本支持此功能。 #### 支持条件 为了确保设备能够正常启用并使用 `PHY_LE_CODED` 编码模式，需满足以下两个前提条件之一[^1]: - 设备运行的是 Android P(API level 28) 或更高版本； - 应用程序已获得 `ACCESS_FINE_LOCATION` 权限，并且启用了位置服务。 #### 获取当前使用的 PHY 类型 应用程序可以通过调用 `getPhy()` 方法来查询连接状态下所采用的具体 PHY 类型。该方法返回一个包含 TX 和 RX 物理信道类型的对象实例。 ```java // 假设 bleGatt 已经建立好了一个有效的 GATT 连接 bleGatt.getPhy(); ``` #### 设置期望的 PHY 参数 通过调用 `setPreferredPhy(int txPhy, int rxPhy, int phyOptions)` 函数可以指定希望使用的发射端(TX)和接收端(RX)物理层参数以及选项位掩码。当设置为 `PHY_LE_CODED` 时，则表示请求开启 Coded PHY 模式。 ```java if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { bluetoothGatt.setPreferredPhy( BluetoothDevice.PHY_LE_1M_MASK | BluetoothDevice.PHY_LE_CODED_MASK, BluetoothDevice.PHY_LE_1M_MASK | BluetoothDevice.PHY_LE_CODED_MASK, BluetoothDevice.PHY_OPTION_NO_PREFERRED); } ``` 上述代码片段展示了如何同时尝试配置 1Mbit/s 和 Coded 的双模工作状态。如果硬件不支持其中任何一个选项，则会自动选择最接近的一个替代方案。 #### 处理回调事件 每当发生任何关于 PHY 层面的变化时，都会触发相应的广播意图或接口回调函数。开发者应该监听这些变化以便及时作出响应处理。 ```java @Override public void onPhyUpdate(BluetoothGatt gatt, int txPhy, int rxPhy, int status){ super.onPhyUpdate(gatt,txPhy,rxPhy,status); Log.d(TAG,"TX Phy:"+translatePhy(txPhy)+",RX Phy:"+translatePhy(rxPhy)); } private String translatePhy(int phyType){ switch(phyType){ case BluetoothDevice.PHY_LE_1M: return "LE 1M"; case BluetoothDevice.PHY_LE_2M: return "LE 2M"; case BluetoothDevice.PHY_LE_CODED: return "LE CODED"; default: return "Unknown"; } } ``` 这段 Java 代码实现了对不同 PHY 类型名称转换的功能，并记录日志信息用于调试目的。