涵盖广，功能丰富。生活实用、效率办公、图片处理等等，还有隐藏的VIP功能，总之很多惊喜的功能。各大应用市场搜索【蜗牛工具箱】安装即可。
部分功能介绍（持续更新中...）
- 【滚动字幕】超实用应援打call神器，输入文字内容使文字在屏幕中滚动显示；
- 【振动器】可自定义振动频率、时长，达到各种有意思的效果；
- 【测量仪器】手机当直尺、水平仪、指南针、分贝仪；
- 【文件加解密】可加密任意文件，可用于私密文件分享；
- 【金额转大写】将阿拉伯数字类型的金额转成中文大写；
- 【通信调试】BLE/SPP蓝牙、USB、TCP/UDP/MQTT通信调试；
- 【二维码】调用相机扫描或扫描图片识别二维码，支持解析WiFi二维码获取密码，输入文字生成相应的二维码；
- 【图片模糊处理】将图片进行高斯模糊处理，毛玻璃效果；
- 【黑白图片上色】黑白图片变彩色；
- 【成语词典】查询成语拼音、释义、出处、例句；
- 【图片拼接】支持长图、4宫格、9宫格拼接；
- 【自动点击】自动连点器，解放双手；
- 【图片加水印】图片上添加自定义水印；
- 【网页定时刷新】设定刷新后自动定时刷新网页；
- 【应用管理】查看本机安装的应用详细信息，并可提取安装包分享。
点击下方按钮或扫码下载【蜗牛工具箱】
- 支持多设备同时连接
- 支持观察者监听或回调方式。注意：观察者监听和回调只能取其一！
- 支持使用注解@RunOn控制回调线程
- 支持设置回调或观察者的方法默认执行线程
- 因为使用了jdk8的一些特性，需要在module的build.gradle里添加如下配置：
//纯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'
}
}
}
- module的build.gradle中的添加依赖，自行修改为最新版本，commons-android 最新版本 ，同步后通常就可以用了：
dependencies {
...
implementation 'cn.wandersnail:classic-bluetooth:latestVersion'
//额外依赖
implementation 'cn.wandersnail:commons-android:latestVersion'
}
- 在project的build.gradle里的repositories添加内容，最好两个都加上，添加完再次同步即可。
allprojects {
repositories {
...
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
实例化有两种方式：
- 使用默认方式自动构建实例，直接获取实例即可
//实例化并初始化
BTManager.getInstance().initialize(application);
- 构建自定义实例，必须在BTManager.getInstance()之前！！
BTManager manager = BTManager.getBuilder()
.setExecutorService(executorService)//自定义线程池用来执行后台任务，也可使用默认
.setObserveAnnotationRequired(false)//不强制使用{@link Observe}注解才会收到被观察者的消息，强制使用的话，性能会好一些
.setMethodDefaultThreadMode(ThreadMode.MAIN)//指定回调方法和观察者方法的默认线程
.build();
manager.initialize(application);
//如果中途需要修改配置重新实例化，调用此方法后即可重新构建BTManager实例
BTManager.getInstance().destroy();
BTManager.isDebugMode = true;;//开启日志打印
-
定义搜索监听器
Android6.0以上搜索需要至少模糊定位权限，如果targetSdkVersion设置29以上需要精确定位权限。权限需要动态申请
private DiscoveryListener discoveryListener = new DiscoveryListener() {
@Override
public void onDiscoveryStart() {
//搜索开始
}
@Override
public void onDiscoveryStop() {
//搜索停止
}
/**
* 搜索到蓝牙设备
*
* @param device 搜索到的设备
* @param rssi 信号强度
*/
@Override
public void onDeviceFound(@NonNull BluetoothDevice device, int rssi) {
//搜索结果
}
@Override
public void onDiscoveryError(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;
}
}
};
- 添加监听
BTManager.getInstance().addDiscoveryListener(discoveryListener);
- 开始搜索
BTManager.getInstance().startDiscovery();
- 停止搜索
BTManager.getInstance().stopDiscovery();
- 停止监听
BTManager.getInstance().removeDiscoveryListener(discoveryListener);
- 定义观察者。实现EventObserver接口即可：
public class MainActivity extends AppCompatActivity implements EventObserver {
/**
* 使用{@link Observe}确定要接收消息，{@link RunOn}指定在主线程执行方法，设置{@link Tag}防混淆后找不到方法
*/
@Tag("onConnectionStateChanged")
@Observe
@RunOn(ThreadMode.MAIN)
@Override
public void onConnectionStateChanged(@NonNull BluetoothDevice device, int state) {
switch (state) {
case Connection.STATE_CONNECTING:
break;
case Connection.STATE_PAIRING:
break;
case Connection.STATE_PAIRED:
break;
case Connection.STATE_CONNECTED:
break;
case Connection.STATE_DISCONNECTED:
break;
case Connection.STATE_RELEASED:
break;
}
}
/**
* 如果{@link BTManager.Builder#setObserveAnnotationRequired(boolean)}设置为false时，无论加不加{@link Observe}注解都会收到消息。
* 设置为true时，必须加{@link Observe}才会收到消息。
* 默认为false，方法默认执行线程在{@link BTManager.Builder#setMethodDefaultThreadMode(ThreadMode)}指定
*/
@Observe
@Override
public void onRead(@NonNull BluetoothDevice device, @NonNull byte[] value) {
Log.d("BTManager", "收到数据：" + StringUtils.toHex(value, " "));
}
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
Log.d("BTManager", "写入结果：" + result);
}
}
- 注册观察者
BTManager.getInstance().registerObserver(observer);
- 取消注册观察者
BTManager.getInstance().unregisterObserver(observer);
- 建立指定设备指定UUID的连接
//UUIDWrapper.useDefault()，使用默认的UUID(00001101-0000-1000-8000-00805f9b34fb)
//UUIDWrapper.useCustom()，自定义UUID
connection = BTManager.getInstance().createConnection(device, UUIDWrapper.useDefault(), observer);//观察者监听连接状态
connection.connect(new ConnectCallback() {
@Override
public void onSuccess() {
}
@Override
public void onFail(@NonNull String errMsg, @Nullable Throwable e) {
}
});
- 断开连接，还可再次连接
BTManager.getInstance().disconnectConnection(device, UUIDWrapper.useDefault());//断开指定设备的指定UUID的连接
//BTManager.getInstance().disconnectAllConnections();//断开所有连接
- 释放连接，不可重连，需要重新建立连接
BTManager.getInstance().releaseConnection(device, UUIDWrapper.useDefault());//释放指定设备的指定UUID的连接
//BTManager.getInstance().releaseAllConnections();//释放所有连接
- 接收数据
上面说到的定义观察者。实现EventObserver接口，在onRead里接收数据。
- 写入数据
两种方式：
2.1 接口回调方式
/**
* 写数据，加入队列尾部
*
* @param tag 数据标识
* @param value 要写入的数据
* @param callback 写入回调。不为null时，写入结果以回调返回；传null时，写入结果以通知观察者方式返回
*/
connection.write(tag, value, new WriteCallback() {
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
}
});
/**
* 写数据，加入队列最前
*
* @param tag 数据标识
* @param value 要写入的数据
* @param callback 写入回调。不为null时，写入结果以回调返回；传null时，写入结果以通知观察者方式返回
*/
connection.writeImmediately(tag, value, new WriteCallback() {
@Override
public void onWrite(@NonNull BluetoothDevice device, @NonNull String tag, @NonNull byte[] value, boolean result) {
}
});
2.2 使用观察者模式接收结果
和接收数据一样，定义观察者。实现EventObserver接口，在onWrite里接收写入结果。
BTManager.getInstance().release();
-keep class * implements cn.wandersnail.commons.observer.Observe {
public <methods>;
}
