Bluetooth Low Energy (BLE) économise l'énergie en restant en mode veille la plupart du temps. Il se réveille uniquement pour faire des publicités et des connexions courtes, de sorte que les publicités affectent à la fois la consommation d'énergie et la bande passante de transfert de données.
Extension publicitaire Bluetooth 5
Android 8.0 prend en charge Bluetooth 5, qui offre des améliorations de diffusion et une publicité de données flexible pour BLE. Bluetooth 5 prend en charge les couches physiques BLE (PHY) qui conservent la consommation d'énergie réduite de Bluetooth 4.2 et permettent aux utilisateurs de choisir une bande passante ou une portée accrue. Plus d'informations peuvent être trouvées dans les spécifications Bluetooth 5 Core .
Mise en œuvre
Les nouvelles fonctionnalités Bluetooth 5 sont automatiquement disponibles pour les appareils exécutant Android 8.0 avec des contrôleurs Bluetooth compatibles. Utilisez ces méthodes BluetoothAdapter pour vérifier si un appareil prend en charge les fonctionnalités Bluetooth 5 :
-
isLe2MPhySupported() -
isLeCodedPhySupported() -
isLeExtendedAdvertisingSupported() -
isLePeriodicAdvertisingSupported()
Pour désactiver les fonctionnalités publicitaires, travaillez avec le fournisseur de puces Bluetooth pour désactiver la prise en charge du jeu de puces.
Les PHY Bluetooth sont exclusifs les uns des autres et le comportement de chaque PHY est prédéfini par le Bluetooth SIG. Par défaut, Android 8.0 utilise Bluetooth LE 1M PHY, à partir de Bluetooth 4.2. Le package android.bluetooth.le expose les fonctionnalités publicitaires de Bluetooth 5 via ces API :
-
AdvertisingSet -
AdvertisingSetCallback -
AdvertisingSetParameters -
PeriodicAdvertisingParameters
Créez un AdvertisingSet pour modifier les paramètres de publicité Bluetooth à l'aide de la méthode startAdvertisingSet() dans android.bluetooth.le.BluetoothLeAdvertiser . Même si la prise en charge de Bluetooth 5 ou de ses fonctionnalités publicitaires est désactivée, les fonctionnalités API peuvent également s'appliquer au LE 1M PHY.
Exemples
Cet exemple d'application utilise Bluetooth LE 1M PHY pour la publicité :
// 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);
} Cet exemple d'application utilise le BLE 2M PHY pour la publicité. L'application vérifie d'abord que l'appareil prend en charge les fonctionnalités utilisées. Si les fonctionnalités publicitaires sont prises en charge, l'application configure BLE 2M PHY comme PHY principal. Lorsque 2M PHY est actif, la publicité ne prend pas en charge les contrôleurs Bluetooth 4.x, donc setLegacyMode est défini sur false . Cet exemple modifie les paramètres pendant la publicité et met également la publicité en pause.
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);
}Vérification
Exécutez les tests de produits Bluetooth applicables pour vérifier la compatibilité de l'appareil avec Bluetooth 5.
AOSP contient Android Comms Test Suite (ACTS), qui comprend des tests pour Bluetooth 5. Les tests ACTS pour Bluetooth 5 peuvent être trouvés dans tools/test/connectivity/acts/tests/google/ble/bt5 .