代码拉取完成,页面将自动刷新
同步操作将从 一头不安分的蜗牛/easyble-x 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
第一次进入是主页的话,重新再进一次就是应用详情页了
//纯java的项目
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
//有kotlin的项目还需要在project的build.gradle里添加
allprojects {
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
kotlinOptions {
jvmTarget = '1.8'
apiVersion = '1.3'
languageVersion = '1.3'
}
}
}
dependencies {
...
implementation 'cn.wandersnail:easyble-x:latestVersion'
//额外三个依赖
implementation 'cn.wandersnail:common-utils:latestVersion'
implementation 'cn.wandersnail:common-observer:latestVersion'
implementation 'cn.wandersnail:common-poster:latestVersion'
//也可以使用
//implementation 'cn.wandersnail:common-full:latestVersion'//此依赖包含上面三个
}
allprojects {
repositories {
...
mavenCentral()
maven { url 'https://dl.bintray.com/wandersnail/androidx/' }
}
}
实例化有两种方式:
//实例化并初始化
EasyBLE.getInstance().initialize(this);
ScanConfiguration scanConfig = new ScanConfiguration()
.setScanSettings(new ScanSettings.Builder()
.setScanMode(ScanSettings.SCAN_MODE_BALANCED)//搜索模式
.build())
.setScanPeriodMillis(15000)//搜索周期
.setAcceptSysConnectedDevice(true)//是否将系统蓝牙已连接的设备放到搜索结果中
.setOnlyAcceptBleDevice(true);//是否过滤非ble设备
EasyBLE ble = EasyBLE.getBuilder().setScanConfiguration(scanConfig)
.setScannerType(ScannerType.LE)//指定蓝牙扫描器,默认为系统Android5.0以上使用ScannerType.LE
.setExecutorService(executorService)//自定义线程池用来执行后台任务,也可使用默认
.setDeviceCreator(creator)//设备实例构建器。返回搜索结果时的设备对象由此构建器实例化
.setObserveAnnotationRequired(false)//不强制使用{@link Observe}注解才会收到被观察者的消息,强制使用的话,性能会好一些
.setMethodDefaultThreadMode(ThreadMode.MAIN)//指定回调方法和观察者方法的默认线程
.build();
ble.initialize(this);
//如果中途需要修改配置重新实例化,调用此方法后即可重新构建EasyBLE实例
EasyBLE.getInstance().destroy();
EasyBLE.getInstance().setLogEnabled(true);//开启日志打印
定义搜索监听器
Android6.0以上搜索需要至少模糊定位权限,如果targetSdkVersion设置29以上需要精确定位权限。权限需要动态申请
private ScanListener scanListener = new ScanListener() {
@Override
public void onScanStart() {
//搜索开始
}
@Override
public void onScanStop() {
//搜索停止
}
/**
* 搜索到BLE设备
*
* @param device 搜索到的设备
* @param isConnectedBySys 是否已被系统蓝牙连接上
*/
@Override
public void onScanResult(@NonNull Device device, boolean isConnectedBySys) {
//搜索结果
}
@Override
public void onScanError(int errorCode, @NotNull String errorMsg) {
switch(errorCode) {
case ScanListener.ERROR_LACK_LOCATION_PERMISSION://缺少定位权限
break;
case ScanListener.ERROR_LOCATION_SERVICE_CLOSED://位置服务未开启
break;
case ScanListener.ERROR_SCAN_FAILED://搜索失败
break;
}
}
};
EasyBLE.getInstance().addScanListener(scanListener);
EasyBLE.getInstance().startScan();
EasyBLE.getInstance().stopScan();
EasyBLE.getInstance().removeScanListener(scanListener);
public class MainActivity extends AppCompatActivity implements EventObserver {
/**
* 使用{@link Observe}确定要接收消息,{@link RunOn}指定在主线程执行方法,设置{@link Tag}防混淆后找不到方法
*/
@Tag("onConnectionStateChanged")
@Observe
@RunOn(ThreadMode.MAIN)
@Override
public void onConnectionStateChanged(@NonNull Device device) {
switch (device.getConnectionState()) {
case SCANNING_FOR_RECONNECTION:
break;
case CONNECTING:
break;
case DISCONNECTED:
break;
case SERVICE_DISCOVERED:
break;
}
}
/**
* 使用{@link Observe}确定要接收消息,方法在{@link EasyBLEBuilder#setMethodDefaultThreadMode(ThreadMode)}指定的线程执行
*/
@Observe
@Override
public void onNotificationChanged(@NonNull Request request, boolean isEnabled) {
if (request.getType() == RequestType.SET_NOTIFICATION) {
if (isEnabled) {
Log.d("EasyBLE", "通知开启了");
} else {
Log.d("EasyBLE", "通知关闭了");
}
} else {
if (isEnabled) {
Log.d("EasyBLE", "Indication开启了");
} else {
Log.d("EasyBLE", "Indication关闭了");
}
}
}
/**
* 如果{@link EasyBLEBuilder#setObserveAnnotationRequired(boolean)}设置为false时,无论加不加{@link Observe}注解都会收到消息。
* 设置为true时,必须加{@link Observe}才会收到消息。
* 默认为false,方法默认执行线程在{@link EasyBLEBuilder#setMethodDefaultThreadMode(ThreadMode)}指定
*/
@Override
public void onCharacteristicWrite(@NonNull Request request, @NonNull byte[] value) {
Log.d("EasyBLE", "成功写入:" + StringUtils.toHex(value, " "));
}
}
EasyBLE.getInstance().registerObserver(observer);
EasyBLE.getInstance().unregisterObserver(observer);
//连接配置,举个例随意配置两项
ConnectionConfiguration config = new ConnectionConfiguration();
config.setConnectTimeoutMillis(10000);
config.setRequestTimeoutMillis(1000);
connection = EasyBLE.getInstance().connect(device, config);//观察者监听连接状态
EasyBLE.getInstance().disconnectConnection(device);//断开指定连接
//EasyBLE.getInstance().disconnectAllConnections();//断开所有连接
EasyBLE.getInstance().releaseConnection(device);//释放指定连接
//EasyBLE.getInstance().releaseAllConnections();//释放所有连接
两种方式:
//开关通知
boolean isEnabled = connection.isNotificationOrIndicationEnabled(serviceUuid, characteristicUuid);
Request.Builder<NotificationChangeCallback> builder = Request.getSetNotificationBuilder(serviceUuid, characteristicUuid, !isEnabled);
//不设置回调,使用观察者模式接收结果
builder.build().execute(connection);
//读取特征值
Request.Builder<ReadCharacteristicCallback> builder = Request.getReadCharacteristicBuilder(serviceUuid, characteristicUuid);
builder.setTag(UUID.randomUUID().toString());
builder.setPriority(Integer.MAX_VALUE);//设置请求优先级
//设置了回调则观察者不会收到此次请求的结果消息
builder.setCallback(new ReadCharacteristicCallback() {
//注解可以指定回调线程
@RunOn(ThreadMode.BACKGROUND)
@Override
public void onCharacteristicRead(@NonNull Request request, @NonNull byte[] value) {
Log.d("EasyBLE", "主线程:" + (Looper.getMainLooper() == Looper.myLooper()));
Log.d("EasyBLE", "读取到特征值:" + StringUtils.toHex(value, " "));
}
//不使用注解指定线程的话,使用构建器设置的默认线程
@Override
public void onRequestFailed(@NonNull Request request, int failType, @Nullable Object value) {
}
});
builder.build().execute(connection);
//写特征值
Request.WriteCharacteristicBuilder builder = Request.getWriteCharacteristicBuilder(serviceUuid, characteristicUuid, "test write".getBytes());
//根据需要设置写入配置
builder.setWriteOptions(new WriteOptions.Builder()
.setPackageSize(20)
.setPackageWriteDelayMillis(5)
.setRequestWriteDelayMillis(10)
.setWaitWriteResult(true)
.setWriteType(BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT)
.build());
//不设置回调,使用观察者模式接收结果
connection.execute(builder.build());
EasyBLE.getInstance().release();
-keep class * implements cn.wandersnail.commons.observer.Observe {
public <methods>;
}
#保持 Serializable 不被混淆
-keep class * implements cn.wandersnail.ble.Request {
!private *;
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。