# PPScaleDemo-iOS **Repository Path**: pengsiyuan777/ppscale-demo-ios ## Basic Information - **Project Name**: PPScaleDemo-iOS - **Description**: 乐福衡器蓝牙设备通用 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 4 - **Created**: 2021-04-02 - **Last Updated**: 2025-05-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ### 1. 简介 #### 1.1 运行环境 - iOS版本大于9.0，且需要真机运行。 - 运行前请执行 `pod install` --- #### 1.2 一些名称的约定 - 蓝牙WiFi秤：蓝牙WiFi双模，可以通过蓝牙传输数据，在配网完成后可以通过路由器连接云服务器进行数据交换。 - 体重秤和体脂称：体重秤只有测量重量的能力，体脂秤除了测量体重还可以通过测量双脚之间的电阻计算出身体其他参数。 - 锁定数据：平稳的站立在秤面上后，秤面显示的数字会在变化后趋于一个固定值，在闪烁3次后显示的读数即为锁定数据。 - 测脂过程：秤面显示屏会有一字型的图案从上到下进行变化。 - 测脂数据：如果您使用的是体脂称，在锁定数据后秤会主动进行测脂，在完成这个过程后会得到测脂数据。 - 测脂失败：如果您使用的是体脂称，但是测量过程中没有看到测脂过程，请确认您是光脚站立并且脚底正常接触电极片。 - 设备配网：通过蓝牙下发路由器账号和密码信息的过程。 --- ### 2. Demo中实现的场景 #### 2.1 如果您采购的是蓝牙版本的秤那么您的业务流程可能需要包含以下几个部分 ##### 2.1.1 用户信息（对应DEMO中的“User Infomation Editing”） - 需要提供用户的身高、年龄、性别。这三项信息在计算人体参数时的必要参数，如果您订购的设备是体重秤而非体脂秤，那这三项信息为非必须。 - 如果您的设备是蓝牙WiFi秤需要设置Base Url，这个值和秤端固件烧录的是相同的。目的是确保秤和App访问的是同一台服务器。 ##### 2.1.2 设备绑定（对应DEMO中的“Binding Equipment”） - 如果您希望对设备进行管理可以加入此逻辑。此流程中当前会扫描附近所有乐福衡器生产的蓝牙秤设备，一旦发现会尝试进行连接去获取秤端发出的数据，在接收到锁定数据之后会将设备信息储存在本地。 ##### 2.1.2 蓝牙称重（对应DEMO中的“Bluetooth Weighing”） - 在这个流程中，只会尝试去连接已储存在本地的设备（过滤条件使用的是蓝牙秤的MAC地址） --- #### 2.2 如果您采购的是蓝牙Wifi版本的秤那么您的业务流程在蓝牙秤的基础上可能还需要包含以下几个部分 ##### 2.2.1 设备配网（对应DEMO中的“Config Network”） - 在收到锁定数据后如果您的设备为蓝牙WiFi秤（逻辑上通过设备名称判断）会进入设备配网流程。此流程中尝试连接特定的MAC地址的设备，在连接成功后通过蓝牙向设备发送路由器的ssid和password，password可以为空，需要注意的是匹配的路由器不能是5G频段，这会导致配网失败。 ##### 2.2.2 Wifi数据列表 （对应DEMO中的“WiFiScale Data List“） - 已配网的蓝牙WiFi秤未进行蓝牙称重的状态下进行称重，在数据锁定后会将数据上传到指定的云服务器。在此流程中通过设备的SN（WiFi设备的唯一标识符）获取这台秤上传到服务器的所有重量数据。 --- #### 2.3 公共页面 ##### 2.3.1 身体详情 （对应DEMO中的“Body Detail”） - 蓝牙称重后会跳转到该页面，进行身体详情的展示。 - 点击“WiFi数据列表”页的数据，会跳转到该页面，使用当前的用户信息，带入计算方法中得出身体详情。 ##### 2.3.2 设备列表（对应DEMO中的“Equipment List”） - 列表中展示的是在“设备绑定”中记录的设备。可以进行解绑和配网（如果是蓝牙WiFi秤）的操作； - 解绑后的设备需要再次绑定，否则无法在蓝牙秤重页面使用。 --- ### 3. 引入PPScale到工程中 直接拖动PPScaleSDK.framework到你的工程中 在需要的文件中 ``` #import ``` --- ### 4. PPScale提供的方法 #### 4.1 体重、体脂秤相关方法 调用PPScaleManager的实例化方法来进行初始化。 ``` /// 对象的实例化方法 /// @param addressList Mac地址的数组 /// @param filterDeviceNameArr 设备名称的数组 /// @param userModel 用户对象 - (instancetype)initWithMacAddressList:(NSArray *)addressList filterDeviceNameArr:(NSArray *)filterDeviceNameArr andUserModel:(PPUserModel *)userModel; ``` 连接某台指定设备 ``` - (void)connectWithMacAddressList:(NSArray *)addressList; ``` 使用PPScale的实例对象调用扫描附近设备的方法来搜索附近的蓝牙秤并进行连接。 ``` /// 开始扫描附近设备 - (void)startSearching; ``` 当你不再需要使用PPScale提供的信息，你需要停止扫描并且断开已连接的设备。这时需要调用下面的方法,如果当前没有已连接的设备也美观关系，依然可以调用此方法。 ``` /// 停止扫描切断开当前连接的设备 - (void)disconnect; ``` 如果需要获取当前连接着的设备的信息可以调用下面的方法，如果当前没有连接，这个方法会返回nil。 ``` /// 当前连接着的设备 - (PPDeviceModel *)currentDevice; ``` 如果需要在测量页面重新连接可以调用此方法 ``` - (void)reStartSearching; ``` 在设备已连接的状态下，调用此方法可以获得秤端的历史数据 ``` - (void)fetchHistoryData; ``` 在设备已连接的状态下，调用此方法可以删除秤端的历史数据 ``` - (void)deleteHistoryData; ``` --- #### 4.3 闭目单脚模式相关方法 使用PPScale的实例对象调用扫描附近设备的方法来搜索附近的闭目单脚蓝牙秤并进行连接。 ``` /// 连接闭目单脚设备 - (void)connectBMDJScale; ``` 退出闭目单脚模式并停止扫描断开连接 ``` /// 停止扫描切断开闭目单脚的设备 - (void)disconnectBMScale; ``` 发送指令使设备进入闭目单脚模式 ``` /// 闭目单脚设备进入准备状态 /// @param start 是否进入了准备状态 - (void)BMScaleStartTiming:(void(^)(BOOL isSuccess))start; ``` 发送指令使设备退出闭目单脚模式 ``` /// 设备退出闭目单脚状态 /// @param exit 是否退出了闭目单脚 - (void)BMScaleExitTiming:(void(^)(BOOL isSuccess))exit; ``` 在回调函数中返回闭目单脚站立的时间 ``` /// 监听闭目单脚设备站立时间 /// @param timeInterval 站立时间的回调 - (void)BMScaleTimeInterval:(void(^)(BOOL isEnd, NSInteger timeInterval, BOOL isFailed))timeInterval; ``` --- #### 4.4 WiFi配网的相关方法 蓝牙WiFi秤配网 - 传入待连接路由器的ssid和password,如果路由器没有设置密码password可以为空。 ``` - (void)configNetWorkWithSSID:(NSString *)ssid password:(NSString *)password andSuccessHandler:(void(^)(BOOL isSuccess, NSString *sn))handler; ``` --- #### 4.5 状态监听代理方法 蓝牙状态的监听 ``` /// 蓝牙状态监听 @protocol PPBleStateInterface @optional /// 监听蓝牙的工作状态 - (void)monitorBluetoothWorkState:(PPBleWorkState)state; /// 监听蓝牙开关的状态 - (void)monitorBluetoothSwitchState:(CBManagerState)state API_AVAILABLE(ios(10.0)); /// 监听蓝牙授权状态 - (void)monitorBluetoothAuthorState:(CBManagerAuthorization)state API_AVAILABLE(ios(13.0)); @end ``` --- #### 4.6 蓝牙数据的代理方法 - 如果已知所需要连接的设备不要支持历史数据，可以不去实现scaleManager：monitorHistorData：方法，PPScaleManager内部根据外部实现接口的情况调整对蓝牙外设发送的指令集。 - scaleManager：monitorProcessData：提供了过程数据的监听，有些设备支持实时的数据传输，可以在此方法中获取秤重过程中的数据，过程数据中只有体重，没有心律和阻抗。 - scaleManager：monitorLockData：方法会返回最终的重量数据，如果有测脂数据和心律数据，PPBodyFatModel对象的相关属性也会被赋值。 ``` /// 蓝牙数据监听 @protocol PPDataInterface /// 监听秤发出的锁定数据 - (void)scaleManager:(PPScaleManager *)manager monitorLockData:(PPBodyFatModel *)model; @optional /// 监听秤发出的过程数据 - (void)scaleManager:(PPScaleManager *)manager monitorProcessData:(PPBodyBaseModel *)model; /// 监听秤发出的历史数据 - (void)scaleManager:(PPScaleManager *)manager monitorHistorData:(PPBodyHistoryBaseModel *)model; @end ``` --- #### 4.7 蓝牙设备代理方法 ``` // 获取周围的蓝牙秤设备 - (void)scaleManager:(PPScaleManager *)manager monitorSurroundDevice:(PPDeviceModel *)model; ``` --- #### 4.8 外部实现蓝牙的搜索和连接 ``` /// 根据‘centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber *)RSSI’方法返回的额advertisementData 对象实例化一个PPDevice对象 /// @param advertisementData /// PPDeviceModel *model = [[PPDeviceModel alloc] initWithAdvertisementData:@{}]; - (instancetype)initWithAdvertisementData:(NSDictionary *)advertisementData; ``` ``` /// 根据设备返回的数据进行解析 /// @param receiveDate 设备在‘didUpdateValueForCharacteristic’方法中拿到的数据 /// @param device PPDeviceModel对象 /// @param handler 数据类型包括PPBodyBaseModel、PPBodyHistoryBaseModel、PPBodyFatModel + (void)receiveDate:(NSData *)receiveDate deviceModel:(PPDeviceModel *)device analysis2BodyBaseModelWithHandler:(reciveData2BodyBaseModelHandler)handler; ``` ``` [PPDataAnalysisHandler receiveDate:reciveData deviceModel:deviceModel analysis2BodyBaseModelWithHandler:^(id _Nonnull model) { }]; ``` --- ### 5. 蓝牙WiFi秤的常见问题 #### 5.1 配网为什么只能使用2.4G频段？ - 是硬件规格导致的，我们使用的WiFi芯片只有2.4G频段。 #### 5.2 混合模式的路由器可以进行配网么？ - 答：可以，2.4G和5G的混合模式其实是路由器信号不停的在2.4G和5G之间切换，由于切换的频率非常快，所以可以同时使用两种频段。秤可以在搜索到2.4G频段的情况下进行配网。（提供了配网兼容性报告，所有的路由器是在默认模式下进行测试） #### 5.3 秤通过WiFi上传数据的时机是什么时候？ - 答：每次测量完锁定数据后。 #### 5.4 秤端的历史数据是怎样产生的？ - 答：秤重锁定后在蓝牙未连接且未能成功上传服务器（又分上传失败和未配网两种状态）的情况下会，当前这组称重的锁定数据会存为历史存储在秤体内（最多存100组，超出后采用先进先出的原则）。 #### 5.5 秤端的历史数据是怎么样传输的？ - 答：数据的上传分为两种情况：第一种通过蓝牙，当前秤没能连接到路由器的情况下 若App通过蓝牙连接上秤并下发了获取历史数据指令，那秤端将会将存储的历史数据通过蓝牙告知App且不会在传输完成后主动删除，需等待App下发删除指令，会将所有历史数据抹除。第二种通过WiFi，当前秤之前已经配过网，但是由于某种原因数据没有能够及时上传，那么会在下次测量完锁定数据后尝试连接匹配的路由器并上传本次称重和所有历史数据。 #### 5.6 App和蓝牙WiFi秤配网和数据上传的业务流程是怎样的？ ``` sequenceDiagram App->>Scale: 扫描附近设备 Scale->>App: 对外发送蓝牙广播 App->>Scale: 发现目标设备，开始连接 Scale->>App: 连接成功 App->>Scale: 发送 SSID,Password Scale->>App: 回复SN Scale->>Server:发送SN Server->>Scale:SN已存储 App->>Server: 发送SN，UID Server->>App:将SN和UID进行绑定 Server->>App:配网成功 Scale->>Server:上报称重数据（SN,Weight,impedance） Server->>App:通过SN找到匹配的UID，将称重数据发送出去（Weight, impedance） ``` #### 5.7 OTA的过程是怎么样的？ ``` sequenceDiagram Scale->>Server: 查询最新的固件版本（将本地固件的版本号作为参数上传） Server->>Scale: 判断是否需要升级 Server->>Scale: 如果需要升级（返回固件的下载路径） Scale->>Server: 从固件下载路径开始下载 Scale->>Server: 升级成功后显示PASS ```