蓝牙SDK，适用于伊欧乐公司下绝大部分的智能秤

最新版本

2.2 解决某些情况下，安卓可能显示指标不完整的bug，提高appid的校验成功率 下载地址

所有版本

Demo

安卓

Android Studio 工程，如果需要使用Eclipse 请自行新建工程，并拷贝相关源文件到工程

onCompete方法的返回值说明

/**
 * 执行成功
 */
int QN_SUCCESS = 0;
/**
 * APPID失效
 */
int QN_UNAVAILABLE_APP_ID = 1;
/**
 * 网络没开
 */
int QN_NETWORK_CLOSED = 2;
/**
 * 网络超时
 */
int QN_NETWORK_TIMEOUT = 3;
/**
 * 没有底功耗蓝牙(蓝牙4.0及以上)
 */
int QN_NO_BLE = 4;
/**
 * 蓝牙错误
 */
int QN_BLE_ERROR = 5;
/**
 * 蓝牙版本太低
 */
int QN_BLE_LOW_VERSION = 6;
/**
 * 蓝牙未开启
 */
int QN_BLE_CLOSED = 7;

/**
 * SDK的版本过低
 */
int QN_BLE_LOW_SDK_VERSION = 8;

1. 把Demo导入到 AS 后，请拷贝最新的SDK jar包和so文到lib目录

• jar包文件名为 qn-ble-api-x.x.jar

• so文件名为 libyolanda_calc.so,SDK 提供8种CPU架构的so库，可根据自己的项目情况选择

• 在 Application种初始化轻牛的SDK

/**
 * 初始化轻牛SDK,仅在Application中的 onCreate中调用，保证每次app实例都只调用一次。调用这个方法时，尽量要联网
 *
 * @param  AppId 由轻牛所分配的 appId
 * @param  isRelease 是否为开发模式，开发时清设置 false，上线时需要设置为true
 * @param  callback 执行结果的回调,轻牛会尽量保证各种情况都会进行回调
 */
 QNApiManager.getApi(getApplicationContext()).initSDK("123456789", false, new QNResultCallback() {
      @Override
      public void onCompete(int errorCode) {
          //执行结果，为0则成功，其它则参考api文档的种的错误码
      }
});

• 调用 startLeScan 启动蓝牙扫描

/**
 * @param deviceName 蓝牙设备的蓝牙名，如果不为空则扫描只扫描指定蓝牙名的设备，为空则不限定
 * @param mac        蓝牙设备的mac地址，如果不为空则扫描只扫描指定mac地址的设备，为空则不限定
 * @param callback   扫描到蓝牙设备后回调的接口
 **/
QNApiManager.getApi(this).startLeScan(null,null,new new QNBleScanCallback() { 
  //如果失败，会在这个方法中返回错误码
  public void onCompete(int errorCode) { 
  }
  //如果扫描到设备，会在这个方法返回这个设备的相关信息,一个设备只返回一次
  public void onScan(QNBleDevice bleDevice) {
  }
});

• 连接扫描到的回调设备QNBleDevice

/**
 * 连接指定的设备，所有的数据或连接状态都会在QNBleCall种进行回调。除了onComplete方法外，，其它的都会在主线程进行回调
 *
 * @param bleDevice 扫描回调接口中的蓝牙设备
 * @param userId    用户标识，用户唯一，传非空的字符串，可以使用 用户名，手机号，邮箱等其它标识
 * @param height    身高，单位cm
 * @param gender    性别 男：1 女：0
 * @param birthday  生日，精确到天
 * @param callback  称重过程的回调接口
 */
QNApiManager.getApi(this).connectDevice(device, "userId", 170, 1, birthday, new new QNBleCallback() {
    /**
     * 开始连接 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     */
    void onConnectStart(QNBleDevice bleDevice);

    /**
     * 已经连接上了 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     */
    void onConnected(QNBleDevice bleDevice);

    /**
     * 断开了蓝牙连接 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     */
    void onDisconnected(QNBleDevice bleDevice);

    /**
     * 收到了不稳定的体重数据，在称重前期会不断被调用 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     * @param weight    不稳定的体重
     */
    void onUnsteadyWeight(QNBleDevice bleDevice, float weight);

    /**
     * 收到了稳定的测量数据 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     * @param data      轻牛测量数据
     */
    void onReceivedData(QNBleDevice bleDevice, QNData data);

    /**
     * 收到了存储数据 在主线程中回调
     *
     * @param bleDevice 轻牛蓝牙设备
     * @param datas     存储数据数组（包含多个），可用{@link QNData#getUserId()}判断是哪个用户的数据
     */
    void onReceivedStoreData(QNBleDevice bleDevice, List<QNData> datas);
});

IOS

文件说明

• libQingNiuSDK.a 包含SDK的头文件定义和具体实现。
• QingNiuDevice.h是设备类，QingNiuUser.h是用户类，QingNiuSDK.h包含整个测量过程的所有方法。

集成过程

1. 将SDK中的libQingNiuSDK.a和.h文件拷贝到应用开发的目录下。然后添加到工程中即可。

• 添加SDK依赖的系统库文件。分别是 CoreBluetooth.framework,SystemConfiguration.framework,CoreGraphics.Framework,libsqlite3.dylib,MobileCoreServices.framework。
• 修改必要的工程配置属性，在工程配置中的“Build Settings”一栏中找到“Linking”配置区，给“Other Linker Flags”配置项添加属性值“-ObjC”， 如果，某些 Xcode 版本中，出现问题，修改设置为 -all_load， 如果工程已经如此配置则不需重复，若没有，请务必按照步骤配置，否则会影响SDK使用。

使用方法

1.registerApp,在使用其它的方法之前，请先调用此方法，并请确保第一次调用时网络畅通(可在登录的时候调用)。每次验证都会有一个过期时间，过期时间到了之后会无法扫描，请重新调用该方法。所以建议每次在didFinishLaunchingWithOptions 方法都调用该方法

//注册轻牛APP
//appid：申请使用SDK之前由轻牛分配的。
//releaseModeFlag 传入YES，则代表当前是发布模式，那么appid需要是轻牛官方提供的。传入NO：则代表当前是测试模式，appid可用@"123456789"进行测试
//registerAppBlock：验证app返回的状态，可根据返回的状态参数做相应的处理。
[QingNiuSDK registerApp:@"123456789" andReleaseModeFlag:NO registerAppBlock:^(QingNiuRegisterAppState qingNiuRegisterAppState) {
    NSLog(@"%ld",(long)qingNiuRegisterAppState);
}];

• startBleScan,每次称重之前第一个调用的方法，用于扫描周围的设备，成功会依次返回扫描到的设备

//qingNiuDevice 第一次调用的时候可以传nil，将会扫描附近的所有设备。扫描到目标设备之后，可以将macAddress或者name属性保存下来，以后可以指定连接该设备(注意：QingNiuPeripheral属性不支持归档，所以不能将扫描到的qingNiuDevice直接归档，如果想下次指定设备扫描，可将对应的macAddress、name属性保存，以便下次使用)
//scanSuccessBlock：扫描成功之后的回调，扫描到设备之后通过这个block回调qingNiuDevice。
//scanFailBlock：扫描失败的回调，会将扫描失败的原因通过该方式返回。
[QingNiuSDK startBleScan:nil scanSuccessBlock:^(QingNiuDevice *qingNiuDevice) {

 } scanFailBlock:^(QingNiuScanDeviceFail qingNiuScanDeviceFail) {
 
}];

• connectDevice：调用startBleScan方法成功之后，调用此方法连接设备并且获取设备的测量数据

// qingNiuDevice：将调用startBleScan获取到的qingNiuDevice作为参数传入，请确保该对象的每一个属性都有值。
// qingNiuUser：当前测量用户的信息。该对象的所有参数都是测量必不可少的。userId的值请确保不同的用户有不同的值，height为身高(单位cm)，gender是性别(0:女 1:男)，birthday是出生日期，(格式：yyyy-MM-dd 如：1990-06-23)。对象可调用QingNiuUser类中的初始化方法获得。
	// connectSuccessBlock：测量完成获取数据成功之后，会返回测量数据deviceData和连接状态，如果状态是QingNiuDeviceConnectStateWeightOver，代表正常测量完毕，如果状态是QingNiuDeviceConnectStateSavedData，代表接收到的数据是存储数据，如果存储数据有多条，根据user_id进行区分。
//connectFailBlock：连接或者获取数据失败后的回调信息，可根据信息提示做响应的处理。
[QingNiuSDK connectDevice:qingNiuDevice user:user connectSuccessBlock:^(NSMutableDictionary *deviceData, QingNiuDeviceConnectState qingNiuDeviceConnectState) {
           
        } connectFailBlock:^(QingNiuDeviceConnectState qingNiuDeviceConnectState) {
 
        }];

• 可选 connectWithAdvertisementData：如果您想自己实现扫描设备的步骤，那么您可以在扫描到设备后将advertisementData和peripheral对象作为参数 使用方法同上

• cancelConnect：如果想断开与当前设备的连接，可以调用此方法。请确保想断开连接的设备qingNiuDevice正是当前连接上的设备，否则会失败。

• clearCache：清除缓存。app切换用户登录时可以调用此方法此方法。在需要获取存储数据的时候必须调用，确保接收设备存储数据时不会出现数据混乱。

Block说明

• 验证app的block，将状态返回

typedef void(^RegisterAppBlock)(QingNiuRegisterAppState qingNiuRegisterAppState);

• 扫描成功的block，将成功之后的设备qingNiuDevice返回

typedef void(^ScanSuccessBlock)(QingNiuDevice *qingNiuDevice);

• 扫描失败的block，将失败之后的原因通过枚举qingNiuScanDeviceFail返回

typedef void(^ScanFailBlock)(QingNiuScanDeviceFail qingNiuScanDeviceFail);

• 连接成功的block，将成功之后的测量数据deviceData和状态qingNiuDeviceConnectState返回

typedef void(^ConnectSuccessBlock)(NSMutableDictionary *deviceData,QingNiuDeviceConnectState qingNiuDeviceConnectState);

• 连接失败的block，将失败之后的原因qingNiuDeviceConnectState返回

typedef void(^ConnectFailBlock)(QingNiuDeviceConnectState qingNiuDeviceConnectState);

• 断开连接失败的block，将断开连接失败的原因qingNiuDeviceDisconnectState返回(这里产生的失败原因，有可能是调用断开连接接口，传入的设备参数有问题或者当前已经与设备断开了连接)

typedef void(^DisconnectFailBlock)(QingNiuDeviceDisconnectState qingNiuDeviceDisconnectState);

• 断开连接成功(会返回断开成功的状态)

typedef void(^DisconnectSuccessBlock)(QingNiuDeviceDisconnectState qingNiuDeviceDisconnectState);

• 返回的数据deviceData字典里面各个字段的含义(注意：最后四个指标是拓展指标，只有达成进一步合作协议的SDK接入商才有可能获取其中的某几个指标)

字段	说明
user_id	用户id(多用户存储数据有用)
measure_time	测量时间(多用户存储数据有用)
weight	体重
bmi	身体质量指数
bodyfat	体脂肪率
subfat	皮下脂肪率
visfat	内脏脂肪等级
water	体水分
bmr	基础代谢量
muscle	骨骼肌率
bone	骨量
protein	蛋白质

注意：以下四个指标是拓展指标，只有达成合作协议的SDK接入商才有可能获取其中的某几个指标

字段	说明
bodyage	体年龄
sinew	肌肉量
fat_free_weight	去脂体重
body_shape	体型

枚举说明

• 验证信息

typedef NS_ENUM(NSInteger,QingNiuRegisterAppState) {//验证appid状态
  QingNiuRegisterAppStateSuccess = 0,           //成功
  QingNiuRegisterAppStateFailParamsError = 1,   //appid错误，确保appid正确再调用一次
  QingNiuRegisterAppStateFailVersionTooLow = 2, //版本号过低或过高，需要新的SDK请联系客服
};

• 扫描设备失败的原因

typedef NS_ENUM(NSInteger,QingNiuScanDeviceFail) { 
  QingNiuScanDeviceFailUnsupported = 0,       //设备不支持蓝牙4.0
  QingNiuScanDeviceFailPoweredOff = 1,        //蓝牙关闭(打开手机蓝牙)
  QingNiuScanDeviceFailValidationFailure = 2, //app验证失败(重新调用registerApp接口) 
  QingNiuScanDevicePoweredOn = 3,             //蓝牙开启(这不是扫描失败情况下的枚举，为了跟以前的版本兼容，不另外添加枚举)
};

• 连接过程中的各种状态枚举(0-4是代表连接过程中失败的枚举，5-10代表连接过程中成功的枚举)

typedef NS_ENUM(NSInteger,QingNiuDeviceConnectState) { 
  QingNiuDeviceConnectStateParamsError = 0,       //传入连接参数错误(这里有可能出现的参数错误包括qingNiuUser，qingNiuDevice，出现这种错误要重新扫描再连接)
  QingNiuDeviceConnectStateConnectFail = 1,       //连接设备失败(重新连接或重新扫描再连接)
  QingNiuDeviceConnectStateDiscoverFail = 2,      //查找设备的服务或者特性失败(重新连接)
  QingNiuDeviceConnectStateDataError = 3,         //接收到的数据出错(重新连接)
  QingNiuDeviceConnectStateLowPower = 4,          //设备低电(设备电量不足)
  QingNiuDeviceConnectStateIsWeighting = 5,       //正在测量(接收实时数据)
  QingNiuDeviceConnectStateWeightOver = 6,        //测量完毕(接收正常测量的数据)
  QingNiuDeviceConnectStateIsGettingSavedData= 7, //正在接收存储数据(接收设备存储的数据)
  QingNiuDeviceConnectStateGetSavedDataOver＝8,   //接收到了所有存储数据(此时deviceData的值为nil)
  QingNiuDeviceConnectStateDisConnected = 9,      //测量完毕之后自动断开了连接(此时deviceData为nil)
  QingNiuDeviceConnectStateConnectedSuccess = 10, //连接成功时候的回调(此时deviceData为nil)
};

• 断开连接的状态

typedef NS_ENUM(NSInteger,QingNiuDeviceDisconnectState) {//断开连接的各种状态
  QingNiuDeviceDisconnectStateDisConnectSuccess = 0,  //断开连接成功
  QingNiuDeviceDisconnectStateParamsError = 1,        //传入连接参数错误(比如外设为空)
  QingNiuDeviceDisconnectStateIsDisConnected = 2,     //已经处于断开的状态
};

注意事项

• 测试版 APPID：123456789，测试版版本的服务器可能会不稳定，
• 使用测试版APPID调试成功后，请切换到发布模式，并使用正式的APPID上线
• SDK中有方法可以指定测试或发布模式

======================= 如有问题，请 email: huangdunren@yolanda.hk 或者直接在QQ，微信的SDK技术讨论组中咨询