English document

轻牛蓝牙Android SDK

快速集成

混淆配置(proguard-rules)

• -keep class com.qingniu.scale.model.BleScaleData{*;}

具体操作文档

具体集成说明文档

小程序入口

小程序接入文档

AndroidX适配

如果进行Androix的适配，请接入适配Androidx的SDK

Android Studio 线上依赖

• 在你工程的根目录下的 build.gradle添加jitpack支持

  allprojects {
   	repositories {
   		...
   		maven { url 'https://jitpack.io' }
   	}
   }
  

**注意：从低版本升级到2.3.6版本后，SDK的包名有变化，需要将包名中的com.yolanda.health.qnblesdk 改为 com.qn.device

• 在你的module的根目录下的build.gradle添加依赖

   <!--这里的版本号，2.3.14可以指定为任意release版本-->
   <!--如果希望一直使用最新版本可以替换 2.3.14 master-SNAPSHOT -->
   dependencies {
           ...
           compile 'com.github.YolandaQingniu:qnscalesdk:2.3.14'
   }
  

Android Studio 本地依赖

• 下载最新的jar和so库，导入下载的jar和so库
• 在app moudle 下建立libs文件夹，将so库和jar包放入libs 文件夹内。
• 在app moudle 的gradle文件中增加配置

 sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }

• 在清单文件中申请蓝牙权限、位置权限、网络权限（离线SDK不需要）

  <!--蓝牙权限-->
  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <!--6.0及之后需要动态申请-->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!--用来存储日志-->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <!--如果是在线的sdk需要网络权限-->
  <uses-permission android:name="android.permission.INTERNET" />
  <!--qnscalesdk:1.1.3-beta3 之前(包含1.1.3-beta3)的版本需要增加此权限，之后的版本不需要-->
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  
  <!--qnscalesdk:1.1.3-beta3 之后(1.1.3-beta4开始)的版本需要增加此权限，之前的版本不需要-->
    <uses-permission android:name="android.permission.WAKE_LOCK" />
  

• 需要在AndroidManifest.xml注册SDK中的组件：

  <!--qnscalesdk:1.1.3-beta3之前(包含1.1.3-beta3)的版本配置-->
  <service android:name="com.qingniu.qnble.scanner.BleScanService"/>
  <service android:name="com.qingniu.scale.measure.ble.ScaleBleService"/>
  <service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService"/>
  

  <!--qnscalesdk:1.1.3-beta3 之后(1.1.3-beta4开始)的版本配置-->
  <service android:name="com.qingniu.qnble.scanner.BleScanService" android:permission="android.permission.BIND_JOB_SERVICE"/>
  <service android:name="com.qingniu.scale.measure.ble.ScaleBleService" android:permission="android.permission.BIND_JOB_SERVICE"/>
  <service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService" android:permission="android.permission.BIND_JOB_SERVICE"/>
  <service android:name="com.qingniu.scale.wsp.ble.ScaleWspBleService" android:permission="android.permission.BIND_JOB_SERVICE" />
  <service android:name="com.qingniu.scale.measure.broadcast.ScaleFoodBroadcastService" android:permission="android.permission.BIND_JOB_SERVICE" />
  

• SDK中使用到了v4包的资源，开发者项目中需要引入v4包的资源

注意事项

• targetSdkVersion 在23及以上，需要先获取定位权限，才能扫描到设备，需要开发者自己申请
• 部分手机上使用蓝牙功能需要开启GPS才能扫描到设备，SDK中会输出GPS未开启的日志，但不会回调错误，开发者可以自主进行限制
• 如果你的项目是多进程的，建议限制在主进程才进行SDK的初始化

常见问题

具体使用参考API文档和Demo，以下为一些常见问题。

1. 初始化提示appid错误
   • 检查初始化文件和使用的appid是否匹配
   • 检查引入的SDK是否是最新的
2. 扫描设备调用成功，但是一直没有设备回调，且无错误回调
   • 检查所扫描的设备，是否已经被其他人连接
   • 部分手机需要开启GPS才能扫描到设备，请检查手机GPS是否开启
3. 连接设备一直无法成功或者成功后很快就断开连接
   • 检查设备是否被其他人连接了
   • 在系统蓝牙中查看是否当前连接的设备已经被配对,如果已经配对，需要取消配对
   • 部分手机需要先扫描才能连接成功，先扫描设备再进行连接
4. 获取到的指标与和商务洽谈的指标数不同
   • 先检查出现问题的设备，扫描时显示的名称是否正确
   • 心率秤无论是否开放了心率指标，SDK都会下发心率指标
5. 数据或者设备等监听回调，同一时间回调多次
   • 先确定是否，设置了多次监听。当监听不使用时，一定要设置为null
   • 确定是否是穿鞋测量，这个可能导致短时间内，完成多次测量的情况
6. SDK返回无定位权限错误
   • 检查是否对ACCESS_COARSE_LOCATION和ACCESS_FINE_LOCATION都进行了申请，SDK中对2个权限都进行了校验
   • 是否编译版本26以及以上，如果是，2个权限都需要单独申请(8.0的新特性)
7. SDK返回错误的文件,确认文件位置无异常，确认文件在demo中使用无异常
   • 检查是否有添加so库
   • 检查是否打包的apk文件中含有so库
8. SDK 集成后测量Native方法报错
   • 检查是否集成设置有问题
   • 本地集成不能和在线集成混合使用，只能选择一种方式

提示：遇到无法定位的问题，希望开发者能第一时间提供日志，以便我们尽快找到问题