Quảng cáo Bluetooth năng lượng thấp

Bluetooth năng lượng thấp (BLE) tiết kiệm điện bằng cách duy trì ở chế độ ngủ trong hầu hết thời gian. Thiết bị này chỉ hoạt động để tạo quảng cáo và kết nối ngắn, vì vậy quảng cáo ảnh hưởng đến cả mức tiêu thụ điện năng và băng thông truyền dữ liệu.

Tiện ích quảng cáo Bluetooth 5

Android 8.0 hỗ trợ Bluetooth 5, giúp cải thiện khả năng truyền tin và quảng cáo dữ liệu linh hoạt cho BLE. Bluetooth 5 hỗ trợ các Lớp vật lý BLE (PHY) duy trì mức tiêu thụ điện năng thấp của Bluetooth 4.2 và cho phép người dùng chọn tăng băng thông hoặc phạm vi. Bạn có thể xem thêm thông tin trong Thông số kỹ thuật cốt lõi của Bluetooth 5.

Triển khai

Các thiết bị chạy Android 8.0 có tay điều khiển Bluetooth tương thích sẽ tự động có các tính năng mới của Bluetooth 5. Sử dụng các phương thức BluetoothAdapter này để kiểm tra xem thiết bị có hỗ trợ các tính năng của Bluetooth 5 hay không:

  • isLe2MPhySupported()
  • isLeCodedPhySupported()
  • isLeExtendedAdvertisingSupported()
  • isLePeriodicAdvertisingSupported()

Để tắt các tính năng quảng cáo, hãy hợp tác với nhà cung cấp chip Bluetooth để tắt chế độ hỗ trợ cho bộ vi xử lý.

Các PHY Bluetooth loại trừ lẫn nhau và hành vi của mỗi PHY được Bluetooth SIG xác định trước. Theo mặc định, Android 8.0 sử dụng Bluetooth LE 1M PHY, từ Bluetooth 4.2. Gói android.bluetooth.le cung cấp các tính năng quảng cáo Bluetooth 5 thông qua những API sau:

  • AdvertisingSet
  • AdvertisingSetCallback
  • AdvertisingSetParameters
  • PeriodicAdvertisingParameters

Tạo một AdvertisingSet để sửa đổi chế độ cài đặt quảng cáo qua Bluetooth bằng cách sử dụng phương thức startAdvertisingSet() trong android.bluetooth.le.BluetoothLeAdvertiser. Ngay cả khi bạn tắt chế độ hỗ trợ Bluetooth 5 hoặc các tính năng quảng cáo của Bluetooth 5, các tính năng API cũng có thể áp dụng cho PHY 1M LE.

Ví dụ

Ứng dụng mẫu này sử dụng Bluetooth LE 1M PHY để quảng cáo:

  // Start legacy advertising. Works for devices with 5.x controllers,
  // and devices that support multi-advertising.

  void example1() {
   BluetoothLeAdvertiser advertiser =
      BluetoothAdapter.getDefaultAdapter().getBluetoothLeAdvertiser();

   AdvertisingSetParameters parameters = (new AdvertisingSetParameters.Builder())
           .setLegacyMode(true) // True by default, but set here as a reminder.
           .setConnectable(true)
           .setInterval(AdvertisingSetParameters.INTERVAL_HIGH)
           .setTxPowerLevel(AdvertisingSetParameters.TX_POWER_MEDIUM)
           .build();

   AdvertiseData data = (new AdvertiseData.Builder()).setIncludeDeviceName(true).build();

   AdvertisingSetCallback callback = new AdvertisingSetCallback() {
       @Override
       public void onAdvertisingSetStarted(AdvertisingSet advertisingSet, int txPower, int status) {
           Log.i(LOG_TAG, "onAdvertisingSetStarted(): txPower:" + txPower + " , status: "
             +   status);
           currentAdvertisingSet = advertisingSet;
       }

       @Override
       public void onAdvertisingDataSet(AdvertisingSet advertisingSet, int status) {
           Log.i(LOG_TAG, "onAdvertisingDataSet() :status:" + status);
       }

       @Override
       public void onScanResponseDataSet(AdvertisingSet advertisingSet, int status) {
           Log.i(LOG_TAG, "onScanResponseDataSet(): status:" + status);
       }

       @Override
       public void onAdvertisingSetStopped(AdvertisingSet advertisingSet) {
           Log.i(LOG_TAG, "onAdvertisingSetStopped():");
       }
   };

   advertiser.startAdvertisingSet(parameters, data, null, null, null, callback);

   // After onAdvertisingSetStarted callback is called, you can modify the
   // advertising data and scan response data:
   currentAdvertisingSet.setAdvertisingData(new AdvertiseData.Builder().
     setIncludeDeviceName(true).setIncludeTxPowerLevel(true).build());
   // Wait for onAdvertisingDataSet callback...
   currentAdvertisingSet.setScanResponseData(new
     AdvertiseData.Builder().addServiceUuid(new ParcelUuid(UUID.randomUUID())).build());
   // Wait for onScanResponseDataSet callback...

   // When done with the advertising:
   advertiser.stopAdvertisingSet(callback);
}

Ứng dụng mẫu này sử dụng PHY BLE 2M để quảng cáo. Trước tiên, ứng dụng sẽ kiểm tra để đảm bảo thiết bị hỗ trợ các tính năng đang được sử dụng. Nếu các tính năng quảng cáo được hỗ trợ, thì ứng dụng sẽ định cấu hình BLE 2M PHY làm PHY chính. Trong khi 2M PHY đang hoạt động, quảng cáo không hỗ trợ bộ điều khiển Bluetooth 4.x, vì vậy setLegacyMode được đặt thành false. Ví dụ này sửa đổi các thông số trong khi quảng cáo và cũng tạm dừng quảng cáo.

void example2() {
   BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
   BluetoothLeAdvertiser advertiser =
     BluetoothAdapter.getDefaultAdapter().getBluetoothLeAdvertiser();

   // Check if all features are supported
   if (!adapter.isLe2MPhySupported()) {
       Log.e(LOG_TAG, "2M PHY not supported!");
       return;
   }
   if (!adapter.isLeExtendedAdvertisingSupported()) {
       Log.e(LOG_TAG, "LE Extended Advertising not supported!");
       return;
   }

   int maxDataLength = adapter.getLeMaximumAdvertisingDataLength();

   AdvertisingSetParameters.Builder parameters = (new AdvertisingSetParameters.Builder())
           .setLegacyMode(false)
           .setInterval(AdvertisingSetParameters.INTERVAL_HIGH)
           .setTxPowerLevel(AdvertisingSetParameters.TX_POWER_MEDIUM)
           .setPrimaryPhy(BluetoothDevice.PHY_LE_1M)
           .setSecondaryPhy(BluetoothDevice.PHY_LE_2M);

   AdvertiseData data = (new AdvertiseData.Builder()).addServiceData(new
     ParcelUuid(UUID.randomUUID()),
           "You can fit large amounts of data up to maxDataLength. This goes up to 1650 bytes. For legacy advertising this would not work".getBytes()).build();

   AdvertisingSetCallback callback = new AdvertisingSetCallback() {
       @Override
       public void onAdvertisingSetStarted(AdvertisingSet advertisingSet, int txPower, int status) {
           Log.i(LOG_TAG, "onAdvertisingSetStarted(): txPower:" + txPower + " , status: "
            +   status);
           currentAdvertisingSet = advertisingSet;
       }

       @Override
       public void onAdvertisingSetStopped(AdvertisingSet advertisingSet) {
           Log.i(LOG_TAG, "onAdvertisingSetStopped():");
       }
   };

   advertiser.startAdvertisingSet(parameters.build(), data, null, null, null, callback);

   // After the set starts, you can modify the data and parameters of currentAdvertisingSet.
   currentAdvertisingSet.setAdvertisingData((new
     AdvertiseData.Builder()).addServiceData(new ParcelUuid(UUID.randomUUID()),
           "Without disabling the advertiser first, you can set the data, if new data is less than 251 bytes long.".getBytes()).build());

   // Wait for onAdvertisingDataSet callback...

   // Can also stop and restart the advertising
   currentAdvertisingSet.enableAdvertising(false, 0, 0);
   // Wait for onAdvertisingEnabled callback...
   currentAdvertisingSet.enableAdvertising(true, 0, 0);
   // Wait for onAdvertisingEnabled callback...

   // Or modify the parameters - for example, lower the tx power
   currentAdvertisingSet.enableAdvertising(false, 0, 0);
   // Wait for onAdvertisingEnabled callback...
   currentAdvertisingSet.setAdvertisingParameters(parameters.setTxPowerLevel
     (AdvertisingSetParameters.TX_POWER_LOW).build());
   // Wait for onAdvertisingParametersUpdated callback...
   currentAdvertisingSet.enableAdvertising(true, 0, 0);
   // Wait for onAdvertisingEnabled callback...

   // When done with the advertising:
   advertiser.stopAdvertisingSet(callback);
}

Xác minh

Chạy các bài kiểm tra sản phẩm Bluetooth phù hợp để xác minh khả năng tương thích của thiết bị với Bluetooth 5.