BleLib

---

BleLib是Android低功耗蓝牙4.0及以上开发的辅助库，一行代码解决Ble初始化、扫描、连接、读写、通知等操作。

BleLib中的关键类：

• BleService是单个Ble连接操作的服务类
• GattAttributes类中包含了蓝牙联盟规定的服务和特征的UUID值
• MultipleBleService类是可多个蓝牙设备同时连接的服务类

##Usage

###引入 BleLib库已上传至jcenter、maven central
因此，在你项目Module中的build.gradle文件中添加库依赖即可，如下：

dependencies {
    compile 'com.junkchen.blelib:blelib:1.0.4'
}

只此一句即可使用BleLib库，方便吧，要的就是这效果。

BleLib中的Ble继承了Service，因此建议绑定服务进行使用。

private ServiceConnection serviceConnection = new ServiceConnection() {
        @Override
        public void onServiceConnected(ComponentName name, IBinder service) {
            mBleService = ((BleService.LocalBinder) service).getService();
            if (mBleService != null) mHandler.sendEmptyMessage(SERVICE_BIND);
            if (mBleService.initialize()) {
                if (mBleService.enableBluetooth(true)) {
                    showDialog(getResources().getString(R.string.scanning));
                    mBleService.scanLeDevice(true);
                    Toast.makeText(BleScanActivity.this, "Bluetooth was opened", Toast.LENGTH_SHORT).show();
                }
            } else {
                Toast.makeText(BleScanActivity.this, "not support Bluetooth", Toast.LENGTH_SHORT).show();
            }
        }

        @Override
        public void onServiceDisconnected(ComponentName name) {
            mBleService = null;
            mIsBind = false;
        }
    };


private void doBindService() {
    Intent serviceIntent = new Intent(this, BleService.class);
    bindService(serviceIntent, serviceConnection, Context.BIND_AUTO_CREATE);
}

private void doUnBindService() {
    if (mIsBind) {
        unbindService(serviceConnection);
        mBleService = null;
        mIsBind = false;
    }
}

当服务绑定后就可以进行如下操作了：

mBleService.initialize();//Ble初始化操作  
mBleService.enableBluetooth(boolean enable);//打开或关闭蓝牙  
mBleService.scanLeDevice(boolean enable, long scanPeriod);//启动或停止扫描Ble设备  
mBleService.connect(String address);//连接Ble  
mBleService.disconnect();//取消连接  
mBleService.getSupportedGattServices();//获取服务  
mBleService.setCharacteristicNotification(BluetoothGattCharacteristic characteristic,
boolean enabled);//设置通知  
mBleService.readCharacteristic(BluetoothGattCharacteristic characteristic);//读取数据  
mBleService.writeCharacteristic(BluetoothGattCharacteristic characteristic, byte[] value);//写入数据  

设置监听回调接口，获取相应返回数据，获取扫描Ble结果、连接等操作也可以以接收广播的方式获取，但我个人觉得用监听的方式更好，广播有的值无法传递，而接口传递过来的是原始数据，在我的样例中有使用广播来接收扫描的结果和连接状态的改变。

//Ble扫描回调
mBleService.setOnLeScanListener(new BleService.OnLeScanListener() {
    @Override
    public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {

    }
});
//Ble连接回调
mBleService.setOnConnectListener(new BleService.OnConnectListener() {
    @Override
    public void onConnect(BluetoothGatt gatt, int status, int newState) {

    }
});
//Ble服务发现回调
mBleService.setOnServicesDiscoveredListener(new BleService.OnServicesDiscoveredListener() {
    @Override
    public void onServicesDiscovered(BluetoothGatt gatt, int status) {

    }
});
//Ble数据回调
mBleService.setOnDataAvailableListener(new BleService.OnDataAvailableListener() {
    @Override
    public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {

    }

    @Override
    public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {

    }
});

##License

BleLib is released under the Apache 2.0 license.

Copyright 2016 Junk Chen.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.