Langue

BluetoothGattConnectionSettings.Builder.SetRssiThresholdDbm(Int32) Méthode

Définition

Définit le seuil RSSI pour lancer une connexion.

[Android.Runtime.Register("setRssiThresholdDbm", "(I)Landroid/bluetooth/BluetoothGattConnectionSettings$Builder;", "", ApiSince=37)]
public Android.Bluetooth.BluetoothGattConnectionSettings.Builder SetRssiThresholdDbm(int rssiThresholdDbm);
[<Android.Runtime.Register("setRssiThresholdDbm", "(I)Landroid/bluetooth/BluetoothGattConnectionSettings$Builder;", "", ApiSince=37)>]
member this.SetRssiThresholdDbm : int -> Android.Bluetooth.BluetoothGattConnectionSettings.Builder

Paramètres

rssiThresholdDbm
Int32

seuil RSSI dans dBm pour lancer la connexion. La valeur est comprise entre -128 et 20 inclus

Retours

Ce générateur. Cette valeur ne peut pas être null.

Attributs

Remarques

Définit le seuil RSSI pour lancer une connexion. Si l’appareil est déjà connecté, la connexion GATT réussit indépendamment du RSSI.

Le seuil RSSI est utilisé pour lancer une connexion LE à un appareil distant lorsque la connexion automatique est activée. Lorsque la connexion automatique est activée, le contrôleur Bluetooth ajoute l’appareil distant à la liste d’acceptation et lance la connexion lorsque l’appareil est en plage et a un signal fort. Le contrôleur Bluetooth lance la connexion si le RSSI est supérieur à la valeur de seuil RSSI donnée.

Il s’agit simplement d’une préférence pour le contrôleur Bluetooth ; le contrôleur peut ou non utiliser ce seuil pour lancer la connexion.

Lorsque plusieurs applications demandent des connexions avec des valeurs de seuil RSSI différentes, le système Bluetooth utilise le seuil RSSI le plus bas (le moins strict) parmi toutes les demandes actives lors du lancement de la prochaine connexion LE en fonction de la puissance du signal, ce qui permet aux connexions d’être lancées à des niveaux de signal plus faibles si une application le demande.

Le seuil RSSI par défaut est défini sur BluetoothGattConnectionSettings.RSSI_THRESHOLD_NOT_SET qui indique que le déclencheur de connexion LE basé sur RSSI n’est pas activé.

Le seuil pathloss défini à l’aide de setPathlossThresholdDb(int) sera hiérarchisé par rapport au seuil RSSI pour déclencher la connexion LE. Le seuil RSSI est utilisé pour déclencher la connexion LE uniquement si le seuil de chemin d’accès n’est pas défini.

Référence Android pour android.bluetooth.BluetoothGattConnectionSettings.Builder.setRssiThresholdDbm.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à