Flutter小米体脂秤数据交互插件xiaomi_scale的使用

Flutter小米体脂秤数据交互插件xiaomi_scale的使用

简介

<xiaomi_scale> 是一个用于从小米体重秤获取测量数据的Flutter插件。

功能

• 跟踪测量

  • 重量
  • 设备重量单位（公斤/磅）
  • 阻抗
  • 进度（例如：测量中 -> 稳定 -> 完成）

• 扫描附近的小米体重秤

• 直接获取秤的数据

  • 重量
  • 设备重量单位
  • 设备时间戳
  • 阻抗
  • 标志
    • 重量稳定
    • 重量移除
    • 测量完成

• 根据阻抗计算身体数据

  • 体脂肪
  • 内脏脂肪
  • 骨骼质量
  • 水分
  • 肌肉质量
  • BMI
  • LBM系数

注意：这些值是通过反向工程函数计算得出的。虽然它们应该与小米官方应用读取的结果相似，但其准确性不能保证，仅供参考。

不支持的功能

• 同步设备上存储的历史数据
• 配置设备设置

支持的设备

图像	名称
	小米体脂秤2

目前还在寻找支持小米体脂秤1（顶部没有四个电极的那个）。由于我只有v2型号，无法进行测试。如果有v1型号并且愿意帮忙测试的朋友，请联系我！

如何使用

首先，建议先查看示例代码。

iOS 设置

最小iOS开发目标版本 => 11 这是因为使用了flutter_reactive_ble

在info.plist文件中添加蓝牙外设使用的描述 iOS13及以上版本：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>连接小米体重秤以获取体重数据</string>

iOS12及以下版本：

<key>NSBluetoothPeripheralUsageDescription</key>
<string>连接小米体重秤以获取体重数据</string>

无需请求运行时权限，这已经由flutter_reactive_ble处理。 最佳实践： 你应该检查权限是否已授予。如果没有，向用户显示消息。你只能请求一次权限。之后应自行检查权限状态。（这不由此插件或flutter_reactive_ble处理）

Android 设置

最小SDK开发目标版本 => 24 这是因为使用了flutter_reactive_ble

flutter_reactive_ble会自动添加以下权限：

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

在运行时，你应该自己请求位置权限。否则应用程序将无法工作。

Dart 设置

对于下面的示例，首先获取MiScale实例。

MiScale _mi = MiScale.instance;

跟踪测量

你可以按如下方式跟踪测量：

StreamSubscription subscription = 
    _mi.takeMeasurements().listen((MiScaleMeasurement measurement) {
  // 处理测量数据的代码
});

// 停止跟踪测量
subscription.cancel();

取消测量

必须在开始新的测量之前取消当前测量。当测量到达最终的MEASURED阶段时，测量会自动取消。

如果你希望在STABILIZED阶段之前取消测量，必须手动取消测量。

_mi.cancelMeasurement(deviceId);

你可以从MiScaleMeasurement或MiScaleDevice实例中获取deviceId。

注意：如果用户在STABILIZED阶段之前离开秤，测量将不完整。因此，如果你想进行新的测量，也必须先取消不完整的测量。

扫描设备

discoverDevices流只会输出它找到的兼容设备。

StreamSubscription subscription = _mi.discoverDevices(
  duration: Duration(seconds: 10), // 可选，默认为5秒
).listen(
  (MiScaleDevice device) {
    // 处理发现设备的代码
  },
);

// 在给定的持续时间内停止发现
subscription?.cancel();

获取所有秤数据

如果你希望直接获取秤的数据而不跟踪测量，可以这样做：

StreamSubscription subscription = _mi.readScaleData().listen(
      (data) {
        // 处理秤数据的代码
      },
    );

// 停止读取数据
subscription.cancel();

如何调整ProGuard（Android）

如果你使用ProGuard，在你的proguard-rules.pro文件中添加以下片段：

-keep class com.signify.hue.** { *; }

示例代码

示例代码

import 'package:flutter/material.dart';
import 'package:xiaomi_scale_example/measurement_pane.dart';
import 'package:xiaomi_scale_example/raw_data_pane.dart';
import 'package:xiaomi_scale_example/scanning_pane.dart';

void main() {
  runApp(ScaleApp());
}

class ScaleApp extends StatefulWidget {
  [@override](/user/override)
  _ScaleAppState createState() => _ScaleAppState();
}

class _ScaleAppState extends State<ScaleApp> {
  var _currentIndex = 0;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Scale Example App'),
        ),
        body: IndexedStack(
          index: _currentIndex,
          children: [
            MeasurementPane(),
            ScanningPane(),
            RawDataPane(),
          ],
        ),
        bottomNavigationBar: BottomNavigationBar(
          currentIndex: _currentIndex,
          onTap: _bottomTapped,
          selectedItemColor: Colors.black,
          unselectedItemColor: Colors.black26,
          items: const [
            BottomNavigationBarItem(
              icon: Icon(Icons.timeline),
              label: 'Measurements',
            ),
            BottomNavigationBarItem(
              icon: Icon(Icons.search),
              label: 'Scanning',
            ),
            BottomNavigationBarItem(
              icon: Icon(Icons.description),
              label: 'Raw Data',
            ),
          ],
        ),
      ),
    );
  }

  void _bottomTapped(int index) => setState(() => _currentIndex = index);
}