andorid SDK 集成指南_v2.5

版本履历

1. ver 2.5：增加独立授权设备限制。

2. ver 2.4：增加应用限制、蓝牙连接状态返回、优化日志功能。

3. ver 2.3：新增血氧仪HPO-201T，AF血压计U734T等设备的绑定和数据同步功能。

4. ver 2.2：对应无网络时也能访问。

5. ver 2.1：对应android 12权限。

Andorid SDK概述

本SDK主要提供欧姆龙血压计、血糖仪、体脂仪、血氧仪的绑定、同步数据功能。开发者添加jar文件到项目中，调用sdk提供的接口方法，实现对血压和体脂设备的操控。 SDK包含OmronBleSdk.jar文件

术语定义

Android SDK集成

1. SD复制OmronBleSdk.jar到工程 libs/ 目录下。

在MyApplication的onCreate()方法里面添加 OMRONLib.init(this);

样例

public class MyApplication extends LitePalApplication {
  @Override
  public void onCreate() {
    super.onCreate();
    LitePalApplication.initialize(this);
    OMRONLib.init(this,false,0);
  }
}

2.修改包名

xxxxxxxxxx
修改项目的applicationId，确保官网申请的安卓的应用包名与当前applicationId一致。

3.app添加sdk需要的依赖包

xxxxxxxxxx
implementation 'com.google.code.gson:gson:2.8.6'
implementation group: 'commons-codec', name: 'commons-codec', version: '1.14'
implementation 'com.squareup.okhttp3:okhttp:3.4.2'
implementation 'com.squareup.okhttp3:logging-interceptor:3.4.2'

4. Manifest里面添加权限（新增Android12权限）

xxxxxxxxxx
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_PRIVILEGED"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

样例

​x
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Android 12以下才需要定位权限， Android 9以下官方建议申请ACCESS_COARSE_LOCATION -->
<uses-permission
android:name="android.permission.ACCESS_COARSE_LOCATION"
android:maxSdkVersion="30" />
<uses-permission
android:name="android.permission.ACCESS_FINE_LOCATION"
android:maxSdkVersion="30" />
<uses-permission
android:name="android.permission.BLUETOOTH"
android:maxSdkVersion="30" />
<uses-permission
android:name="android.permission.BLUETOOTH_ADMIN"
android:maxSdkVersion="30" />
<!-- Android 12在不申请定位权限时，必须加上android:usesPermissionFlags="neverForLocation"，否则搜不到设备 -->
<uses-permission
android:name="android.permission.BLUETOOTH_SCAN"
android:usesPermissionFlags="neverForLocation"
tools:targetApi="s" />
<uses-permission
android:name="android.permission.BLUETOOTH_CONNECT"
tools:targetApi="s" />

<application
android:name="com.omron.omronblesdkdemo.MyApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity
  android:name=".activity.EntranceActivity"
  android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
</activity>
</application>

5. 需要动态申请定位权限（新增Android12权限）

xxxxxxxxxx
    private String[]mPermissions=new String[]{Manifest.permission.ACCESS_FINE_LOCATION};

    private String[]mPermissions2=new String[]{Manifest.permission.BLUETOOTH_SCAN,
            Manifest.permission.BLUETOOTH_CONNECT};

    /**
     * Android12权限，在init方法里添加
     */
    private void init(){
        //android 12 需要权限
        OHQDeviceManager.init(this);
        ...
    }

    /**
     * 判断是否有SDK需要的权限，没有的话动态获取
     */
    private void initPermission(){
        //清空已经允许的没有通过的权限
        mPermissionList.clear(); 
      
        //逐个判断是否还有未通过的权限
        if(Build.VERSION.SDK_INT>=31){
            for(String permission:mPermissions2){
                if(ContextCompat.checkSelfPermission(this,permission)!=PackageManager.PERMISSION_GRANTED){
                    //添加还未授予的权限到mPermissionList中
                    mPermissionList.add(permission); 
                }
            }
        }else{
            for(String permission:mPermissions){
                if(ContextCompat.checkSelfPermission(this,permission)!=PackageManager.PERMISSION_GRANTED){
                    //添加还未授予的权限到mPermissionList中
                    mPermissionList.add(permission); 
                }
            }
        }
        if(mPermissionList.size()>0){ 
            //有权限没有通过，需要申请
            ActivityCompat.requestPermissions(this,mPermissionList.toArray(new String[0]),mRequestCode);
        }else{
           //权限已经都通过了，可以将程序继续打开了
        }
    }

6. SDK 初始化验证

注意点：调用初始化方法之前必须先取得授权！！！

6.1 授权与用户管理配置

根据使用场景和网络依赖性，SDK 提供两种授权模式，区别如下：

配置选择建议

1. 优先选择在线模式

   • 支持动态用户管理（如冻结异常账户）

   • 自动适配最新设备授权规则

   • 首次激活后仍可离线使用核心功能

2. 强制离线场景选择离线模式

   • 需提前在管理门户生成设备指纹绑定的授权文件

   • 授权文件与设备强关联，不可跨设备复用

请根据使用场景选择对应的配置方式。

详细配置如下：

在线模式（无需离线授权文件）

xxxxxxxxxx
strLicense = "";  // 直接设置为空字符串

离线模式（需预置授权文件）

• 文件准备 ：从管理门户下载独立设备授权文件（格式示例：license.lic）

• 文件存放路径 ： /Android/data/<您的应用包名>/files/ （例如：/Android/data/com.example.app/files/license_12345.lic）

• 激活方式 ：

  xxxxxxxxxx
  String licenseContent = readFileContent("license_12345.lic"); // 自行实现文件读取
  omronlib.requestIdentifier(appKey, packageSecret, packageName, licenseContent, ...);
  

用户权限控制（可选）

• 通过thirdUserId参数限制特定用户使用SDK。

xxxxxxxxxx
String thirdUserId = "USER_001"; // 长度不超过64字符（字母/数字/下划线）
omronlib.requestIdentifier(..., thirdUserId, ...);

注：被封禁用户将收到错误码26（`OMRON_BLE_ERROR_DEVICE_THIRD_USER_BLOCKED`）

6.2 使用示例

xxxxxxxxxx
public static OMRONLib omronlib;

// 在Activity的onCreate里面初始化omronlib，调用注册方法
//初始化OMRONLib对象
omronlib = OMRONLib.getInstance();

//注册SDK，通过IdentifierCallback接口返回成功或失败
omronlib.requestIdentifier(appKey, packageSecret, packageName, strLicense, thirdUserId, new IdentifierCallback() {
  @Override
  public void onSuccess() {
     //初始化成功
  }

  @Override
  public void onFail(OMRONBLEErrMsg error) {
       //初始化失败
  }
});

7. 调用SDK的接口实现功能

周期扫描接口回调

xxxxxxxxxx
@MainThread
public interface BleScanCallback {

/**
* 扫描到的设备
* @param device 设备
* @param rssi RSSI值
* @param scanRecord scanRecord
*/
void onBleScan(BleScanDevice device, int rssi, byte[] scanRecord);

/**
* 扫描结束
*/
void onCycleEnd();
}

样例：周期扫描绑定状态的设备接口调用

xxxxxxxxxx
private static final int SCAN_PERIOD = 30;
OMRONLib.getInstance().startBindScan(DeviceCategory.BODY, SCAN_PERIOD, mBleScanCallback);

样例：周期扫描同步状态的设备接口调用

xxxxxxxxxx
private static final int SCAN_PERIOD = 30;
OMRONLib.getInstance().startSyncScan(List<BleScanDevice> deviceList, SCAN_PERIOD, mBleScanCallback);

血压接口回调

xxxxxxxxxx
private OMRONLib.OmronBleCallBack myOmronBleCallBack = new OMRONLib.OmronBleCallBack() {
  @Override
  public void onFailure(OMRONBLEErrMsg errMsg) {}
  @Override
  public void onBindComplete(BpDeviceInfo deviceInfo){};
  @Override
  public void onDataReadComplete(BpDeviceInfo deviceInfo,List<BPData> data) {}
};

样例：同步血压数据接口调用

xxxxxxxxxx
deviceType = DeviceType.BLOOD_9200T;
omronlib.getDeviceData(deviceType, deviceName, deviceAddress, myOmronBleCallBack);

Android API

1. 异常情况枚举

xxxxxxxxxx
OMRON_SDK_UnOpenBlueTooth(1, "蓝牙未开启,请开启蓝牙"),
OMRON_BLE_ERROR_NOT_SUPPORT(2, "该设备不支持蓝牙"),
OMRON_SDK_NoDevice(3, "扫描超时"),
OMRON_SDK_InValidKey(4, "厂商ID 无效"),
OMRON_SDK_ConnectFail(5, "连接失败"),
OMRON_SDK_UnBind(6, "请先绑定正确的设备"),
OMRON_SDK_UnRegister(7, "未注册"),
OMRON_SDK_NoNet(8, "请在网络连接状态下进行操作"),
OMRON_SDK_BindFail(9, "绑定失败"),
OMRON_SDK_TRANSFERFAIL(10, "未找到设备同步失败"),
OMRON_SDK_ADDRESS_EMPTY(11, "设备地址不存在"),
OMRON_SDK_INVALID_DEVICE_ADDRESS(12,"无效的设备地址"),
OMRON_BLE_ERROR_DEVICE_CAN_NOT_CONNECT(13,"无法与目标设备建立连接"),
OMRON_BLE_ERROR_DEVICE_NOT_CONNECT(14,"设备未连接"),
OMRON_BLE_ERROR_DEVICE_NOT_SUPPORT(15,"设备不支持该功能"),
OMRON_BLE_ERROR_DEVICE_DISCOVER_SERVICE(16,"无法获取设备服务"),
OMRON_BLE_ERROR_DEVICE_READ_ChARACTERISTIC(16,"无法读取信息"),
OMRON_BLE_ERROR_DEVICE_WRITE_DESCRIPTOR(17,"无法更改描述"),
OMRON_BLE_ERROR_DEVICE_BOND_FAILED(18,"配对失败"),
OMRON_BLE_ERROR_PERMISSION_BLE(19, "需要打开附近的设备权限"),
OMRON_BLE_ERROR_SYNC_EMPTY(20, "已同步至最新数据"),
OMRON_BLE_ERROR_DEVICE_CATEGORY_NOT_SUPPORT(21, "不支持该设备类别"),
OMRON_BLE_ERROR_DEVICE_TYPE_NOT_SUPPORT(22, "不支持该设备型号");
OMRON_BLE_ERROR_DEVICE_BOND_STATE_ERROR(23, "绑定状态错误，请在蓝牙列表中取消配对后再试"),
OMRON_BLE_ERROR_DEVICE_TYPE_EXPIRATION(24, "设备已过期，请延长使用期后继续使用"),
OMRON_BLE_ERROR_DEVICE_FAILED_TO_OVER_FINGERPRINT(25, "指纹授权量超过"),
OMRON_BLE_ERROR_DEVICE_THIRD_USER_BLOCKED(26, "当前用户已冻结")
OMRON_BLE_ERROR_FILE_EMPTY(27, "请允许网络数据访问或者配置离线license文件")

2. 设备扫描回调接口说明

开始扫描时调用该接口

xxxxxxxxxx
@MainThread
public interface BleScanDeviceCallback {

/**
* 扫描到符合条件的设备后回调该接口，一次扫描周期中可能存在多次回调
* @param device 设备
* @param rssi RSSI值
* @param scanRecord scanRecord
*/
void onBleScan(BleScanDevice device, int rssi, byte[] scanRecord);

/**
* 扫描周期结束后回调该接口
*/
void onCycleEnd();

/**
* 扫描失败、异常信息
*/
void onBleScanFailure(OMRONBLEErrMsg errMsg);
}

3. 数据回调接口说明

3.1 血压回调接口说明

xxxxxxxxxx
public interface OmronBpBleCallBack extends OMRONBLECallbackBase {
public void onFailure(OMRONBLEErrMsg errMsg);

void onBindComplete(String deviceType, String deviceName, String address, DeviceInfo deviceInfo, List<BPData> bpDataList);

void onDataReadComplete(List<BPData> data);
}

3.1.1. onFailure(OMRONBLEErrMsg errMsg)

xxxxxxxxxx
OMRONBLEErrMsg 为异常情况返回

3.1.2. void onBindComplete(String deviceType, String deviceName, String address, DeviceInfo deviceInfo, List bpDataList);

绑定接口成功返回

xxxxxxxxxx
deviceType 设备型号
deviceName 设备名称
address 设备mac地址
deviceInfo 血压设备信息
bpDataList 血压测量数据

3.1.3. onDataReadComplete(List data)

同步数据成功返回

xxxxxxxxxx
data 血压测量数据

3.2. 体脂回调说明

xxxxxxxxxx
public interface OmronBfBleCallBack extends OMRONBLECallbackBase {
void onFailure(OMRONBLEErrMsg errMsg);
void onBindBodyFatComplete(String deviceType, String deviceName, String userindex, String address, String sex, String height, String birthday, DeviceInfo deviceInfo, List<BodyfatData> bfDataList);
void onBodyFatDataReadComplete(List<BodyfatData> data, String sex, String height, String birthday);
void onScanBodyFatComplete();
}

3.2.1. onFailure(OMRONBLEErrMsg errMsg)

xxxxxxxxxx
OMRONBLEErrMsg为异常情况返回

3.2.2. void onBindBodyFatComplete(String deviceType, String deviceName, String userindex, String address, String sex, String height, String birthday, DeviceInfo deviceInfo, List bfDataList);

绑定接口成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
userindex 设备机位
address 设备mac地址
sex 性别（Male,Female）
height 身高
birthday 生日
deviceInfo 体脂设备信息
bpDataList 体脂测量数据

3.2.3. onBodyFatDataReadComplete(String deviceType, String deviceName, String userindex, String address, List data,String sex , String height, String birthday)

同步数据成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
userindex 设备机位
address 设备mac地址
data 体脂测量数据
sex 性别（Male,Female）
height 身高
birthday 生日

3.3. 血糖回调说明

xxxxxxxxxx
public interface OmronBgBleCallBack extends OMRONBLECallbackBase {
void onFailure(OMRONBLEErrMsg errMsg);
void onBindComplete(String deviceType, String deviceName, String deviceAddress, List<BGData> dataList);

void onDataReadComplete(String deviceType, String deviceName, String deviceAddress, List<BGData> dataList);
}

3.3.1. onFailure(OMRONBLEErrMsg errMsg)

xxxxxxxxxx
OMRONBLEErrMsg为异常情况返回

3.3.2. void onBindComplete(String deviceType, String deviceName, String deviceAddress, List dataList);

绑定接口成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
deviceAddress 设备mac地址
dataList 血糖测量数据

3.3.3. void onDataReadComplete(String deviceType, String deviceName, String deviceAddress, List dataList);

同步数据成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
deviceAddress 设备mac地址
dataList 血糖测量数据

3.4. 血氧回调说明

xxxxxxxxxx
public interface OmronBoBleCallBack extends OMRONBLECallbackBase {
void onFailure(OMRONBLEErrMsg errMsg);
void onBoComplete(String deviceType, String deviceName, String address, DeviceInfo deviceInfo, List<BoData> boDataList);
void onBoDataReadComplete(String deviceType, String deviceName, String address, List<BoData> data);
}

3.4.1. onFailure(OMRONBLEErrMsg errMsg)

xxxxxxxxxx
OMRONBLEErrMsg为异常情况返回

3.4.2. void onBoComplete(String deviceType, String deviceName, String address, DeviceInfo deviceInfo, List boDataList);

绑定接口成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
deviceAddress 设备mac地址
deviceInfo 血氧设备信息
dataList 血氧测量数据

3.4.3. void onBoDataReadComplete(String deviceType, String deviceName, String address, List data);

同步数据成功返回

xxxxxxxxxx
deviceType 设备类型
deviceName 设备名称
deviceAddress 设备mac地址
dataList 血糖测量数据

4. 数据参数

4.1 血压数据类参数

xxxxxxxxxx
// 血压数据
public class BPData {
//血压高压
private int systolic;
//低压
private int diastolic;
//脉搏
private int pulse;
//心率不齐状态
private int arrhythmiaFlg; // 0: normal; 1 abnormal
//身体移动状态
private int bmFlg; // 0:not move; 1 move
//臂带宽松状态
private int cwsFlg; // 0: normal; 1 abnormal
//测量使用者
private int measureUser; // 0:unset; 1:userA; 2:userB
//测量时间
private long measureTime;
//AF血压计三次测量
private int afibMode;
//房颤检测
private int afibFlg;// 0: normal; 1 abnormal
}

4.2 体脂数据类参数

xxxxxxxxxx
public class BodyfatData {
/**
* 测量时间
* */
private String mMeasureTime;
/**
* 体重
* */
private String mWeight;
/**
* 体脂肪率
* */
private String mPercentage;
/**
* 骨骼肌率
* */
private String mSkeletal;
/**
* 基础代谢
* */
private String mBasal;
/**
* BMI
* */
private String mBmi;
/**
* 体年龄
* */
private String mAge;
/**
* 内脏脂肪
* */
private String mVisceral;
}

4.3 血糖数据类参数

xxxxxxxxxx
public class BGData {

/** Record sequence number */
private int sequenceNumber;

/** The base time of the measurement */
private Calendar time;

/** The glucose concentration. 0 if not present */
private float glucoseConcentration;

/** mg/L mmol/L */
private Unit unit;

/**
* One of the following:<br/>
* 0 未设定<br/>
* 1 餐前<br/>
* 2 餐后<br/>
* 3 空腹<br/>
*/
private Meal meal;
}

4.4 血氧数据类参数

xxxxxxxxxx
public class BOData {
//血氧饱和度
private String mOxygen;

//脉搏
private String mPulse;
}

5. 设备类型

设备信息

xxxxxxxxxx
public class DeviceInfo {
// 设备类型
@Nullable
private String modelName;
// 设备序列号
@Nullable
private String serialNumber;
// 硬件版本号
@Nullable
private String hardwareVersion;
// 软件版本号
@Nullable
private String softwareVersion;
// 固件版本号
@Nullable
private String firmwareVersion;
// 设备电量
@Nullable
private Integer batteryLevel;
// 供电方式
@Nullable
private String powerSupplyMode;
// 制造商名称
@Nullable
private String manufacturerName;
// 设备代号
@Nullable
private String modelNumber;
// 设备系统ID
@Nullable
private String systemID;
}

设备类别

xxxxxxxxxx
public @interface DeviceCategory {
// 血压计
int BLOOD_PRESSURE = 1;
// 血糖仪
int BLOOD_GLUCOSE = 2;
// 体脂仪
int BODY_FAT = 4;
// 血氧仪
int BLOOD_OXYGEN = 5;
// 全部
int ALL_SUPPORT = 0;
}

6. 对外接口

6.1. 对外蓝牙SDK的调用类

xxxxxxxxxx
OMRONLib

6.1.1 SDK初始化

xxxxxxxxxx
public static OMRONLib init(@NonNull Context context)

6.2. 获取OMRONLib单例对象

xxxxxxxxxx
public static OMRONLib getInstance()

6.3. 注册方法

离线激活认证方法：

xxxxxxxxxx
@param appKey 开发者key
@param packageSecret 应用秘钥
@param packageName 应用包名
@param strLicense 应用离线License文件内容，当选择在线激活方式时，可设置为空
@param thirdUserId 第三方客户应用下用户识别码，如果不使用用户限制功能，可设置为空
public void requestIdentifier(String appKey, String packageSecret, String packageName, String strLicense, IdentifierCallback identifierCallback)

6.4 根据设备类别获取可用设备列表

xxxxxxxxxx
@param type 设备类型 1、血压计 2、血糖计 4、体脂仪
@return 设备型号名称列表
List<String> getDeviceTypeList(@DeviceCategory int deviceCategory);

6.5 扫描

6.5.1 开启扫描（旧版本扫描方法，不推荐）

扫描指定类别的设备，不区分设备绑定状态和同步状态，不推荐

xxxxxxxxxx
@param type 设备类型
@param scanPeriod 扫描周期，最小1s，最大300s
@param deviceAddress 设备mac地址
@param callback 扫描回调
void startScan(@DeviceCategory int type, @Size(min = 1, max = 300) int scanPeriod, @Nullable String deviceAddress, @Nullable BleScanDeviceCallback callback);

6.5.2 开启绑定扫描

扫描指定类别的绑定状态的设备

xxxxxxxxxx
@param deviceCategory 要扫描的绑定状态的设备类别
@param scanPeriod 扫描周期，最小1s，最大300s
@param callback 扫描回调
void startBindScan(@DeviceCategory int deviceCategory, @Size(min = 1, max = 300) int scanPeriod, @NonNull BleScanDeviceCallback callback)

6.5.3 开启同步扫描

扫描已绑定的同步状态中的设备

xxxxxxxxxx
@param deviceList 要扫描的同步状态的设备
@param scanPeriod 扫描周期，最小1s，最大300s
@param callback 扫描回调
void startSyncScan(List<BleScanDevice> deviceList, @Size(min = 1, max = 300) int scanPeriod, @NonNull BleScanDeviceCallback callback)

6.5.4 停止扫描

所有扫描通用停止方法

xxxxxxxxxx
void stopScan();

6.6 血压

6.6.1 血压绑定设备接口

xxxxxxxxxx
@param deviceType 设备类型
@param callback 回调接口
@param deviceAddress 设备mac地址 可为空
void bindBpDevice(@NonNull String deviceType,@NonNull OmronBpBleCallBack callback, String deviceAddress);

6.6.2 血压同步数据接口

同步血压计测量数据：同步到血压计所有未同步过的血压数据。

xxxxxxxxxx
@param context
@param deviceType 设备类型
@param deviceName 设备名称
@param deviceAddress 设备mac地址
@param callback 回调接口
void getBpDeviceData(@NonNull String deviceType, @NonNull String deviceName,@NonNull String deviceAddress,@NonNull OmronBpBleCallBack callback);

6.6.3 血压计停止绑定流程

xxxxxxxxxx
void stopBpConnect();

6.6.4 开启血压计设备监听

调用该接口前须确保蓝牙开启；该接口不可与其他设备监听和数据同步接口同时使用。同步血压计所有未同步过的血压数据。 旧版方法，只能监听一个设备，不推荐。

xxxxxxxxxx
@param deviceType 设备类型
@param deviceName 设备名称
@param deviceAddress 设备mac地址
@param callBack 回调函数
void startBpMonitoring(@NonNull String deviceType, @NonNull String deviceName, @NonNull String deviceAddress,@NonNull OmronBpBleCallBack callback);

调用该接口前须确保蓝牙开启；该接口不可与其他设备监听和数据同步接口同时使用。同步血压计所有未同步过的血压数据。 可以同时监听多个设备，推荐。

xxxxxxxxxx
@param deviceList 要监听的血压设备
@param callBack 回调函数
void startBpMonitoring(@NonNull List<BleScanDevice> deviceList, @NonNull OmronBpBleCallBack callBack)

根据当前数据同步结果判断是否需要开启下次监听： OMRON_SDK_NoDevice、OMRON_SDK_ConnectFail、OMRON_SDK_TRANSFERFAIL和数据同步成功后继续监听，其他异常情况下停止监听

6.6.5 停止血压计设备监听

所有血压设备监听通用停止方法，退出监听时必须调用

xxxxxxxxxx
void stopBpMonitoring();

6.7 体脂

6.7.1 体脂绑定接口

xxxxxxxxxx
@param deviceType 设备类型
@param callback 绑定回调
@param birthday 生日
@param sex 性别
@param height 身高
void bindBfDevice(@NonNull String deviceType, OmronBfBleCallBack callback,
String birthday, String sex, String height);

6.7.2 绑定体脂设备机位

xxxxxxxxxx
@param userIndex 设备机位 1、2、3、4
void bindBfUserIndex(int userIndex);

6.7.3 体脂同步接口

xxxxxxxxxx
@param mDeviceType 设备类型
@param deviceAddress 设备mac地址
@param callback 回调接口
@param userIndex 设备机位
@param birthday 生日
@param sex 性别
@param height 身高
@param deviceId 设备ID
void getBfDeviceData(@NonNull String deviceType, @NonNull String deviceAddress, @NonNull OmronBfBleCallBack callback,
int userIndex, String birthday, String sex, String height, String deviceId);

6.7.4 停止体脂绑定或同步数据流程

xxxxxxxxxx
void stopBfConnect();

6.7.5 开启体脂仪设备监听

调用该接口前须确保蓝牙开启；该接口不可与其他设备监听和数据同步接口同时使用；

根据当前数据同步结果判断是否需要开启下次监听：

OMRON_SDK_NoDevice、OMRON_SDK_ConnectFail、OMRON_SDK_TRANSFERFAIL和数据同步成功后继续监听，其他异常情况下停止监听

旧版方法，只能监听一个设备，不推荐。

xxxxxxxxxx
@param mDeviceType 设备类型
@param deviceAddress 设备mac地址
@param callback 数据回调
@param userIndex 设备机位
@param birthday 用户生日
@param sex 用户性别
@param height 用户身高
@param deviceId 设备唯一标识
void startBfMonitoring(@NonNull String deviceType, @NonNull String deviceAddress, @NonNull OmronBfBleCallBack callback, int userIndex, String birthday, String sex, String height, String deviceId);

可以同时监听多个设备，推荐。

xxxxxxxxxx
@param deviceList 要监听的体脂设备
@param callback 数据回调
@param birthday 用户生日
@param sex 用户性别
@param height 用户身高
void startBfMonitoring(@NonNull List<BleScanDevice> deviceList, @NonNull OmronBfBleCallBack callback, String birthday, String sex, String height)

6.7.6 停止体脂仪设备监听

所有体脂设备监听通用停止方法，退出监听时必须调用

xxxxxxxxxx
void stopBfMonitoring();

6.8 血糖

6.8.1 血糖绑定接口

xxxxxxxxxx
@param deviceType 设备类型
@param callBack 绑定回调函数
@param device BluetoothDevice
void bindBgDevice(@NonNull String deviceType, @NonNull BluetoothDevice device, @NonNull OmronBgBleCallBack callBack);

6.8.2 血糖同步接口

xxxxxxxxxx
@param deviceType 设备类型
@param callBack 绑定回调函数
@param device BluetoothDevice
void getBgDeviceData(@NonNull String deviceType, @NonNull BluetoothDevice device, @NonNull OmronBgBleCallBack callBack);

6.8.3 停止血糖绑定或同步数据流程

xxxxxxxxxx
void stopBgConnect();

6.8.4 开启血糖仪设备监听

调用该接口前须确保蓝牙开启；该接口不可与其他设备监听和数据同步接口同时使用；

根据当前数据同步结果判断是否需要开启下次监听：

OMRON_SDK_NoDevice、OMRON_SDK_ConnectFail、OMRON_SDK_TRANSFERFAIL和数据同步成功后继续监听，其他异常情况下停止监听

旧版方法，只能监听一个设备，不推荐。

xxxxxxxxxx
@param mDeviceType 设备类型
@param deviceAddress 设备mac地址
@param callback 数据回调
void startBgMonitoring(@NonNull String deviceType, @NonNull String deviceAddress, @NonNull OmronBgBleCallBack callBack);

可以同时监听多个设备，推荐。

xxxxxxxxxx
@param deviceList 要监听的血糖设备
@param callback 数据回调
void startBgMonitoring(@NonNull List<BleScanDevice> deviceList, @NonNull OmronBgBleCallBack callBack)

6.8.5 停止血糖仪设备监听

所有血糖设备监听通用停止方法，退出监听时必须调用

xxxxxxxxxx
void stopBgMonitoring();

6.9 血氧

6.9.1 血氧绑定接口

xxxxxxxxxx
@param deviceType 设备类型
@param callBack 绑定回调函数
void bindBoDevice(@NonNull String deviceType, OmronBoBleCallBack callback);

6.9.2 血氧同步接口

xxxxxxxxxx
@param deviceType 设备类型
@param deviceName 设备名称
@param deviceAddress 设备mac地址
@param callBack 绑定回调函数
@param device BluetoothDevice
void getBoDeviceData(@NonNull String deviceType, @NonNull String deviceName ,@NonNull String deviceAddress, @NonNull OmronBoBleCallBack callback);

6.9.3 停止血氧绑定或同步数据流程

xxxxxxxxxx
void stopBoConnect();

6.9.4 开启血氧仪设备监听

调用该接口前须确保蓝牙开启；该接口不可与其他设备监听和数据同步接口同时使用；

根据当前数据同步结果判断是否需要开启下次监听：

OMRON_SDK_NoDevice、OMRON_SDK_ConnectFail、OMRON_SDK_TRANSFERFAIL和数据同步成功后继续监听，其他异常情况下停止监听

可以同时监听多个设备。

xxxxxxxxxx
@param deviceList 要监听的血氧设备
@param callback 数据回调
void startBoMonitoring(@NonNull List<BleScanDevice> deviceList, @NonNull OmronBoBleCallBack callback)

6.9.5 停止血糖仪设备监听

退出监听时必须调用

xxxxxxxxxx
void stopBoMonitoring();

6.10. 蓝牙连接状态取得

6.10.1 状态获取

xxxxxxxxxx
示例
OMRONLib.getInstance().setStatusBlock((OmronStateEnum type)->{
     BleLog.w("OMRONLib", "setStatusBlock  "+type);
});

/** 
 * OmronStateEnum 说明
 * 
    OMRONLIB_SCAN, //开始扫描
    OMRONLIB_CONNECT, //开始链接
    OMRONLIB_SYNC_DATA, //开始数据同步
    OMRONLIB_SYNC_DATA_SUCCESS, //数据同步成功
    OMRONLIB_SYNC_DATA_ERROR, //数据同步失败
    OMRONLIB_DISCONNECTED; //断开链接
 *
*/

6.10.2 注册监听

xxxxxxxxxx
void setStatusBlock(MonitorStatusBlock monitor)

6.10.3 取消监听

xxxxxxxxxx
void remStatusBlock(MonitorStatusBlock monitor)

6.11. 用户敏感信息可见等级

6.11.1 用户敏感信息可见等级说明

xxxxxxxxxx
OMRONLOG_NONE("0","不可见"),
OMRONLOG_ALL("1","可见"),
OMRONLOG_HALF("2","部分可见");

6.11.2 设置用户敏感信息可见等级

样例

xxxxxxxxxx
OmronLogVisibleUtil.setLogType(OMRONLOGENUM.OMRONLOG_HALF);

6.11.3 设置日志等级

样例

xxxxxxxxxx
OMRONLib.setLimitation(OmronLogLevelEnum.WARN);
/**  日志等级
 *   OmronLogLevelEnum:
    WARN(3),
    ERROR(4),
    FATAL(5);
*/

6.12 设备指纹

6.12.1 获取设备指纹

xxxxxxxxxx
String getDeviceFinger();

样例:

xxxxxxxxxx
OMRONLib.getInstance().getDeviceFinger();

7. SDK使用注意事项

7.1 个人信息说明

• DEMO的个人信息主要针对个人，绑定多台设备时，所有设备将同步为同一份个人信息

7.2 绑定个人信息说明

• 绑定时设备，demo会把个人信息界面输入的个人信息写入设备

7.3 同步个人信息说明

• 设备个人信息更改，demo个人信息未更改，同步时会读出设备里面的个人信息，并返回

• 设备个人信息未更改，demo个人信息更改，同步时会往设备里面写入demo更改的个人信息

• 设备更改一次，demo同时更改个人信息，同步时会往设备里面写入demo更改的个人信息

• 设备更改多次，demo同时更改个人信息，同步时会读出设备里面的个人信息