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

Bluetooth năng lượng thấp (BLE) tiết kiệm pin bằng cách duy trì ở chế độ ngủ trong hầu hết thời gian. Chế độ này chỉ thức để 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.

Phần mở rộng quảng cáo Bluetooth 5

Android 8.0 hỗ trợ Bluetooth 5, cung cấp các tính năng cải tiến về thông báo 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ý (PHY) BLE giúp duy trì mức tiêu thụ năng lượng giảm 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 tính năng mới của Bluetooth 5 sẽ tự động có sẵn cho các thiết bị chạy Android 8.0 có tay điều khiển Bluetooth tương thích. Sử dụng các phương thức BluetoothAdapter sau đâ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 làm việc với nhà cung cấp chip Bluetooth để tắt tính năng hỗ trợ bộ chip.

Các PHY Bluetooth không liên quan đến nhau và hành vi của từng 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 hiển thị các tính năng quảng cáo Bluetooth 5 thông qua các API sau:

  • AdvertisingSet
  • AdvertisingSetCallback
  • AdvertisingSetParameters
  • PeriodicAdvertisingParameters

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

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 BLE 2M PHY để 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. 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 should be able to 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 - i.e. 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 thử sản phẩm Bluetooth hiện hành để xác minh khả năng tương thích của thiết bị với Bluetooth 5.