# Sinocare_Detection_SDK_Android

**Repository Path**: sinocare-iot/Sinocare_Detection_SDK_Android

## Basic Information

- **Project Name**: Sinocare_Detection_SDK_Android
- **Description**: 三诺蓝牙SDK，集成了三诺各指标检测的仪器；
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2021-12-02
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


### 注意：此版本为新版SDK精简版 2.0.x，请前往[Gitee地址](https://gitee.com/sinocare-iot/Sinocare_Detection_SDK_Android) 或者[Github地址](https://github.com/snintelligent/Sinocare_Detection_SDK_Android).如需使用旧版SDK 1.2.x,请前往[Gitee地址](https://gitee.com/sinocare-iot/Sinocare_Detection_SDK_Android/tree/sinocare_ble_1.2.x/) 或者[Github地址](https://github.com/snintelligent/Sinocare_Detection_SDK_Android/tree/sinocare_ble_1.2.x)
### 温馨提示：若您仍在使用旧版SDK，建议您更新为新版SDK，连接更方便，数据更清晰，拓展更便捷。



# 1. 多指标设备接入SDK说明

Sinocare_Detection_SDK_Android
是三诺生物传感股份有限公司开发的设备连接的SDK，目前已接入包括三诺自有设备在内的20多款检测设设备；可以便捷的实现多款蓝牙设备的同时连接与数据接收，极大的简化了蓝牙设备的接入流程，接入用户只需要专注自身业务的开发，降低了用户接入蓝牙设备的开发成本；同时会为接入用户提供对应的技术支持，及时的响应客户的需求；

## 1.1 文件说明

Sinocare_Detection_SDK_Android 主要是通过aar方式提供给第三发软件开发使用.

## 1.2 使用设备的Android系统版本和蓝牙版本要求

		 设备（手机，平板，电视等）需支持android 5.0 及以上操作系统，支持蓝牙4.0，支持ble

# 2. 集成方法

## 2.1 接入前准备

提供app包名和keystore sha1指纹，用于生成sdk接入的access key; 由于debug keystore 和release
keystore的证书指纹不一致，为了保证app调试与正式上线后都能正常的鉴权成功，建议利用release keystore改造出一个debug版keystore保证两者证书指纹一致；

``` shell
//获取keystore 指纹命令
keytool -v -list -keystore sinocare-debug.jks

// keystore指纹命令，这里选取sha1指纹；注意：需要移除冒号：
证书指纹:
         SHA1: 72:D2:12:98:33:D3:12:88:E0:CB:6A:2C:77:65:F2:15:25:AE:61:26
签名算法名称: SHA256withRSA

```

## 2.2 SDK接入

在根目录build.gradle中加入如下配置

```powershell
allprojects {
    repositories {
        maven {
            url 'https://maven.aliyun.com/repository/public'
        }
           maven {
            credentials {
                username '64afa24d86937ebe0c2e4ce8'
                password 'wiOtEg=Cml2J'
            }
            url 'https://packages.aliyun.com/maven/repository/2446577-release-KBjwhA/'
        }
    }
}
```
## 2.3 SDK导包区别
### 2.3.1 在App 模块 build.gradle中配置 (注意此SDK必须要求项目支持Androidx)

```powershell

  implementation 'com.sinocare.androidx_lib:multicriteriasdk:2.2.1_lite'

```


## 2.4 配置manifest

manifest的配置主要包括添加权限,代码示例如下：

```powershell
    <!--蓝牙相关权限-->
    <uses-feature android:name="android.hardware.bluetooth_le" android:required="true" /> //只能安装在有蓝牙ble设备上
    <uses-permission android:name="android.permission.BLUETOOTH" /> // 声明蓝牙权限
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> //允许程序发现和配对蓝牙设备
          <!--Android12 的蓝牙权限 如果您的应用与已配对的蓝牙设备通信或者获取当前手机蓝牙是否打开-->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
    <!--Android12 的蓝牙权限 如果您的应用查找蓝牙设备（如蓝牙低功耗 (BLE) 外围设备）-->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
        android:usesPermissionFlags="neverForLocation"
        />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> //允许程序获取网络信息状态，如当前的网络连接是否有效
```
sdk access key配置，示例代码如下，在application标签下配置meta-data, key值sino_minute_access_key，value为申请的access key

``` xml
<application ...>

        <meta-data android:name="sino_minute_access_key"
            android:value="xxxxxxxxxxxxxxx"/>
	    
</application>
```

## 2.5 动态权限申请

如果targetSdkVersion 小于23，不需要6.0权限处理。如果是targetSdkVersion 大于等于23，需要6.0权限处理，则需要在启获取权限后，再开始连接

```java
           //申请权限
      RxPermissions rxPermissions = new RxPermissions(this);
         if(isAndroid12()){
              rxPermissions.request(Manifest.permission.BLUETOOTH_SCAN, Manifest.permission.BLUETOOTH_CONNECT)
              .subscribe(granted -> {
           
              });
         }else{
              rxPermissions.request(Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION)
              .subscribe(granted -> {
             
              });
         }
```



## 2.6 混淆说明

如果app进行混淆，请添加如下混淆配置，确保sdk中关键类不被混淆：

```xml
    -keep class com.sinocare.multicriteriasdk.utils.NoProguard

    -keep class * implements com.sinocare.multicriteriasdk.utils.NoProguard {*;}
```

# 3. 接口说明（公共接口）


## 3.1. 初始化SDK：

```Java
 
        MulticriteriaSDKManager.init(getApplication());
   
```

## 3.2 鉴权SDK：鉴权（只有鉴权通过，sdk才可以正常使用）；注意：不要反复鉴权或每次连接前都做一次鉴权，鉴权太频繁会增加鉴权失败的机率

```Java
 
        MulticriteriaSDKManager.authentication(AuthStatusListener authStatusListener);
   
```

####   AnthStatus鉴权返回状态码说明：

code | 说明
--- | ---
10000 | SDK鉴权成功
1080031007 | accessKey 不正确
1080031008 | 包名不正确
1080031009 | 签名不正确
10004 | 服务器或网络异常，服务器无法正常响应，具体错误查看msg

## 3.3 连接设备，数据获取


目前仪器测试完，数据直接会通过SDK回传。

####  SnDevices入参说明  （可见以下 #5 设备信息说明）

字段 | 说明 | 是否必填
---|--- |--- 
productCode | 设备类型|  是
dataProtocolCode | 协议类型 | 是
mac | mac地址 |  是
machineCode | 机器码 |  是
productName | 设备名字| 否
bleNamePrefix | 蓝牙前缀名字 | 否
imageUrl | 设备图片地址 | 否
isOpenProcessData | 是打开过程数据 | 否 (仅限于血氧，血压计，身高体重体脂称)
##### 示例：安稳{"bleNamePrefix":"BDE_WEIXIN_TTM","dataProtocolCode":"safe_aq_air_ble","imageUrl":"","isOpenProcessData":false,"mac":"04:7F:0E:10:57:37","machineCode":"0012","name":"安稳+Air血糖仪","productCode":"100004"}

```Java
/**
 * 第一种 默认就是开启扫描设备
 */
    MulticriteriaSDKManager.startConnect(snDevices,new SnCallBack(){
        @Override
        public void onDataComing(SNDevice device,BaseDetectionData data){
        //设备数据回调，解析见后面数据结构，实时测量数据与历史测量数据均在此处回调；
        }

         @Override
         public void onDetectionStateChange(SNDevice device,DeviceDetectionState state){
        //设备数据状态：时间同步成功、历史数据获取成功、清除成功等等
        }

         @Override
         public void onDeviceStateChange(SNDevice device,BoothDeviceConnectState state){
        //连接连接状态 目前只回调连接成功与断开连接
         }
    });
	
/**
 * 第二种 内部关闭扫描过程，直连设备 isScanningBluetooth 是否扫描蓝牙 (注意 开启扫描连接比直连稳定，但是速度快)
 */
   MulticriteriaSDKManager.startConnect(snDevices,boolean isScanningBluetooth，new SnCallBack(){}

```
#### 返回参数 示例 BaseDetectionData

参数名称|备注| 
---|--- |
code|  02 错误值, 04 当前测试值, 05 历史数据值, 20 历史数据序号, B7 测量过程值, 0E 历史数据补发| 
data|  返回内容| 
msg| 描述| 

#### 返回参数 data  (result返回详细字段描述请见以下示例)(result返回错误码请见6.4)
type | 指标类型说明 | 
---|--- |
bloodGlucose | 血糖| 
bloodLipids | 血脂| 
bloodPressure | 血压| 
uricAcid | 血尿酸| 
bloodKetone | 血酮| 
urinalysis | 尿常规| 
bloodOxygen | 血氧| 
temperature | 温度| 
acr | 生化| 
ferritin | 铁蛋白| 
HbA1c | 糖化血红蛋白| 
Crea | 肌酐| 
HGB | 血红蛋白|
HeightAndWeight | 身高体脂体脂称|
multipleTypes | 多类型指标|
lac | 血乳酸|

#### 仪器返回格式详细请见 [文件地址](https://gitee.com/sinocare-iot/Sinocare_Detection_SDK_Android/blob/master/SDK%E8%AE%BE%E5%A4%87%E8%BF%94%E5%9B%9E%E6%A0%BC%E5%BC%8F.xlsx)
```json
 示例1 血糖 type=bloodGlucose
{
  "code": "04", // 04 当前测试值 , 05 历史数据值 ,02 错误值
  "data": {
  "result": {
    "GLU": {
      "value": "1.2",
      "unit": "mmol/L"
    }
  },
  "sampleType": "血糖",
  "testTime": "2022-07-13 15:41:07",
  "type": "bloodGlucose"

  },
  "msg": "当前测试值"
}

示例2 尿酸 type=uricAcid
{
  "code": "04", // 04 当前测试值 , 05 历史数据值 ,02 错误值
  "data": {
    "result": {
      "UA": {
        "value": "200",
        "unit": "μmol/L"
      }
    },
    "sampleType": "血尿酸",
    "testTime": "2022-07-13 15:41:07",
    "type": "uricAcid"

  },
  "msg": "当前测试值"
}

示例3    血脂 type=bloodLipids
{
  "code": "04",
  "data": {
    "result": {
      "CHOL": {
        "value": "2.72",
        "unit": "mmol/L"
      },
      "HDLC": {
        "value": "2.42",
        "unit": "mmol/L"
      },
      "LDLC": {
        "value": "----",
        "unit": "mmol/L"
      },
      "LDLCHDLC": {
        "value": "----"
      },
      "NONHDLC": {
        "result": "0.30",
        "unit": "mmol/L"
      },
      "TCHDLC": {
        "value": "1.12"
      },
      "TG": {
        "value": "5.45",
        "unit": "mmol/L"
      }
    },
    "testTime": "2020-07-03 09:28:01",
    "type": "bloodLipids"
  },
  "msg": "当前测试值"
}


示例4 血压计 type=bloodPressure

{
	"code": "04",  
	"data": {
		"result": {
			"BloodMeasureHigh ":{
			  "value":"95",
              "unit":"mmHg"
		    },
			"BloodMeasureLow ":{
              "value":"64",
              "unit":"mmHg"
			},
			"P":{
              "value":"81"
			}
		},
        "testTime ":"2022-07-13 15:30:47",
        "type":"bloodPressure"
	},
	"msg": "当前测试值"
}


```


##  给设备发送指令；

SampleType 样本类型

```java
public class SampleType implements Parcelable {
    //血糖
    public static final String INDEX_1_BLOOD = "0001";
    //血糖质控液
    public static final String INDEX_2_SUGER_SIMULATED_FLUID = "0002";
    //血酮
    public static final String INDEX_3__KETONE_BLOOD = "0003";
    //血酮质控液
    public static final String INDEX_4__KETONE_SIMULATED_FLUID = "0004";
    //尿酸
    public static final String INDEX_5_URIC_ACID_BLOOD = "0005";
    //尿酸质控液
    public static final String INDEX_6_URIC_ACID_SIMULATED_FLUID = "0006";
    //尿液
    public static final String INDEX_9_URINE = "0009";
    //肌酐
    public static final String INDEX_10_CREATINE_BLOOD = "0010";
    //肌酐质控液
    public static final String INDEX_11_CREATINE_SIMULATED_FLUID = "0011";
    //血红蛋白
    public static final String INDEX_12_HGB_BLOOD = "0012";
    //血红蛋白质控液
    public static final String INDEX_13_HGB_SIMULATED_FLUID = "0013";
    //血乳酸
    public static final String INDEX_14_LAC_BLOOD = "0014";
    //血乳酸质控液
    public static final String INDEX_15_LAC_SIMULATED_FLUID = "0015";
    
	//其他
	public static final String INDEX_9999_Other = "9999";

}

```

## 3.4 获取仪器历史测量结果；注意：仪器在滴血状态和测量状态可能无法响应此指令；

```java

/**
 * 获取设备历史数据
 * @param snDevice
 * @param SampleType   SampleType.XXX   要获取的样本类型
 */
MulticriteriaSDKManager.getHistoryData(SNDevice snDevice,String sampleType);

```
```java

/**
 * 清除设备历史数据
 * @param snDevice
 * @param SampleType   SampleType.XXX   要清除的样本类型 （不传入则清除所有）
 */
MulticriteriaSDKManager.clearHistoryData(SNDevice snDevice,String sampleType);

```

## 3.5 设置设备时间
```java

/**
 * 设置设备时间
 * @param snDevice
 * @param millisconds   时间戳
 */
MulticriteriaSDKManager.setDeviceTime(SNDevice snDevice, long millisconds);

```

## 3.6 断开连接

```java
   MulticriteriaSDKManager.disConectDevice(snDevices);
```
## 3.7 退出App


```java
     MulticriteriaSDKManager.finishAll();
```
# 4 差异设备调用方法

## 4.1 碳系列平台 见 （目录5设备信息说明）

### 4.1.0 获取历史序号

```java
/**
 * 获取历史序号
 * @param snDevice
 * @param sampleType   样本类型见以上SampleType
 */
 
 MulticriteriaSDKManager.getHistoryOrderNumber(SNDevice snDevice, String sampleType);
```

### 4.1.1 通过序号来获取指定历史数据

```java

/**
 * 获取设备历史数据
 * @param snDevice
 * @param SampleType   SampleType.XXX   要获取的样本类型
  @param orderNumber   历史数据序号
 */
 MulticriteriaSDKManager.getHistoryData(SNDevice snDevice, String sampleType, int orderNumber);

```

### 4.1.2 关闭声音

```java

/**
 * 获取设备历史数据
 * @param snDevice
 * @param isTurnSoundOff   true 关闭，false 打开   是否关闭声音
 */
 MulticriteriaSDKManager.setVoiceSwitch(SNDevice snDevice, boolean isTurnSoundOff);

```

## 4.2 安诺心诺凡血压计

### 4.2.0 开始测量
```java

 MulticriteriaSDKManager.startMeasuring();

```

# 5 设备信息说明  
## 5.1 ([详细设备请见项目目录/app/assets/deviceInfo.json文件](./app/assets/deviceInfo.json))

设备名称型号 | 设备指标 | 蓝牙名称                         |协议类型(dataProtocolCode)  |  机器码(协议版本)(machineCode) |  设备图片                                                                                                                  |
---|--- |------------------------------|--- |------------------|------------------------------------------------------------------------------------------------------------------------|
（碳系列）UA Pro尿酸测试仪     | 尿酸     | SN-6T                        | sino_standard_ble_01 | 2000 （以项目json文件为准） | ![UA Pro尿酸](https://sino-iot-prd.oss-cn-hangzhou.aliyuncs.com/upload/20220826/4d2f73b3c403c4c1a9fcbce652559d24.png)      |
（碳系列）优智SC301    | 血糖     | SN-5L                        | sino_standard_ble_01 | 2000 （以项目json文件为准） | ![优智SC301](https://sino-iot-prd.oss-cn-hangzhou.aliyuncs.com/upload/20220509/3cea1615c3a5b186ea1e4b95ec289082.png?)    
（碳系列）智惠GM501    | 血糖     | SN-5J                        | sino_standard_ble_01 | 2000 （以项目json文件为准） | ![智惠GM501](https://sino-iot-prd.oss-cn-hangzhou.aliyuncs.com/upload/20220509/b6c557d91f8e14392af0a547ba01cc98.png?)    
...   | ...  | ...             | ...                    | ...                    | ...

# 6 常见问题

## 6.1 蓝牙设备上显示蓝牙已被连接，但SnCallBack没有回调连接状态，和测量结果；

首先考虑鉴权是否通过，通过``` AuthUtils.isAuthValid()```查看当时鉴权是否成功，也可以在初始化鉴权过程中监听鉴权状态回调；

## 6.2 测量指标字段；
result | 指标名称 | result | 指标名称 |result | 指标名称 |
---|--- |---|--- |---|--- |
GLU|血糖|MALB|尿微量白蛋白|Ca|尿钙|
KET|血酮|UCr|尿微量白蛋白/尿肌酐|MA|微白蛋白|
UA|血尿酸|ACR|尿微量白蛋白/尿肌酐|PEF|呼气流量峰值，仪器测量原始值|
HbA1c|糖化血红蛋白|FER|铁蛋白|FEV1|第一秒用力呼气量，仪器测量原始值|
TG|甘油三脂|WBC|尿白细胞|FVC|用力肺活量，仪器测量原始值|
CHOL|总胆固醇|UKET|尿酮体|MEF75|MEF75值|
HDLC|高密度脂蛋白胆固醇|NIT|尿亚硝酸盐|MEF50|MEF50值|
LDLC|低密度脂蛋白胆固醇|URO|尿胆原|MEF25|MEF25值|
TCHDLC|总胆/高密|BIL|尿胆红素|MMEF|MMEF值|
LDLCHDLC|低密度/高密度比值|PRO|尿蛋白质|DATA500|500组曲线数组|
NONHDLC|非高密度脂蛋白胆固醇|UGLU|尿糖|
BloodMeasureHigh|收缩压|SG|尿比重|
BloodMeasureLow|舒张压|BLD|隐血|
P|脉博|pH|酸碱度|
SPO2|血氧饱和度|VC|维生素 C|
T|体温|Crea| 血肌酐|

## 6.3错误码对照表,请下载到本地；

[错误码对照表](https://github.com/snintelligent/Sinocare_Detection_SDK_Android/wiki)