Le Bluetooth à basse consommation (BLE) économise l'énergie en restant en mode veille la plupart du temps. Il se réveille uniquement pour créer des annonces et des connexions courtes. Les publicités affectent donc à la fois la consommation d'énergie et la bande passante de transfert de données.
Extension publicitaire Bluetooth 5
Android 8.0 est compatible avec le Bluetooth 5, qui offre des améliorations de la diffusion et une publicité flexible des données pour la technologie BLE. Le Bluetooth 5 est compatible avec les couches physiques BLE (PHY) qui conservent la consommation d'énergie réduite du Bluetooth 4.2 et permettent aux utilisateurs de choisir une bande passante ou une portée accrue. Pour en savoir plus, consultez les caractéristiques du Bluetooth 5 Core.
Implémentation
Les nouvelles fonctionnalités Bluetooth 5 sont automatiquement disponibles pour les appareils équipés d'Android 8.0 avec des manettes Bluetooth compatibles. Utilisez ces méthodes
BluetoothAdapter pour vérifier si un appareil est compatible avec les fonctionnalités Bluetooth 5:
isLe2MPhySupported()isLeCodedPhySupported()isLeExtendedAdvertisingSupported()isLePeriodicAdvertisingSupported()
Pour désactiver les fonctionnalités de publicité, contactez le fournisseur de la puce Bluetooth afin de désactiver la compatibilité avec les chipsets.
Les PHY Bluetooth s'excluent les unes des autres, et le comportement de chaque PHY est prédéfini par Bluetooth SIG. Par défaut, Android 8.0 utilise la technologie Bluetooth LE 1M PHY, de Bluetooth 4.2. Le package
android.bluetooth.le expose les fonctionnalités publicitaires Bluetooth 5 via les API suivantes:
AdvertisingSetAdvertisingSetCallbackAdvertisingSetParametersPeriodicAdvertisingParameters
Créez un
AdvertisingSet pour modifier les paramètres d'annonce Bluetooth à l'aide de la méthode startAdvertisingSet() dans
android.bluetooth.le.BluetoothLeAdvertiser. Même si la compatibilité avec le Bluetooth 5 ou ses fonctionnalités de publicité est désactivée, les fonctionnalités de l'API peuvent également s'appliquer à LE 1M PHY.
Exemples
Cet exemple d'application utilise la technologie 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 la technologie BLE 2M PHY pour la publicité. L'application vérifie d'abord que l'appareil est compatible avec les fonctionnalités utilisées. Si les fonctionnalités de publicité sont compatibles, l'application configure la PHY BLE 2M comme PHY principale. Tant que la valeur PHY de 2 M est active, l'annonce n'est pas compatible avec les manettes Bluetooth 4.x. setLegacyMode est donc défini sur false. Cet exemple modifie les paramètres tout en mettant en veille l'annonce.
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);
}
Validation
Exécutez des tests des produits Bluetooth applicables pour vérifier la compatibilité de l'appareil avec le Bluetooth 5.