概述

English Document

该文档用于引导Yolanda客户接入云康宝的智能设备。

该SDK支持设备请参考设备类型

对接步骤

1、商务申请

跟Yolanda商务人员签订合作协议，我司会提供开发所需的appid和配置文件

我们会提供一个表格，只要按照要求填写表格，发给我们的人员处理，通常很快就会给到上述两样东西

千万不要在正式APP使用123456789这个测试的appid，它不稳定，我们随时可能封杀它，或变更测试用的appid

2、下载研究SDK

下载相应平台的SDK，使用上面申请到的appid和配置文件运行demo，研究下demo和文档是如何使用SDK的。

强烈建议研究demo后，再接入到自己的APP，另外可以先看看FAQ，仔细阅读其中的问题，也许你的疑惑就会解开。

建议开发人员star我们的SDK项目，这样可以及时收到更新通知

3、设计体脂秤功能

设计如何在现有APP中接入体脂秤。上一步研究好SDK后，也能为这一步设计体脂秤避免不少雷区。

通常体脂秤的使用步骤为：

添加设备

这个并不是跟安卓或iOS系统配置，蓝牙4.0是可以支持不配对使用的。我们的体脂秤是属于自定义协议，通常只有我们的APP或接入了我们SDK的APP才能使用。不能添加至系统，用系统蓝牙连接。
测量

这里的测量其实包括蓝牙扫描和蓝牙连接，在测量过程中，最好展示一些测量动画，提示用户正在测量，避免使用过程太枯燥
保存和展示数据

收到锁定测量数据后，就把数据保存在本地并进行展示。为了达到离线测量，可以先把数据保存本地，然后再上传到服务器，如果当时没有网络，则可以等后续有网络再上传数据到服务器。展示数据的方式可以参考我们的APP，当然如果有自己的风格和分析方式，也可以用自己的。

4、开发APP功能

根据设计好的功能，把SDK中接入APP中。

这里要特别注意安卓的定位权限和定位服务开关。iOS则主要13版本后，需要蓝牙权限。

5、自测功能

开发完成后，可以先使用我们的提供测试用例SDK测试用例，验证称重功能是否能够使用。

上述附件可以鼠标右键点击下载

如果可以的话，建议把测试版本也发给Yolanda，我们会安排测试人员辅助客户的APP测试。

我们会把测试的结果以及我们对APP的一些看法提到给客户。

6、提交上线

测试完成，就提交上线。上线成功最好也通知Yolanda。这样Yolanda会登记上线结果，继续跟进体验。

SDK 下载链接

SDK文件已经不再单独下载链接，下文是我们提供的Demo，Demo项目中有最新的SDK文件。

iOS

Android

集成方式

Android集成方式

iOS集成方式

开发流程

使用SDK前，需要先调用初始化，方法为：QNBleApi.initSdk

代码示例：

//安卓示例代码
String configFilePath = "file:///android_asset/test123456789.qn";
QNBleApi.getInstance(context).initSdk("test123456789", configFilePath, new QNResultCallback() {
    @Override
    public void onResult(int code, String msg) {
        Log.d("BaseApplication", "初始化文件" + msg);
    }
});

NSString *file = [[NSBundle mainBundle] pathForResource:@"123456789" ofType:@"qn"];
[[QNBleApi sharedBleApi] initSdk:@"123456789" firstDataFile:file callback:^(NSError *error) {
}];

初始化方法是任何设备都需要调用的方法，下面是不同的设备类型的工作流程。

如果不清楚自己手上是何种设备，可以参考常见问题中的如何判断设备类型

概述

概述