android IBeacon 开发(二)修改IBeacon参数
开发(一)中,我们介绍了怎么扫描到IBeacon。这节我们去看看怎么修改IBeacon的参数。
IBeacon里的参数,主要有这几个
name:设备名称
major:主参数
minor:副参数
mac:mac地址
UUID:IBeacon的UUID,相当与使用这个模块对映的应用的标识
rssi:信号强度
txPower:1m距离的信号强度参考值,他和rssi通过公司,可大体计算出距离来
通过上一章的扫描,我们获得了一个IBeacon的列表ArrayList,当我们想修改某个IBeacon的信息的时候,就要用到这个IBeacon的mac了
通过点击等等方式呢,我们可以获得某IBeacon的mac,
1 /** 2 * Connects to the GATT server hosted on the Bluetooth LE device. 3 * 4 * @param address 5 * The device address of the destination device. 6 * @return Return true if the connection is initiated successfully. The 7 * connection result 8 * is reported asynchronously through the 9 * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} 10 * callback. 11 */ 12 public boolean connect(final String address) 13 { 14 if (mBluetoothAdapter == null || address == null) 15 { 16 Log.w(TAG, "BluetoothAdapter not initialized or unspecified address."); 17 return false; 18 } 19 20 // Previously connected device. Try to reconnect. 21 if (mBluetoothDeviceAddress != null && address.equals(mBluetoothDeviceAddress) && mBluetoothGatt != null) 22 { 23 Log.d(TAG, "Trying to use an existing mBluetoothGatt for connection."); 24 if (mBluetoothGatt.connect()) 25 { 26 return true; 27 } 28 else 29 { 30 return false; 31 } 32 } 33 34 final BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address); 35 if (device == null) 36 { 37 Log.w(TAG, "Device not found. Unable to connect."); 38 return false; 39 } 40 // We want to directly connect to the device, so we are setting the autoConnect 41 // parameter to false. 42 mBluetoothGatt = device.connectGatt(mContext, false, mGattCallback); 43 Log.d(TAG, "Trying to create a new connection."); 44 mBluetoothDeviceAddress = address; 45 return true; 46 } 47
根据大神的代码呢,我们connect (mac地址),这样呢我们就可以获得BluetoothGatt。但是,连接完成了,再干嘛???
我们少了N步。
在大神的代码BluetoothLeClass类里,我们看到了好几个接口,这些接口是干嘛的?
OnConnectListener:当连接成功时调用
OnDisconnectListener:连接关闭是调用
OnServiceDiscoverListener:当services被发现的时候调用
OnDataAvailableListener:当有数据交互的时候调用
这里有个问题了,services是啥,是干神马的?
看了大神的解释,还是一头雾水啊。然后我就去看了BLE蓝牙的协议栈和其他N种东西,搞明白了他。
services是这样滴。每个IBeacon 都是基于BLE的,而BLE信息交互的时候,需要有个东西当接口啊,services就是这种东东。
就例如 BLE要做一个钟表,那就得有个service能不断的发送当前时间给显示器,like
同理,我们和IBeacon 通信,就是去调用BLE里的某个Service。
我们知道IBeacon里的参数有好几个呢,一个service够吗?跟你说,够了。
每个service下边还有多个Characteristic,就相当于service是端口,Characteristic是程序,不同的程序处理不同的东西,但数据都通过同一个端口(service)进出。
当然,service下边还有多个Descriptor,就是描述符,没啥大用。
对了,services,Characteristic这些东东,都是通过UUID来标识的,就相当于UUID是service、Characteristic的名字一样。
下边我们看看大神定义的接口都是怎么工作的。
1 // Implements callback methods for GATT events that the app cares about. For example, 2 // connection change and services discovered. 3 private final BluetoothGattCallback mGattCallback = new BluetoothGattCallback() 4 { 5 @Override 6 public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) 7 { 8 Log.e(TAG, "onConnectionStateChange完成"); 9 if (newState == BluetoothProfile.STATE_CONNECTED) 10 { 11 if (mOnConnectListener != null) 12 mOnConnectListener.onConnect(gatt); 13 Log.i(TAG, "Connected to GATT server."); 14 // Attempts to discover services after successful connection. 15 Log.i(TAG, "Attempting to start service discovery:" + mBluetoothGatt.discoverServices()); 16 17 } 18 else if (newState == BluetoothProfile.STATE_DISCONNECTED) 19 { 20 if (mOnDisconnectListener != null) 21 mOnDisconnectListener.onDisconnect(gatt); 22 Log.i(TAG, "Disconnected from GATT server."); 23 } 24 } 25 26 @Override 27 public void onServicesDiscovered(BluetoothGatt gatt, int status) 28 { 29 Log.e(TAG, "onServicesDiscovered完成"); 30 if (status == BluetoothGatt.GATT_SUCCESS && mOnServiceDiscoverListener != null) 31 { 32 mOnServiceDiscoverListener.onServiceDiscover(gatt); 33 } 34 else 35 { 36 Log.w(TAG, "onServicesDiscovered received: " + status); 37 } 38 } 39 40 @Override 41 public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) 42 { 43 Log.e(TAG, "onCharacteristicRead完成"); 44 if (mOnDataAvailableListener != null) 45 mOnDataAvailableListener.onCharacteristicRead(gatt, characteristic, status); 46 } 47 48 @Override 49 public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) 50 { 51 Log.e(TAG, "onCharacteristicWrite完成"); 52 if (mOnDataAvailableListener != null) 53 mOnDataAvailableListener.onCharacteristicWrite(gatt, characteristic, status); 54 } 55 @Override 56 public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) 57 { 58 Log.e(TAG, "onCharacteristicChanged完成"); 59 if (mOnDataAvailableListener != null) 60 mOnDataAvailableListener.onCharacteristicChanged(gatt, characteristic); 61 } 62 };
这里我改了下代码,
1 public interface OnDataAvailableListener 2 { 3 public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status); 4 5 public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic); 6 7 public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status); 8 }
OnConnectListener、OnDisconnectListener这两个接口,一看就是一对
onCharacteristicRead、onCharacteristicWrite、onCharacteristicChanged这三个,从函数名上也能看出作用来。
那么,定义好这些个listener,嗯,C#里边就是委托了,我就就得看看他是怎么工作的了。
本文一开始就说connect函数了,当connect成功后,就回去调用 onConnectionStateChange(连接状态改变事件),然后根据某值,分离出是连接成功还是连接失败。
在大神的代码了,我看到了调用OnConnectListener,但是怎么发现service呢。
大神开了个玩笑啊,将最重要的一句代码写在了Log.i里边,我狂晕啊,找了好半天呢。
mBluetoothGatt.discoverServices()就这句。。。。。。解释一下这句代码?——发现service
发现services,发现的services在哪?
好吧,android还是调用回调,onServicesDiscovered
发现services完成后,调用onServiceDiscover,这样我们就能获得BluetoothGatt,然后调用BluetoothGatt.getServices()获取所有的services了,当然你还可以根据你所开发的IBeacon的文档中定义的service的UUID,通过调用BluetoothGatt.getService(某个UUID)直接找这个service。
我所用的service的UUID是 0000fff0-0000-1000-8000-00805f9b34fb
我们获取了service,就可以通信了。
1 private void displayGattServices(List<BluetoothGattService> gattServices) 2 { 3 if (gattServices == null) 4 return; 5 6 for (BluetoothGattService gattService : gattServices) 7 { 8 //-----Service的字段信息-----// 9 int type = gattService.getType(); 10 Log.e(TAG, "-->service type:" + Utils.getServiceType(type)); 11 Log.e(TAG, "-->includedServices size:" + gattService.getIncludedServices().size()); 12 Log.e(TAG, "-->service uuid:" + gattService.getUuid()); 13 14 //-----Characteristics的字段信息-----// 15 List<BluetoothGattCharacteristic> gattCharacteristics = gattService.getCharacteristics(); 16 for (final BluetoothGattCharacteristic gattCharacteristic : gattCharacteristics) 17 { 18 Log.e(TAG, "---->char uuid:" + gattCharacteristic.getUuid()); 19 20 int permission = gattCharacteristic.getPermissions(); 21 Log.e(TAG, "---->char permission:" + Utils.getCharPermission(permission)); 22 23 int property = gattCharacteristic.getProperties(); 24 Log.e(TAG, "---->char property:" + Utils.getCharPropertie(property)); 25 26 byte[] data = gattCharacteristic.getValue(); 27 if (data != null && data.length > 0) 28 { 29 Log.e(TAG, "---->char value:" + new String(data)); 30 } 31 32 //UUID_KEY_DATA是可以跟蓝牙模块串口通信的Characteristic 33 if (gattCharacteristic.getUuid().toString().equals(UUID_KEY_DATA)) 34 { 35 //测试读取当前Characteristic数据,会触发mOnDataAvailable.onCharacteristicRead() 36 mHandler.postDelayed(new Runnable() 37 { 38 @Override 39 public void run() 40 { 41 mBLE.readCharacteristic(gattCharacteristic); 42 } 43 }, 500); 44 45 //接受Characteristic被写的通知,收到蓝牙模块的数据后会触发mOnDataAvailable.onCharacteristicWrite() 46 mBLE.setCharacteristicNotification(gattCharacteristic, true); 47 //设置数据内容 48 byte[] bytes = new byte[6]; 49 50 bytes[0] = 1; 51 bytes[1] = 2; 52 bytes[2] = 3; 53 bytes[3] = 4; 54 bytes[4] = 5; 55 bytes[5] = 6; 56 gattCharacteristic.setValue("123456"); 57 //往蓝牙模块写入数据 58 mBLE.writeCharacteristic(gattCharacteristic); 59 Log.v(TAG, "写入"); 60 } 61 62 //-----Descriptors的字段信息-----// 63 List<BluetoothGattDescriptor> gattDescriptors = gattCharacteristic.getDescriptors(); 64 for (BluetoothGattDescriptor gattDescriptor : gattDescriptors) 65 { 66 Log.e(TAG, "-------->desc uuid:" + gattDescriptor.getUuid()); 67 int descPermission = gattDescriptor.getPermissions(); 68 Log.e(TAG, "-------->desc permission:" + Utils.getDescPermission(descPermission)); 69 70 byte[] desData = gattDescriptor.getValue(); 71 if (desData != null && desData.length > 0) 72 { 73 Log.e(TAG, "-------->desc value:" + new String(desData)); 74 } 75 } 76 } 77 }// 78 79 }
大神的代码里,把所有的services,Characteristic都显示出来了,每个Characteristic也都读取了一遍。然后又在 UUID_KEY_DATA 表示的那个Characteristic里边写了点什么。
一开始我不太懂,为啥还得等500毫秒,后来我知道了,BLE是单双工通信的。
解释一下,“双工通信”是指的两边都可以发送信息,也都可以接收信息,“单”代表通信双方不能同时收发信息。
就是说,我发送信息(读、写)给IBeacon,在IBeacon返回信息之前,我不能有任何操作。
好了,言归正传。
我们只看到了mBLE.readCharacteristic(gattCharacteristic);mBLE.writeCharacteristic(gattCharacteristic);,但是读写出来的数据呢?
在这个mBLE.setCharacteristicNotification(gattCharacteristic, true);之前的注释里,我们看到
//接受Characteristic被写的通知,收到蓝牙模块的数据后会触发mOnDataAvailable.onCharacteristicWrite()
好吧,我们知道了,他会去调用mOnDataAvailable里的函数。
大体流程就是这样滴。