# 好营养SDK使用说明 - Android
[](https://jitpack.io/#elinkthings/PabulumSDKRepositoryAndroid)
[aar包下载地址](https://github.com/elinkthings/PabulumSDKRepositoryAndroid/releases)
[key注册](http://sdk.aicare.net.cn)
[English documentation](README.md)
该文档为指导Android开发人员在Android 4.4及以上系统中集成好营养-SDK-Android，主要为一些关键的使用示例
## 一、导入SDK
```
repositories {
flatDir {
dirs 'libs'
}
}
步骤1.将JitPack存储库添加到您的构建文件中
将其添加到存储库末尾的root build.gradle中：
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
步骤2.添加依赖项
dependencies {
implementation 'com.github.elinkthings:PabulumSDKRepositoryAndroid:1.2.6'
}
也可以使用aar包依赖,请自行下载放到项目的libs中
```
## 二、权限设置
```
```
> 6.0及以上系统必须要定位权限，且需要手动获取权限
## 三、开始集成
> 在AndroidManifest.xml application标签下面增加
```
...
```
> 初始化,[key注册](http://sdk.aicare.net.cn)
```
//建议在Application中初始化
PabulumSDK.getInstance().init(this,"key","secret");
```
你可以直接让你自己的`Activity`类继承`BleProfileServiceReadyActivity`
```
public class MyActivity extends BleProfileServiceReadyActivity
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//判断手机设备是否支持Ble
if (!ensureBLESupported()) {
T.showShort(this, R.string.not_support_ble);
finish();
}
//判断是否有定位权限,此方法没有进行封装具体代码可在demo中获得，也可按照自己方式去调用请求权限方法
initPermissions();
//判断蓝牙是否打开，若需要换样式，可自己去实现
if (!isBLEEnabled()) {
showBLEDialog();
}
}
```
## 四、扫描设备，停止扫描设备,查看扫描状态
与扫描相关的API如下，详情参考BleProfileServiceReadyActivity类，具体使用参考demo
```
//调用startScan方法开启扫描
startScan();
//onLeScanCallback(BluetoothDevice device, int rssi)接口会回调获取到符合协议的设备
@Override
protected void onLeScanCallback(BluetoothDevice device, int rssi) {
//符合协议的设备
}
//调用stopScan方法停止扫描
stopScan();
```
## 五、连接设备，断开设备
与连接相关的API如下，详情参考BleProfileServiceReadyActivity类，具体使用参考demo。
```
//调用connectDevice(BluetoothDevice device)方法去连接设备 需要传入BluetoothDevice对象,可以在onLeScanCallback（）回调方法中获得 。
connectDevice(BluetoothDevice device)
//在onStateChanged可以获取到连接状态
@Override
public void onStateChanged(String deviceAddress, int state) {
super.onStateChanged(deviceAddress, state);
//state 具体状态看类说明
//连接成功：(state = BleProfileService.STATE_CONNECTED)
//断开连接：(state = BleProfileService.STATE_DISCONNECTED)
//校验成功：(state = BleProfileService.STATE_INDICATION_SUCCESS)
}
//调用PabulumService.PabulumBinder类中disconnect方法去断开连接
binder.disconnect()
```
使用`connectDevice`方法连接，，使用`onStateChanged`方法监听连接的状态，使用`onError`方法监听连接过程中的异常，以便于进行额外的处理和问题排查。使用`isConnected`方法判断连接是否已经建立。
## 六 连接成功，接受秤返回的数据
以下方法或接口可直接在继承BleProfileServiceReadyActivity类后自动获得
```
//onServiceBinded方法中获得PabulumService.PabulumBinder的实例
@Override
protected void onServiceBinded(BleProfileService.LocalBinder binder) {
this.binder = (PabulumService.PabulumBinder) binder;
}
//设备返回数据
@Override
protected void getFoodData(FoodData foodData) {
//FoodData(String data, byte unit, byte deviceType, double weight);
//data(重量, 对应当前单位),
//unit(单位，同上 unitType）,
//deviceType(0x04: 无小数点，0x05:大量程),
//weight(重量，以 g 为单位)
}
//支持的单位列表
@Override
protected void getUnits(int[] units) {
//PabulumBleConfig 中定义的单位列表
UNIT_G = 0x00; //克
UNIT_ML = 0x01; //毫升
UNIT_LB = 0x02; //磅
UNIT_OZ = 0x03; //盎司
UNIT_KG = 0x04; //千克
UNIT_FG = 0x05; //斤=500g
UNIT_ML_MILK = 0x06; //牛奶 ml
UNIT_ML_WATER = 0x07; //水 ml
UNIT_FL_OZ_MILK = 0x08; //牛奶 floz
UNIT_FL_OZ_WATER = 0x09; //水 floz
}
//当前单位
@Override
protected void getUnit(byte unitType) {
}
//设备返回的计时操作指令
@Override
protected void getTimeStatus(int status) {
//status 状态(开=1,关=2,重置=3)
}
//设备返回的倒计时开始指令
@Override
protected void getCountdownStart(int time) {
//time 秒
}
//设备返回的同步时间指令
@Override
protected void getSynTime(byte cmdType, int timeS) {
//timeS 秒
//cmdType 为指令类型, 范围
//PabulumBleConfig.SYN_TIME -->正计时同步时间
//PabulumBleConfig.SYN_TIME_LESS -->倒计时同步时间
//PabulumBleConfig.TIMING_PAUSE -->正计时暂停同步时间
//PabulumBleConfig.TIMING_PAUSE_LESS -->倒计时暂停同步时间
}
//错误指令
@Override
protected void getErrCodes(int[] ints) {
//err[0]==1 超载,0 正常;err[1]==1 低电,0 正常
}
//停止闹铃指令
@Override
protected void getStopAlarm() {
}
//设备返回的版本信息
@Override
protected void getBleVersion(String version) {
}
//设备的信号强度
@Override
public void onReadRssi(int rssi) {
}
//设备返回的透传数据(不能用 0xAC 和 0xAD 开头,避免与 SDK 其他协议冲突)：
@Override
protected void getPenetrateData(byte[] bytes) {
}
```
> 注意：这些接口或方法部分需要APP给体脂下发命令才会有返回数据.
## 七 给设备下发指令
在BleProfileServiceReadyActivity.onServiceBinded(PabulumService.PabulumBinder binder)获得PabulumService.PabulumBinder的实例，调用binder里面方法
```
秤支持的单位:getUnits();
设置单位：setUnit(byte unitType); //unitType 支持的列表从getUnits()中获取
去皮：netWeight();
关机：powerOff();
自定义写数据接口：writeValue(byte[] value);//value 不能为 null， 长度不能大于 20
//---------咖啡秤定时相关功能
开始计时:startTime();
暂停,正计时:pauseTime(int time);
暂停,倒计时:pauseTimeLess(int time);
重置计时:resetTime();
开始倒计时:startTimeLess(int time);//time 为秒
停止闹铃指令:stopAlarm();
```
## 八 类说明
#### 1.FoodData(重量数据)
```
类型 参数名 说明
String data;//重量，对应当前单位
byte unit;//单位
byte deviceType;//设备类型：0x04(无小数点), 0x05(大量程)
double weight;//重量，对应单位g
```