轻牛蓝牙Android SDK

快速集成

混淆配置(proguard-rules)

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

具体操作文档

具体集成说明文档

AndroidX适配

适配AndroidX的手环SDK

Android Studio 线上依赖

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

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

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

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

本地依赖

下载最新的jar和so库，导入下载的jar和so库

在清单文件中申请蓝牙权限、位置权限、网络权限（离线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" />
<!-- 前台服务权限，防止应用退到后台手环断开连接，1.0.9 之前版本需要，1.0.9之后不需要-->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<!-- 1.0.9 之前版本不需要，1.0.9之后需要-->
<uses-permission android:name="android.permission.WAKE_LOCK"/>

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


 <!-- 1.0.9 之前版本配置-->
<service android:name="com.qingniu.qnble.scanner.BleScanService"/>
<service android:name="com.qingniu.wrist.ble.WristBleService"/>
<service android:name="com.qingniu.scale.measure.ble.ScaleBleService" />
<service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService"/>


 <!-- 1.0.9 之后版本（包含1.0.9版本）配置-->
  <service android:name="com.qingniu.qnble.scanner.BleScanService" android:permission="android.permission.BIND_JOB_SERVICE"/>
  <service android:name="com.qingniu.wrist.ble.WristBleService" 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.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" />
  <service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService" android:permission="android.permission.BIND_JOB_SERVICE"/>

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

注意事项

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

常见问题

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

初始化提示appid错误
- 检查初始化文件和使用的appid是否匹配
- 检查引入的SDK是否是最新的
扫描设备调用成功，但是一直没有设备回调，且无错误回调
- 检查所扫描的设备，是否已经被其他人连接
- 部分手机需要开启GPS才能扫描到设备，请检查手机GPS是否开启
连接设备一直无法成功或者成功后很快就断开连接
- 检查设备是否被其他人连接了
- 在系统蓝牙中查看是否当前连接的设备已经被配对,如果已经配对，需要取消配对
- 部分手机需要先扫描才能连接成功，先扫描设备再进行连接
SDK返回无定位权限错误
- 检查是否对ACCESS_COARSE_LOCATION和ACCESS_FINE_LOCATION都进行了申请，SDK中对2个权限都进行了校验
- 是否编译版本26以及以上，如果是，2个权限都需要单独申请(8.0的新特性)

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

YolandaQingniu/SDK-Band-Android