# ppscale-android-demo

**Repository Path**: ppscale/ppscale-android-demo

## Basic Information

- **Project Name**: ppscale-android-demo
- **Description**: LF相关蓝牙体脂秤、WiFi体脂秤调用示例-Android
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: ppscale
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 22
- **Forks**: 9
- **Created**: 2020-08-26
- **Last Updated**: 2025-08-12

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

[English Docs](README_EN.md)  |  [中文文档](README.md)

## 相关文档

[乐福开放平台](https://uniquehealth.lefuenergy.com/unique-open-web/#/document)  |
[PPBluetoothKit iOS SDK](https://uniquehealth.lefuenergy.com/unique-open-web/#/document?url=https://lefuhengqi.apifox.cn/doc-2625647)  |
[PPBluetoothKit 微信小程序插件](https://uniquehealth.lefuenergy.com/unique-open-web/#/document?url=https://lefuhengqi.apifox.cn/doc-2625745)

# PPBluetoothKit Android SDK

[Android示例程序地址](https://gitee.com/shenzhen-lfscale/bluetooth-kit-android-demo.git)

## -LF蓝牙秤/食物秤/WiFi秤

PPBluetoothKit是一个包含蓝牙连接逻辑以及数据解析逻辑的集成化SDK。 
为了让客户快速实现称重以及对应的功能而实现，包含示例程序，示例程序中包含体脂计算模块和设备功能模块。
设备功能模块目前支持的设备包含：蓝牙秤、食物秤、Torre系列蓝牙WiFi体脂秤。
体脂计算模块支持4电极交流算法、4电极直流算法、8电极交流算法。
在开发者集成的时候，需要采用从引入aar的方式集成。建议开发者查看README.md文档，完成集成。

### Ⅰ. 集成方式

#### sdk引入方式

在需要引入sdk的module下的build.gradle中加入(最新版本请查看ppscalelib的module下的libs)

    dependencies {
        //aar引入
        api fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    }

### Ⅱ .使用说明

### 1.1 蓝牙权限相关

#### 1.1.1 运行环境

由于需要蓝牙连接，Demo需要真机运行，Android手机6.0及以上或HarmonyOS2.0及以上

#### 1.1.2 蓝牙权限相关约定

使用Demo过程中需要您打开蓝牙，打开定位开关，需确保开启和授权相关必要的权限

##### 1.1.2.1 在Android 6.0-12.0以下系统版本，在启动扫描前，需确保开启和授权相关必要的权限
1、定位权限
2、定位开关  
3、蓝牙开关

##### 1.1.2.2 Android 12及以上系统版本，在启动扫描前，需确保开启和授权相关必要的权限
可以查看官方蓝牙权限文档，文档地址：[Google开发者网站关于Bluetooth permissions说明](https://developer.android.com/guide/topics/connectivity/bluetooth/permissions).
1、附近的设备权限
2、蓝牙开关

    <manifest>
        <uses-permission android:name="android.permission.BLUETOOTH"
            android:maxSdkVersion="30" />
        <uses-permission
            android:name="android.permission.BLUETOOTH_ADMIN"
            android:maxSdkVersion="30" />
        <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
            android:usesPermissionFlags="neverForLocation"
            tools:targetApi="s" />
        <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
        <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
       ...
    </manifest>

##### 1.1.2.3 Android 14版本兼容请更新最新版本SDK

最新版本地址：https://gitee.com/ppscale/ppscale-android-demo/blob/ppscale/ppscalelib/libs

#### 1.1.3 测量身体数据相关约定

如果需要体重值以外的体脂信息需要输入身高、年龄、性别并且光脚上秤。

### 1.2 主页功能说明

#### 1.2.1 oldVersionSDK

[Old Version SDK English Docs](doc/README_old_version_en.md)  |  [Old Version SDK 中文文档](doc/README_old_version.md)

#### 1.2.2 Caclulate - CalculateManagerActivity

根据蓝牙协议解析出的体重、阻抗，加上用户数据的身高、年龄、性别，计算出体脂率等多项体脂参数信息。

##### 1.2.2.1 8电极交流体脂计算 - 8AC - Calculate8Activitiy

可输入的内容:

    身高的取值范围：30-220厘米；
    年龄的取值范围：10-99岁；
    性别 1代表男，0代表女；
    体重：可输入0-220kg
    10个身体各个部位的阻抗值：请根据秤返回的阻抗进行输入

PPUserModel参数说明：

    userHeight、age、sex必须是真实的 
    userHeight范围是100-220cm
    age年龄 范围是10-99
    sex 性别 0为女 1为男

PPDeviceModel参数配置：

    //8电极计算类型
    deviceModel.deviceCalcuteType = PPScaleDefine.PPDeviceCalcuteType.PPDeviceCalcuteTypeAlternate8

##### 1.2.2.2 4电极直流体脂计算 - 4DC - Calculate4DCActivitiy

可输入的内容:

    身高的取值范围：30-220厘米；
    年龄的取值范围：10-99岁；
    性别 1代表男，0代表女；
    体重：可输入0-220kg
    双脚阻抗值：请根据秤返回的阻抗进行输入

PPUserModel参数说明：

    userHeight、age、sex必须是真实的 
    userHeight范围是100-220cm
    age年龄 范围是10-99
    sex 性别 0为女 1为男

PPDeviceModel参数配置：

    //4电极直流计算类型
     deviceModel.setDeviceCalcuteType(PPScaleDefine.PPDeviceCalcuteType.PPDeviceCalcuteTypeDirect)

##### 1.2.2.3 4电极交流流体脂计算 - 4AC - Calculate4ACActivitiy

可输入的内容:

    身高的取值范围：30-220厘米；
    年龄的取值范围：10-99岁；
    性别 1代表男，0代表女；
    体重：可输入0-220kg
    双脚阻抗值：请根据秤返回的阻抗进行输入

PPUserModel参数说明：

    userHeight、age、sex必须是真实的 
    userHeight范围是100-220cm
    age年龄 范围是10-99
    sex 性别 0为女 1为男

PPDeviceModel参数配置：

    //4电极交流计算类型
    deviceModel.setDeviceCalcuteType(PPScaleDefine.PPDeviceCalcuteType.PPDeviceCalcuteTypeAlternate)

#### 1.2.3 Device 扫描周围支持的设备-ScanDeviceListActivity

扫描附近设备列表 - 附近体脂秤的列表，可以选则某个设备进行连接和其他功能使用示例

### Ⅲ .PPScale在蓝牙设备的使用

#### 1.1 PPScale初始化，以及基础约定

        //绑定设备和扫描设备的区别在于  searchType  0绑定设备 1扫描指定设备
        //setProtocalFilterImpl() 接收数据回调接口，过程数据、锁定数据、历史数据，
        //setDeviceList()函数的参数为不为空，绑定需传null(或不调用)，扫描指定设备请传指定设备的List<DeviceModel>。绑定
        //setBleOptions()蓝牙参数配置
        //setBleStateInterface() 需要参数PPBleStateInterface，蓝牙状态监控回调和系统蓝牙状态回调
        //startSearchBluetoothScaleWithMacAddressList（）启动扫描设备
        //setUserModel() 参数PPUserModel 正常情况， setUserModel()是必须的，
            
       /**
        * sdk入口,实例对象 
        */
       private void bindingDevice() {
               if (searchType == 0) {
                   ppScale = new PPScale.Builder(this)
                           .setProtocalFilterImpl(getProtocalFilter())
                           .setBleOptions(getBleOptions())
       //                    .setDeviceList(null)
                           .setBleStateInterface(bleStateInterface)
                           .setUserModel(userModel)
                           .build();
                   ppScale.startSearchBluetoothScaleWithMacAddressList();
               } else {
                   List<DeviceModel> deviceList = DBManager.manager().getDeviceList();
                   List<String> addressList = new ArrayList<>();
                   for (DeviceModel deviceModel : deviceList) {
                       addressList.add(deviceModel.getDeviceMac());
                   }
                   ppScale = new PPScale.Builder(this)
                           .setProtocalFilterImpl(getProtocalFilter())
                           .setBleOptions(getBleOptions())
                           .setDeviceList(addressList)
                           .setBleStateInterface(bleStateInterface)
                            .setUserModel(userModel) 参数PPUserModel 正常情况， setUserModel()是必须的，
                           .build();
                   ppScale.startSearchBluetoothScaleWithMacAddressList();
               }

注意：如果需要自动循环扫描，需要在lockedData()后重新调用

    ppScale.startSearchBluetoothScaleWithMacAddressList()

#### 1.2 体脂秤

##### 1.2.1 过程数据和锁定数据

    //根据需求实现接口
    //监听过程数据setPPProcessDateInterface()
    //监听锁定数据setPPLockDataInterface()
    //监听历史数据setPPHistoryDataInterface()
   
     ProtocalFilterImpl protocalFilter = new ProtocalFilterImpl();
     protocalFilter.setPPProcessDateInterface(new PPProcessDateInterface() {
    
        // 过程数据
        @Override
        public void monitorProcessData(PPBodyBaseModel bodyBaseModel, PPDeviceModel deviceModel) {
            Logger.d("bodyBaseModel scaleName " + bodyBaseModel);
            String weightStr = PPUtil.getWeight(bodyBaseModel.getUnit(), bodyBaseModel.getPpWeightKg(), deviceModel.deviceAccuracyType.getType());
            weightTextView.setText(weightStr);
        }
    });
    protocalFilter.setPPLockDataInterface(new PPLockDataInterface() {

        //锁定数据
        @Override
        public void monitorLockData(PPBodyFatModel bodyFatModel, PPDeviceModel deviceModel) {
            onDataLock(bodyFatModel, deviceModel);
        }

        @Override
        public void monitorOverWeight() {
            Logger.e("over weight ");
        }
    });

##### 1.2.2  历史数据

需要先使用“绑定设备”功能绑定对应的设备，然后再读取“历史数据”，具体参考：ReadHistoryListActivity.java
入口是在设备管理，选则一个设备，然后会有“读取历史数据”功能，使用前请确保你的秤支持历史数据

###### 1.2.2.1  读取历史数据

     //直接读取历史数据，需要传入要读取的秤
    private void bindingDevice() {
        List<DeviceModel> deviceList = DBManager.manager().getDeviceList();
        if (deviceList != null && !deviceList.isEmpty()) {
            List<String> addressList = new ArrayList<>();
            for (DeviceModel deviceModel : deviceList) {
                addressList.add(deviceModel.getDeviceMac());
            }
            ppScale = new PPScale.Builder(this)
                    .setProtocalFilterImpl(getProtocalFilter())
                    .setBleOptions(getBleOptions())
                    .setDeviceList(addressList)//注意：这里是必传项
                    .setUserModel(userModel)
                    .setBleStateInterface(bleStateInterface)
                    .build();  
            tv_starts.setText("开始读取离线数据");
            ppScale.fetchHistoryData();//读取历史数据
        } else {
            tv_starts.setText("请先绑定设备");
        }
    }

###### 1.2.2.2  历史数据回调

     final ProtocalFilterImpl protocalFilter = new ProtocalFilterImpl();
     protocalFilter.setPPHistoryDataInterface(new PPHistoryDataInterface() {
         @Override
         public void monitorHistoryData(PPBodyFatModel bodyFatModel, String dateTime) {
             if (bodyFatModel != null) {
                 Logger.d("ppScale_ " + " dateTime = " + dateTime + " bodyBaseModel weight kg = " + bodyFatModel.getPpWeightKg());
             }
             if (bodyFatModel != null) {
                 Logger.d("ppScale_ bodyFatModel = " + bodyFatModel.toString());

                 String weightStr = PPUtil.getWeight(bodyFatModel.getUnit(), bodyFatModel.getPpWeightKg(), bodyFatModel.getDeviceModel().deviceAccuracyType.getType());

                 DeviceModel bodyModel = new DeviceModel(bodyFatModel.getImpedance() + "", weightStr, -1);

                 deviceModels.add(bodyModel);
                 adapter.notifyDataSetChanged();
             }
         }

         @Override
         public void monitorHistoryEnd(PPDeviceModel deviceModel) {
             if (deviceModels == null || deviceModels.isEmpty()) {
                 tv_starts.setText("没有离线数据");
             } else {
                 tv_starts.setText("读取历史数据结束");
             }
             //历史数据结束，删除历史数据
        // deleteHistoryData();
         }

         @Override
         public void monitorHistoryFail() {

         }
     });

###### 1.2.2.3  删除历史数据

     //删除历史
     if (ppScale != null) {
         ppScale.deleteHistoryData();
     }

#### 1.3 食物秤

##### 1.3.1  接收和解析数据

    示例代码：FoodSclaeDeviceActivity.java
    final ProtocalFilterImpl protocalFilter = new ProtocalFilterImpl();
    protocalFilter.setFoodScaleDataProtocoInterface(new FoodScaleDataProtocoInterface() {
        @Override
        public void processData(LFFoodScaleGeneral foodScaleGeneral, PPDeviceModel deviceModel) {
            textView.setText("过程数据");
            extracted(foodScaleGeneral, deviceModel);
        }

        @Override
        public void lockedData(LFFoodScaleGeneral foodScaleGeneral, PPDeviceModel deviceModel) {
            textView.setText("锁定数据");
            extracted(foodScaleGeneral, deviceModel);
        }

        @Override
        public void historyData(LFFoodScaleGeneral foodScaleGeneral, PPDeviceModel deviceModel, String yyyyMMdd, boolean isEnd) {
            if (foodScaleGeneral != null && !isEnd) {
                String valueStr = getValue(foodScaleGeneral, deviceModel);
                historyDataText.append(valueStr + "\n");
            } else {
                historyDataText.append("history end");
            }
        }
    });

##### 1.3.2 单位转换示例：

    @NonNull
    private String getValue(final LFFoodScaleGeneral foodScaleGeneral, PPDeviceModel deviceModel) {
        String valueStr = "";

        float value = (float) foodScaleGeneral.getLfWeightKg();
        if (foodScaleGeneral.getThanZero() == 0) {
            value *= -1;
        }

        PPUnitType type = foodScaleGeneral.getUnit();

        if (deviceModel.deviceAccuracyType == PPScaleDefine.PPDeviceAccuracyType.PPDeviceAccuracyTypePoint01G) {
            //String num = String.valueOf(value);
            EnergyUnit unit = Energy.toG(value, type);
            String num = unit.format01();
            String unitText = unit.unitText(FoodSclaeDeviceActivity.this);
            valueStr = num + unitText;
        } else {
            EnergyUnit unit = Energy.toG(value, type);

            if (unit instanceof EnergyUnitLbOz) {
                String split = ":";
                String[] values = unit.format().split(split);
                String[] units = unit.unitText(FoodSclaeDeviceActivity.this).split(split);
                valueStr = values[0] + split + values[1] + units[0] + split + units[1];
            } else {
                String num = unit.format();
                String unitText = unit.unitText(FoodSclaeDeviceActivity.this);
                valueStr = num + unitText;
            }
        }
        return valueStr;
    }

##### 1.3.3 单位枚举类 PPUnitType

        Unit_KG(0),//KG 
        Unit_LB(1),//LB
        PPUnitST(2),//ST
        PPUnitJin(3),//斤
        PPUnitG(4),//g
        PPUnitLBOZ(5),//lb:oz
        PPUnitOZ(6),//oz
        PPUnitMLWater(7),//ml(water)
        PPUnitMLMilk(8);//milk

##### 1.3.4 正负值问题：

       PPBodyFatModel的字段里:
       int thanZero; //正负 0表示负值 1 正值

##### 1.3.5 切换单位调用：

        PPScale.changeKitchenScaleUnit(PPUnitType unitType)

##### 1.3.6 食物秤归零：

        PPScale.toZeroKitchenScale()

##### 1.3.7 使用食物秤在不需要连接时，需要手动断开连接

       PPScale.disConnect()

##### 1.3.8 单位精度

    enum class PPDeviceAccuracyType {
        PPDeviceAccuracyTypeUnknow(0),//未知精度
        //KG精度0.1
        PPDeviceAccuracyTypePoint01(1),
        //KG精度0.05
        PPDeviceAccuracyTypePoint005(2),
        // 1G精度
        PPDeviceAccuracyTypePointG(3),
        // 0.1G精度
        PPDeviceAccuracyTypePoint01G(4);
    }

##### 1.4  食物秤与体脂秤的区别

###### 1.4.1  接收数据的接口不一样

ProtocalFilterImpl中接收数据的监听器食物秤是FoodScaleDataProtocoInterface，体脂秤是由PPProcessDateInterface(过程数据)、PPLockDataInterface(锁定数据)。

###### 1.4.2  接收数据的重量单位不一样

体脂秤的重量值对应的单位是KG,食物秤的重量值对应的单位是g，重量值对应的单位是固定的。（这里的单位与PPScale给的单位不是同步的，PPScale给的单位是当前秤端的单位）

##### 1.4.3  食物秤与体脂秤的标识

     /**
      * 设备类型
      */
     enum class PPDeviceType {
         PPDeviceTypeUnknow(0),//未知
         PPDeviceTypeCF(1), //体脂秤
         PPDeviceTypeCE(2), //体重秤
         PPDeviceTypeCB(3),//婴儿秤
         PPDeviceTypeCA(4), //厨房秤
         PPDeviceTypeCC(5); //wifi秤

#### 1.5 扫描设备列表

	搜索附近支持的设备ScanDeviceListActivity.java

	 	//获取周围蓝牙秤设备
        1、ppScale.monitorSurroundDevice();
        //您可以以毫秒为单位动态设置扫描时间
        2、ppScale.monitorSurroundDevice(300000);  
		//连接选定设备
		if (ppScale != null) {
           ppScale.connectWithMacAddressList(models);
        }

#### 1.6 [闭目单脚](#闭目单脚模式)

### IV .WiFi功能

#### 1.1 注意事项

默认Server域名地址是：https://api.lefuenergy.com

1、确保Server正常，路由器能正常连接到Server
2、确保WiFi环境是2.4G或2.4/5G混合模式，不支持单5G模式
3、确保账号密码正确
4、确保秤端使用的Server地址与App使用的Server地址对应

#### 1.2 WiFi配网的基本流程

蓝牙配网 - 该功能用于蓝牙WiFi秤，在给秤配置网络时使用

1、首先确保已经绑定了蓝牙WiFi秤
2、用户输入Wifi账号和密码
3、发起连接设备，
4、连接成功后，在可写的回调（PPBleWorkStateWritable）里面，将账号和密码发送给秤

    ppScale.configWifi(ssid, password)

5、在PPConfigWifiInterface的监听器里面monitorConfigState方法返回sn码，此时秤上的WiFi图标会先闪烁（连接路由器中），再常量（连接路由器成功并获取到sn），
6、将sn传给Server验证秤是否已经完成注册
7、Server返回成功，则配网成功，否则配网失败

#### 1.3 数据列表

数据列表 -是从Server端获取的秤存在Server端的离线数据,并非秤端存储的历史数据

#### 1.4 设备配置

在设备管理页面，如果绑定了WiFi秤，则会显示设置入口，点击设置入口可进入到设备配置页面,
设备配置页面可以查看当前设备的SN,SSID,PASSWORD、修改秤的服务端DNS地址、清除当前秤的SSID,
对应的代码是在DeveloperActivity.class下。

### V .实体类对象及具体参数说明

#### 1.1 数据对象PPBodyFatModel 参数说明

    //用于存储计算所必须的参数
    var ppBodyBaseModel: PPBodyBaseModel? = null
    var ppSDKVersion: String? = null//计算库版本号

    // 性别
    var ppSex: PPUserGender = ppBodyBaseModel?.userModel?.sex ?: PPUserGender.PPUserGenderFemale

    // 身高(cm)
    var ppHeightCm: Int = ppBodyBaseModel?.userModel?.userHeight ?: 100

    // 年龄(岁)
    var ppAge: Int = ppBodyBaseModel?.userModel?.age ?: 0

    // 体脂错误类型
    var errorType: BodyFatErrorType = BodyFatErrorType.PP_ERROR_TYPE_NONE

    // 数据区间范围和介绍描述
    var bodyDetailModel: PPBodyDetailModel? = null

    /**************** 四电极算法 ****************************/
    // 体重(kg)
    var ppWeightKg: Float = (ppBodyBaseModel?.weight?.toFloat() ?: 0.0f).div(100.0f)

    var ppWeightKgList: List<Float>? = null

    // Body Mass Index
    var ppBMI: Float = 0f
    var ppBMIList: List<Float>? = null

    // 脂肪率(%)
    var ppFat: Float = 0f
    var ppFatList: List<Float>? = null

    // 脂肪量(kg)
    var ppBodyfatKg: Float = 0f
    var ppBodyfatKgList: List<Float>? = null

    // 肌肉率(%)
    var ppMusclePercentage: Float = 0f
    var ppMusclePercentageList: List<Float>? = null

    // 肌肉量(kg)
    var ppMuscleKg: Float = 0f
    var ppMuscleKgList: List<Float>? = null

    // 骨骼肌率(%)
    var ppBodySkeletal: Float = 0f
    var ppBodySkeletalList: List<Float>? = null

    // 骨骼肌量(kg)
    var ppBodySkeletalKg: Float = 0f
    var ppBodySkeletalKgList: List<Float>? = null

    // 水分率(%), 分辨率0.1,
    var ppWaterPercentage: Float = 0f
    var ppWaterPercentageList: List<Float>? = null

    //水分量(Kg)
    var ppWaterKg: Float = 0f
    var ppWaterKgList: List<Float>? = null

    // 蛋白质率(%)
    var ppProteinPercentage: Float = 0f
    var ppProteinPercentageList: List<Float>? = null

    //蛋白质量(Kg)
    var ppProteinKg: Float = 0f
    var ppProteinKgList: List<Float>? = null

    // 去脂体重(kg)
    var ppLoseFatWeightKg: Float = 0f
    var ppLoseFatWeightKgList: List<Float>? = null

    // 皮下脂肪率(%)
    var ppBodyFatSubCutPercentage: Float = 0f
    var ppBodyFatSubCutPercentageList: List<Float>? = null

    // 皮下脂肪量
    var ppBodyFatSubCutKg: Float = 0f
    var ppBodyFatSubCutKgList: List<Float>? = null

    // 心律(bmp)
    var ppHeartRate: Int = ppBodyBaseModel?.heartRate ?: 0
    var ppHeartRateList: List<Float>? = null

    // 基础代谢
    var ppBMR: Int = 0
    var ppBMRList: List<Float>? = null

    // 内脏脂肪等级
    var ppVisceralFat: Int = 0
    var ppVisceralFatList: List<Float>? = null

    // 骨量(kg)
    var ppBoneKg: Float = 0f
    var ppBoneKgList: List<Float>? = null

    // 肌肉控制量(kg)
    var ppBodyMuscleControl: Float = 0f

    // 脂肪控制量(kg)
    var ppFatControlKg: Float = 0f

    // 标准体重
    var ppBodyStandardWeightKg: Float = 0f

    // 理想体重(kg)
    var ppIdealWeightKg: Float = 0f

    // 控制体重(kg)
    var ppControlWeightKg: Float = 0f

    // 身体类型
    var ppBodyType: PPBodyDetailType? = null

    // 肥胖等级
    var ppFatGrade: PPBodyFatGrade? = null
    var ppFatGradeList: List<Float>? = null

    // 健康评估
    var ppBodyHealth: PPBodyHealthAssessment? = null
    var ppBodyHealthList: List<Float>? = null

    // 身体年龄
    var ppBodyAge: Int = 0
    var ppBodyAgeList: List<Float>? = null

    // 身体得分
    var ppBodyScore: Int = 0
    var ppBodyScoreList: List<Float>? = null

    /**************** 八电极算法独有 ****************************/

    // 輸出參數-全身体组成:身体细胞量(kg)
    var ppCellMassKg: Float = 0.0f
    var ppCellMassKgList: List<Float> = listOf()

    // 輸出參數-评价建议:建议卡路里摄入量 Kcal/day
    var ppDCI: Int = 0

    // 輸出參數-全身体组成:无机盐量(Kg)
    var ppMineralKg: Float = 0.0f
    var ppMineralKgList: List<Float> = listOf()

    // 輸出參數-评价建议: 肥胖度(%)
    var ppObesity: Float = 0.0f
    var ppObesityList: List<Float> = listOf()

    // 輸出參數-全身体组成:细胞外水量(kg)
    var ppWaterECWKg: Float = 0.0f
    var ppWaterECWKgList: List<Float> = listOf()

    // 輸出參數-全身体组成:细胞内水量(kg)
    var ppWaterICWKg: Float = 0.0f
    var ppWaterICWKgList: List<Float> = listOf()

    // 左手脂肪量(%), 分辨率0.1
    var ppBodyFatKgLeftArm: Float = 0.0f

    // 左脚脂肪量(%), 分辨率0.1
    var ppBodyFatKgLeftLeg: Float = 0.0f

    // 右手脂肪量(%), 分辨率0.1
    var ppBodyFatKgRightArm: Float = 0.0f

    // 右脚脂肪量(%), 分辨率0.1
    var ppBodyFatKgRightLeg: Float = 0.0f

    // 躯干脂肪量(%), 分辨率0.1
    var ppBodyFatKgTrunk: Float = 0.0f

    // 左手脂肪率(%), 分辨率0.1
    var ppBodyFatRateLeftArm: Float = 0.0f

    // 左脚脂肪率(%), 分辨率0.1
    var ppBodyFatRateLeftLeg: Float = 0.0f

    // 右手脂肪率(%), 分辨率0.1
    var ppBodyFatRateRightArm: Float = 0.0f

    // 右脚脂肪率(%), 分辨率0.1
    var ppBodyFatRateRightLeg: Float = 0.0f

    // 躯干脂肪率(%), 分辨率0.1
    var ppBodyFatRateTrunk: Float = 0.0f

    // 左手肌肉量(kg), 分辨率0.1
    var ppMuscleKgLeftArm: Float = 0.0f

    // 左脚肌肉量(kg), 分辨率0.1
    var ppMuscleKgLeftLeg: Float = 0.0f

    // 右手肌肉量(kg), 分辨率0.1
    var ppMuscleKgRightArm: Float = 0.0f

    // 右脚肌肉量(kg), 分辨率0.1
    var ppMuscleKgRightLeg: Float = 0.0f

    // 躯干肌肉量(kg), 分辨率0.1
    var ppMuscleKgTrunk: Float = 0.0f

注意：在使用时拿到对象，请调用对应的get方法来获取对应的值

##### 1.1.1 错误类型 PPBodyfatErrorType

    PP_ERROR_TYPE_NONE(0),                  //无错误
    PP_ERROR_TYPE_AGE(1),                   //年龄参数有误，需在 6   ~ 99岁(不计算除BMI/idealWeightKg以外参数)
    PP_ERROR_TYPE_HEIGHT(2),                //身高参数有误，需在 90 ~ 220cm(不计算所有参数)
    PP_ERROR_TYPE_WEIGHT(3),                //体重有误 10 ~ 200kg
    PP_ERROR_TYPE_SEX(4),                   //性別有误 0 ~ 1
    PP_ERROR_TYPE_PEOPLE_TYPE(5),               //身高参数有误，需在 90 ~ 220cm(不计算所有参数)
    PP_ERROR_TYPE_IMPEDANCE_TWO_LEGS(6),        //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_TWO_ARMS(7),        //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_LEFT_BODY(8),       //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_RIGHT_ARM(9),       //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_LEFT_ARM(10),        //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_LEFT_LEG(11),       //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_RIGHT_LEG(12),      //阻抗有误 200~1200
    PP_ERROR_TYPE_IMPEDANCE_TRUNK(13);          //阻抗有误 10~100

##### 1.1.2 健康评估 PPBodyEnum.PPBodyHealthAssessment

    PPBodyAssessment1(0),          //!< 健康存在隐患
    PPBodyAssessment2(1),          //!< 亚健康
    PPBodyAssessment3(2),          //!< 一般
    PPBodyAssessment4(3),          //!< 良好
    PPBodyAssessment5(4);          //!< 非常好

##### 1.1.3 肥胖等级 PPBodyEnum.PPBodyFatGrade

    PPBodyGradeFatThin(0),              //!< 偏瘦
    PPBodyGradeFatStandard(1),          //!< 标准
    PPBodyGradeFatOverwight(2),         //!< 超重
    PPBodyGradeFatOne(3),               //!< 肥胖1级
    PPBodyGradeFatTwo(4),               //!< 肥胖2级
    PPBodyGradeFatThree(5);             //!< 肥胖3级

##### 1.1.4 身体类型 PPBodyDetailType

    LF_BODY_TYPE_THIN(0),//偏瘦型
    LF_BODY_TYPE_THIN_MUSCLE(1),//偏瘦肌肉型
    LF_BODY_TYPE_MUSCULAR(2),//肌肉发达型
    LF_BODY_TYPE_LACK_EXERCISE(3),//缺乏运动型
    LF_BODY_TYPE_STANDARD(4),//标准型
    LF_BODY_TYPE_STANDARD_MUSCLE(5),//标准肌肉型
    LF_BODY_TYPE_OBESE_FAT(6),//浮肿肥胖型
    LF_BODY_TYPE_FAT_MUSCLE(7),//偏胖肌肉型
    LF_BODY_TYPE_MUSCLE_FAT(8);//肌肉型偏胖

#### 1.2 设备对象PPDeviceModel 参数说明

    String deviceMac;//设备mac
    String deviceName;//设备蓝牙名称
    /**
     * 设备类型
     *
     * @see com.peng.ppscale.business.device.PPDeviceType.ScaleType
     * @deprecated
     */
    String scaleType;
    /**
     * 电量
     */
    int devicePower = -1;
    /**
     * 硬件版本号
     * @deprecated 
     */
    String firmwareVersion;
    /**
     * 设备类型
     *
     * @see PPScaleDefine.PPDeviceType
     */
    public PPScaleDefine.PPDeviceType deviceType;
    /**
     * 协议模式
     *
     * @see PPScaleDefine.PPDeviceProtocolType
     */
    public PPScaleDefine.PPDeviceProtocolType deviceProtocolType;
    /**
     * 计算方式
     *
     * @see PPScaleDefine.PPDeviceCalcuteType
     */
    public PPScaleDefine.PPDeviceCalcuteType deviceCalcuteType;
    /**
     * 精度
     *
     * @see PPScaleDefine.PPDeviceAccuracyType
     */
    public PPScaleDefine.PPDeviceAccuracyType deviceAccuracyType;
    /**
     * 供电模式
     *
     * @see PPScaleDefine.PPDevicePowerType
     */
    public PPScaleDefine.PPDevicePowerType devicePowerType;
    /**
     * 设备连接类型，用于必须直连的状态
     *
     * @see PPScaleDefine.PPDeviceConnectType
     */
    public PPScaleDefine.PPDeviceConnectType deviceConnectType;
    /**
     * 功能类型，可多功能叠加
     *
     * @see PPScaleDefine.PPDeviceFuncType
     */
    public int deviceFuncType;
    /**
     * 支持的单位
     *
     * @see PPScaleDefine.PPDeviceUnitType
     */
    public int deviceUnitType;
    /**
     * 是否能连接
     */
    public boolean deviceConnectAbled;

##### 1.2.1 PPScaleDefine.PPDeviceProtocolType 协议类型，具体说明

        //未知
        PPDeviceProtocolTypeUnknow(0),
        //使用V2.0蓝牙协议
        PPDeviceProtocolTypeV2(1),
        //使用V3.0蓝牙协议
        PPDeviceProtocolTypeV3(2),
        //四电极、八电极协议
        PPDeviceProtocolTypeTorre(3);

##### 1.2.2 PPScaleDefine.PPDeviceType 设备类型具体说明

    PPDeviceTypeUnknow(0), //未知
    PPDeviceTypeCF(1), //体脂秤
    PPDeviceTypeCE(2), //体重秤
    PPDeviceTypeCB(3), //婴儿秤
    PPDeviceTypeCA(4), //厨房秤
    PPDeviceTypeCC(5); //蓝牙wifi秤

##### 1.2.3 PPScaleDefine.PPDeviceAccuracyType 重量的精度类型具体说明

    PPDeviceAccuracyTypeUnknow(0), //未知精度
    PPDeviceAccuracyTypePoint01(1), //KG精度0.1
    PPDeviceAccuracyTypePoint005(2), //KG精度0.05
    PPDeviceAccuracyTypePointG(3), // 1G精度
    PPDeviceAccuracyTypePoint01G(4); // 0.1G精度

##### 1.2.4 PPScaleDefine.DeviceCalcuteType 体脂计算类型具体说明

    //未知
    PPDeviceCalcuteTypeUnknow(0),
    //秤端计算
    PPDeviceCalcuteTypeInScale(1),
    //直流
    PPDeviceCalcuteTypeDirect(2),
    //交流
    PPDeviceCalcuteTypeAlternate(3),
    // 8电极交流算法
    PPDeviceCalcuteTypeAlternate8(4),
    //默认计算库直接用合泰返回的体脂率
    PPDeviceCalcuteTypeNormal(5),
    //不需要计算
    PPDeviceCalcuteTypeNeedNot(6);

##### 1.2.5 PPScaleDefine.PPDevicePowerType 供电模式具体说明

    //未知
    PPDevicePowerTypeUnknow(0),
    //电池供电
    PPDevicePowerTypeBattery(1),
    //太阳能供电
    PPDevicePowerTypeSolar(2),
    //充电款
    PPDevicePowerTypeCharge(3);

##### 1.2.6 PPScaleDefine.PPDeviceFuncType 功能类型，可多功能叠加,具体说明

    // 称重
    PPDeviceFuncTypeWeight(0x01),
    //测体脂
    PPDeviceFuncTypeFat(0x02),
    //心率
    PPDeviceFuncTypeHeartRate(0x04),
    //历史数据
    PPDeviceFuncTypeHistory(0x08),
    //安全模式，孕妇模式
    PPDeviceFuncTypeSafe(0x10),
    //闭幕单脚
    PPDeviceFuncTypeBMDJ(0x20),
    //抱婴模式
    PPDeviceFuncTypeBaby(0x40),
    //wifi配网
    PPDeviceFuncTypeWifi(0x80);

##### 1.2.7 PPScaleDefine.PPDeviceUnitType 支持的单位,具体说明（暂时未启用）

    PPDeviceUnitTypeKG(0x01),//kg
    PPDeviceUnitTypeLB(0x02),//lb
    PPDeviceUnitTypeST(0x04),//st
    PPDeviceUnitTypeJin(0x08), //斤
    PPDeviceUnitTypeSTLB(0x10);//st:lb

### VI .蓝牙状态监控回调和系统蓝牙状态回调

包含两个回调方法，一个是蓝牙状态监控，一个是系统蓝牙回调

     PPBleStateInterface bleStateInterface = new PPBleStateInterface() {
        //蓝牙状态监控
        //deviceModel 在蓝牙处于扫描过程中，它是null
        @Override
        public void monitorBluetoothWorkState(PPBleWorkState ppBleWorkState, PPDeviceModel deviceModel) {
            if (ppBleWorkState == PPBleWorkState.PPBleWorkStateConnected) {
                Logger.d("设备已连接");
            } else if (ppBleWorkState == PPBleWorkState.PPBleWorkStateConnecting) {
                Logger.d("设备连接中");
            } else if (ppBleWorkState == PPBleWorkState.PPBleWorkStateDisconnected) {
                Logger.d("设备已断开");
            } else if (ppBleWorkState == PPBleWorkState.PPBleWorkStateStop) {
                Logger.d("停止扫描");
            } else if (ppBleWorkState == PPBleWorkState.PPBleWorkStateSearching) {
                Logger.d("扫描中");
            } else if (ppBleWorkState == PPBleWorkState.PPBleWorkSearchTimeOut) {
                Logger.d("扫描超时");
            } else {
              
            }
        }
    
        //系统蓝牙回调
        @Override
        public void monitorBluetoothSwitchState(PPBleSwitchState ppBleSwitchState) {
            if (ppBleSwitchState == PPBleSwitchState.PPBleSwitchStateOff) {
                Logger.e("系统蓝牙断开");
                Toast.makeText(BindingDeviceActivity.this, "系统蓝牙断开", Toast.LENGTH_SHORT).show();
            } else if (ppBleSwitchState == PPBleSwitchState.PPBleSwitchStateOn) {
                Logger.d("系统蓝牙打开");
                Toast.makeText(BindingDeviceActivity.this, "系统蓝牙打开", Toast.LENGTH_SHORT).show();
            } else {
                Logger.e("系统蓝牙异常");
            }
        }
    };

### VIII .蓝牙操作相关

#### 1.1 预留蓝牙操作对象

    BluetoothClient client = ppScale.getBleClient();

#### 1.2 停止扫描

    ppScale.stopSearch();

#### 1.3 断开设备连接

     ppScale.disConnect();

最后你需要在离开页面的之前调用stopSearch方法。 具体的实现请参考Demo中BindingDeviceActivity和ScaleWeightActivity中的代码。

### IX. [版本更新说明](doc/version_update.md)

### X. 使用的第三方库

#### 1、芯片方案商提供的体脂计算库

#### 2、[bluetoothkit1.4.0 蓝牙库](https://github.com/dingjikerbo/Android-BluetoothKit)

### XI. [常见问题](doc/common_problem.md)

Contact Developer： Email: yanfabu-5@lefu.cc