BleClient 类 BleClient 是 SDK 的核心类，提供了与 BLE 设备交互的所有功能。 主要方法 start\_eeg\_stream(user\_callback, raw\_data\_only=False) - 启动EEG数据流 start\_imu\_stream(user\_callback, raw\_data\_only=False) - 启动IMU数据流 start\_impedance\_stream(user\_callback, raw\_data\_only=False) - 启动阻抗数据流 start\_lead\_stream(user\_callback, raw\_data\_only=False) - 启动导联状态流 start\_battery\_stream(user\_callback) - 启动电池数据流 start\_mixed\_stream(mode, user\_callback, raw\_main\_data\_only=False) - 启动混合数据流 原始数据模式 所有数据流方法都支持 raw\_data\_only 参数： raw\_data\_only=False（默认）：回调函数接收解析后的字典数据 raw\_data\_only=True：回调函数接收去除帧头帧尾的原始 bytearray 数据 混合数据流使用 raw\_main\_data\_only 参数控制所有数据类型的输出格式。 异常类 所有异常继承自基础的 BleError 类： ConnectionError - 连接失败时抛出。 DisconnectionError - 断开连接失败时抛出。 NotificationError - 启用或停止通知失败时抛出。 DeviceNotFoundError - 未找到指定地址的设备时抛出。 WriteError - 写入特性失败时抛出。 最佳实践 1. 使用异步上下文管理器：始终使用 async with 来确保正确的资源释放。这可以保证在操作完成或发生错误时，BleClient 实例能够正确地断开连接并清理资源； 2. 实现高效的回调函数：确保回调函数是异步的，并能高效地处理数据，避免阻塞主事件循环。对于原始数据模式，注意数据类型判断； 3. 适当处理异常：通过使用 try-except 块，可以优雅地处理连接失败、通知错误或设备未找到等情况，从而提高应用程序的健壮性； 4. 使用日志记录：集成一个成熟的日志系统（如 Python loguru），记录关键操作（连接尝试、通知启用/停止、数据接收、错误）的详细信息，这对于调试和监控至关重要； 5. 选择合适的数据模式； 6. 使用解析模式（默认）进行常规数据分析； 7. 使用原始数据模式进行自定义数据处理或性能优化； 8. 混合模式适用于需要多种数据类型同步采集的场景； 9. 日志内容和函数docstring用英文：保持代码注释和文档的语言一致性，有助于国际化合作和提高可读性。