android BLE Peripheral 手机模拟设备发出BLE广播 BluetoothLeAdvertiser

Posted 2020-12-03 brave-sailor

android 从4.3系统开始可以连接BLE设备，这个大家都知道了。ios是从7.0版本开始支持BLE。

android 进入5.0时代时，开放了一个新功能，手机可以模拟设备发出BLE广播， 这个新功能其实是 对标于 iOS系统的手机模拟iBeacon设备。


先介绍一下BLE的广播， BLE设备之所以能被手机扫描到，是因为 BLE设备一直在每隔 一段时间广播一次，这个广播里面包含很多数据。

手机扫描BLE设备代码如下：

        public void startScan(){
            bluetoothAdapter.startLeScan(leScanCallback);
        }
 
    public void stopScan(){
        bluetoothAdapter.stopLeScan(leScanCallback);
    }
    private LeScanCallback leScanCallback=new LeScanCallback() {
        
        @Override
        public void onLeScan(BluetoothDevice bluetoothdeivce, int rssi, byte[] scandata) {
            //把byte数组转成16进制字符串，方便查看
            Log.e("TAG","scandata:"+ CYUtils.Bytes2HexString(scandata));
        }
    };
ok，这段代码大家在做连接BLE设备进行通讯的时候，已经很熟悉了。其中的 byte数组 scandata就是 BLE设备的广播数据。


那么接下来，我们开始使用 手机1 模拟成BLE设备来发送广播，然后用手机2 来进行扫描查看广播数据 scandata

首先获取 BluetoothAdapter， 熟悉的代码：

BluetoothManager bluetoothManager = (BluetoothManager)getSystemService(Context.BLUETOOTH_SERVICE);
 
bluetoothAdapter = bluetoothManager.getAdapter();

进行广播的时候需要用到BluetoothLeAdvertiser，进行实例化：


mBluetoothLeAdvertiser = bluetoothAdapter.getBluetoothLeAdvertiser();
实例化好之后就可以进行广播数据了，开启广播方法是：



BluetoothLeAdvertiser: 
public void startAdvertising(AdvertiseSettings settings,
            AdvertiseData advertiseData, final AdvertiseCallback callback)
其中， AdvertiseSettings 是广播的一些设置，比如，广播间隔，是否可以连接等等; AdvertiseData 就是广播数据了， AdvertiseCallback是广播回调，会告诉你广播成功还是失败。


先给一段完整广播代码如下：


    public void startAction(View v){
        byte[] broadcastData ={0x34,0x56};
        mBluetoothLeAdvertiser.startAdvertising(createAdvSettings(true, 0), createAdvertiseData(broadcastData), mAdvertiseCallback);
    }
    public void stopAction(View v) {
        mBluetoothLeAdvertiser.stopAdvertising(mAdvertiseCallback);
    }
 
    public AdvertiseSettings createAdvSettings(boolean connectable, int timeoutMillis) {
        AdvertiseSettings.Builder mSettingsbuilder = new AdvertiseSettings.Builder();
        mSettingsbuilder.setAdvertiseMode(AdvertiseSettings.ADVERTISE_MODE_LOW_LATENCY);
        mSettingsbuilder.setConnectable(connectable);
        mSettingsbuilder.setTimeout(timeoutMillis);
        AdvertiseSettings mAdvertiseSettings = mSettingsbuilder.build();
        return mAdvertiseSettings;
    }
 
    public AdvertiseData createAdvertiseData(byte[] data) {
        AdvertiseData.Builder mDataBuilder = new AdvertiseData.Builder();
        mDataBuilder.addManufacturerData(0x01AC, data);
        AdvertiseData mAdvertiseData = mDataBuilder.build();
        return mAdvertiseData;
    }
    private AdvertiseCallback mAdvertiseCallback = new AdvertiseCallback() {
        @Override
        public void onStartSuccess(AdvertiseSettings settingsInEffect) {
            super.onStartSuccess(settingsInEffect);
 
            ToastUtils.showToast(MainActivity.this, "开启广播成功", 2000);
        }
 
        @Override
        public void onStartFailure(int errorCode) {
            super.onStartFailure(errorCode);
            ToastUtils.showToast(MainActivity.this, "开启广播失败 errorCode：" + errorCode, 2000);
        }
    };

其中，广播数据broadcastData 我暂时直接先定死为2个字节 0x3456，同样在createAdvertiseData里面

也有定死的数据 0x01AC . 开启成功之后

我们使用手机2 来扫描看下广播的数据是什么：


E/TAG: scandata:02011A05FFAC0134560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
log打印出来的scandata 有效数据是 02011A05FFAC013456 .  给大家解释一下这个数据的意思

为了看清楚，我分段如下： 02011A  05  FF AC01 3456   （注，这里的都是16进制数字）

02011A这3个字节，02表示后面一段数据长度为2字节，01表示数据类型是flag ,1A就是flag的数据了

05 表示后面的一段数据长度为 5个字节， FF一个字节，AC01 两个字节，3456两个字节，加起来一共5个字节，老铁没毛病

FF，是一个数据类型，这是我们通过代码mDataBuilder.addManufacturerData(0x01AC, data); 添加广播数据时候设置的

ManufacturerData 是指设备厂商自定义数据，FF 就是代表下面的数据实体是厂商数据.

第一个参数0x01AC，是厂商id，id长度为2个字节，不足2个字节系统会补0，可以看到log打印出来的是 AC01，顺序是倒过来的，这点要注意！

如果我代码是这样写的 ：


mDataBuilder.addManufacturerData(0xAC, data); //只写了一个字节的id
那么使用手机2 扫描出的scandata是：

 E/TAG: scandata:02011A05FFAC0034560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
可以看到，AC后面系统自动补了00


广播数据出除了可以添加ManufacturerData，还可以添加ServerUUID, 代码如下：

 

public AdvertiseData createAdvertiseData(byte[] data) {
        AdvertiseData.Builder mDataBuilder = new AdvertiseData.Builder();
        mDataBuilder.addManufacturerData(0x01AC, data);
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        AdvertiseData mAdvertiseData = mDataBuilder.build();
        return mAdvertiseData;
    }
代码添加了一个 AE8F的 server uuid， 使用手机2 扫描的scandata 如下：


 

E/TAG: scandata:02011A05FFAC01345603038FAE00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
直接看03038FAE 这一段，第一个03 表示后面的一段数据长度为3个字节  第二个03 表示这个数据类型是 server uuid类型，uuid的数据就是8FAE，顺序是倒过来的！

有人会问： 如果 我把addServiceUuid代码放在 addManufacturerData 前面，扫描的数据顺序是什么样的呢？

答案 还是：


E/TAG: scandata:02011A05FFAC01345603038FAE00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
可以添加多个 server uuid吗？ 可以，代码如下：
    public AdvertiseData createAdvertiseData(byte[] data) {
        AdvertiseData.Builder mDataBuilder = new AdvertiseData.Builder();
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addManufacturerData(0x01AC, data);
        AdvertiseData mAdvertiseData = mDataBuilder.build();
        return mAdvertiseData;
    }
扫描的结果是：



E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
直接看0503 8FAE E1FF 这一段， 05 表示后面的一段数据长度是5个字节，03表示数据类型是 server uuid， 8FAE是第一个uuid, E1FF是第二个uuid


这个ServerUUID 有什么用呢？ 

不知大家在扫描BLE设备的时候，有没有注意到这个方法：

BluetoothAdapter
public boolean startLeScan(final UUID[] serviceUuids, final LeScanCallback callback)


这个方法也可以用来扫描BLE设备，但是多了一个参数， UUID数组， 这个扫描方法是用来过滤BLE设备用的，比如 你公司开发一个 蓝牙防丢器APP，你使用 startLeScan(callback)这个方法扫描的话，你会发现你扫描到周围的所有的BLE设备，同事戴的小米手环可能也被你扫描到，这样让用户来选择设备进行连接的话可能就比较迷糊，startLeScan(serviceUuids,callback) 这个方法在扫描的时候会过滤广播里的数据，只有符合的BLE设备才会被扫描回调。 所以，你们公司的蓝牙防丢器设备可以在广播字段里加入特定的server uuid， app扫描的时候可以过滤其他设备。

我们来实现一下这个功能， 修改 手机2 的扫描代码：


        public void startScan(){
                UUID[] serviceUuids = new UUID[] { UUID    .fromString("0000ae8f-0000-1000-8000-00805f9b34fb") };
        bluetoothAdapter.startLeScan(serviceUuids, leScanCallback);
    }
    public void stopScan(){
        bluetoothAdapter.stopLeScan(leScanCallback);
    }
    private LeScanCallback leScanCallback=new LeScanCallback() {
        
        @Override
        public void onLeScan(BluetoothDevice bluetoothdeivce, int rssi, byte[] scandata) {
            //把byte数组转成16进制字符串，方便查看
            Log.e("TAG","scandata:"+ CYUtils.Bytes2HexString(scandata));
        }
    };
扫描结果是这样的：



05-23 16:13:30.522 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:30.625 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:30.735 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:30.847 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:30.955 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:31.061 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:31.192 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:31.283 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:31.369 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
05-23 16:13:31.480 10197-10197/jiqi.blescandemo E/TAG: scandata:02011A05FFAC01345605038FAEE1FF0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
可以发现，扫描结果里面只会出现拥有  AE8F 这个uuid的 BLE设备，搜索不到其他设备

注意：部分手机使用startLeScan(serviceUuids,callback)这个方法过滤设备 会扫描不到设备，即使这个设备UUID符合过滤条件，我归结为手机/系统问题，如三星手机


这样，我们知道，广播数据可以添加ManufacturerData，还可以添加ServerUUID, 还有吗？ 有，代码如下：

    public AdvertiseData createAdvertiseData(byte[] data) {
        AdvertiseData.Builder mDataBuilder = new AdvertiseData.Builder();
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x64,0x12});
        mDataBuilder.addManufacturerData(0x01AC, data);
        AdvertiseData mAdvertiseData = mDataBuilder.build();
        return mAdvertiseData;
    }

扫描结果如下：

 

E/TAG: scandata:02011A05FFAC01345605038FAEE1FF05168FAE64120000000000000000000000000000000000000000000000000000000000000000000000000000000000
直接看05168FAE6412 这一段，05依然表示下面一段数据长度为5个字节，16表示数据类型为 server data， 8FAE表示这个数据的uuid是AE8F， 6412就是数据本体了.

那么这个 server data能做什么呢？比如有这样一个 产品：温度计，温度计硬件在广播字段里的server data里面加入它测量的温度，这样APP可以不连接温度计设备 只通过扫描就知道温度了，是不是很方便.

以下有几个坑请大家注意一下：

  情况1：

 

    public AdvertiseData createAdvertiseData(byte[] data) {
        AdvertiseData.Builder mDataBuilder = new AdvertiseData.Builder();
       // mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x64,0x12});
        mDataBuilder.addManufacturerData(0x01AC, data);
        AdvertiseData mAdvertiseData = mDataBuilder.build();
        return mAdvertiseData;
    }

     我注释了一句代码，广播字段里我没有 添加 ae8f这个 uuid，而直接添加了 ae8f的data 为 0x6412，那么扫描结果如何？

     使用startLeScan(serviceUuids,callback)过滤 ae8f这个uuid，没有扫描结果;

     使用startLeScan(callback),扫描结果如下：

E/TAG: scandata:02011A05FFAC0134560303E1FF05168FAE641200000000000000000000000000000000000000000000000000000000000000000000000000000000000000

     可以看到是有 ae8f对应的数据 6412，但是server uuid里面是没有 ae8f的.

  情况2：

     代码顺序1：

        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"),new byte[]{0x22,0x44});
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x54,0x12});
 
//扫描结果
E/TAG: scandata:02011A05FFAC01345605038FAEE1FF05168FAE54120000000000000000000000000000000000000000000000000000000000000000000000000000000000

    代码顺序2：

 

        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x54,0x11});
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"),new byte[]{0x22,0x43});
 
//扫描结果
E/TAG: scandata:02011A05FFAC01345605038FAEE1FF05168FAE54110000000000000000000000000000000000000000000000000000000000000000000000000000000000

    代码顺序3：

           

        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x54,0x1A});
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"),new byte[]{0x22,0x47});
 
//扫描结果
E/TAG: scandata:02011A05FFAC0134560503E1FF8FAE05168FAE541A0000000000000000000000000000000000000000000000000000000000000000000000000000000000

    代码顺序4：

    

        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceUuid( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"));
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"),new byte[]{0x22,0x48});
        mDataBuilder.addServiceData( ParcelUuid.fromString("0000ae8f-0000-1000-8000-00805f9b34fb"),new byte[]{0x54,0x1B});
 
//扫描结果
E/TAG: scandata:02011A05FFAC0134560503E1FF8FAE05168FAE541B0000000000000000000000000000000000000000000000000000000000000000000000000000000000

    情况2总结：从上面4个代码顺序的结果来看，总是扫描到 ae8f这个uuid对应的数据，没有第二个 server data，但是为什么每次都是ae8f？我TM也不知道！！



AdvertiseData介绍完毕，下面再稍微介绍一下 AdvertiseSettings

        AdvertiseSettings.Builder mSettingsbuilder = new AdvertiseSettings.Builder();
        mSettingsbuilder.setAdvertiseMode(AdvertiseSettings.ADVERTISE_MODE_LOW_LATENCY);
        mSettingsbuilder.setConnectable(connectable);
        mSettingsbuilder.setTxPowerLevel(AdvertiseSettings.ADVERTISE_TX_POWER_HIGH);
        mSettingsbuilder.setTimeout(0);
        AdvertiseSettings mAdvertiseSettings = mSettingsbuilder.build();

 setAdvertiseMode(int advertiseMode)
         设置广播的模式，低功耗，平衡和低延迟三种模式；
         对应  AdvertiseSettings.ADVERTISE_MODE_LOW_POWER  ,ADVERTISE_MODE_BALANCED ,ADVERTISE_MODE_LOW_LATENCY
         从左右到右，广播的间隔会越来越短 

 setConnectable(boolean connectable)
          设置是否可以连接。
          广播分为可连接广播和不可连接广播，一般不可连接广播应用在iBeacon设备上，这样APP无法连接上iBeacon设备

 setTimeout(int timeoutMillis)
          设置广播的最长时间，最大值为常量AdvertiseSettings.LIMITED_ADVERTISING_MAX_MILLIS = 180 * 1000;  180秒
          设为0时，代表无时间限制会一直广播
 setTxPowerLevel(int txPowerLevel)
          设置广播的信号强度
          常量有AdvertiseSettings.ADVERTISE_TX_POWER_ULTRA_LOW,ADVERTISE_TX_POWER_LOW,ADVERTISE_TX_POWER_MEDIUM,ADVERTISE_TX_POWER_HIGH 
          从左到右分别表示强度越来越强. 
          举例：当设置为ADVERTISE_TX_POWER_ULTRA_LOW时，
          手机1和手机2放在一起，手机2扫描到的rssi信号强度为-56左右，
          当设置为ADVERTISE_TX_POWER_HIGH  时， 扫描到的信号强度为-33左右，
          信号强度越大，表示手机和设备靠的越近



     好了，关于BluetoothLeAdvertiser 的用法介绍完毕！！！！



可能有人会说，bluetoothAdapter.startLeScan(leScanCallback); 这个方法过时了怎么办，那可以看一下我的另一篇文章

《android BLE 扫描BLE设备 BluetoothLeScanner》


源码附件：

模拟BLE广播源码：http://pan.baidu.com/s/1bptOQyb

手机2扫描打印的源码就不放出了，很简单。

android BLE Peripheral 手机模拟设备发出BLE广播 BluetoothLeAdvertiser