BluetoothSignalStrengthFilter Classe

Référence

Définition

Espace de noms:: Windows.Devices.Bluetooth

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Regroupe les paramètres utilisés pour configurer le filtrage rssi (Signal Strength Indicator) reçu.

public ref class BluetoothSignalStrengthFilter sealed

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BluetoothSignalStrengthFilter final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothSignalStrengthFilter final

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BluetoothSignalStrengthFilter

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothSignalStrengthFilter

function BluetoothSignalStrengthFilter()

Public NotInheritable Class BluetoothSignalStrengthFilter

Héritage: Object Platform::Object IInspectable BluetoothSignalStrengthFilter

Attributs: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	bluetooth

Remarques

La classe BluetoothSignalStrengthFilter accepte uniquement une plage limitée pour ses propriétés. Toutefois, selon la façon dont cette classe est utilisée par une application, des restrictions supplémentaires peuvent s’appliquer. Par exemple, la plage valide pour les valeurs RSSI diffère entre les appareils Bluetooth LE et Bluetooth BR/EDR.

La plage valide pour ces propriétés est la suivante :

InRangeThresholdInDBm : seuil minimal pour un événement RSSI à prendre en compte dans la plage. La plage valide est comprise entre -128 et 127.
OutOfRangeThresholdInDBm : seuil minimal pour qu’un événement RSSI soit considéré comme hors limites. La plage valide est comprise entre -128 et 127.
OutOfRangeTimeout : délai d’expiration d’un événement RSSI à considérer comme hors limites. La plage valide est égale ou supérieure à 1 seconde.
SamplingInterval : intervalle auquel les événements RSSI sont échantillonnés. La plage valide est égale ou supérieure à 0. Tout intervalle d’échantillonnage supérieur ou égal à 25,5 secondes désactive entièrement l’échantillonnage. Dans ce cas particulier, le filtrage est basé sur des déclencheurs. Il existe deux états possibles pour filtrer les valeurs RSSI pour n’importe quel appareil :
Dans la plage.
Hors de portée. Tous les événements RSSI sont propagés s’ils sont considérés dans la plage. Cela inclut les événements dont les valeurs RSSI sont inférieures ou égales à OutOfRangeThresholdInDBm tant que OutOfRangeTimeout n’a pas expiré.

Cette classe présente des limitations supplémentaires sur ses propriétés lorsqu’elle est utilisée par la classe BluetoothLEAdvertisementWatcher . Une exception est levée lorsque BluetoothLEAdvertisementWatcher est démarré avec des paramètres en dehors de la plage valide pour BluetoothLEAdvertisementWatcher.

En général, il existe trois cas d’usage main pour cette API :

InRangeThresholdInDBm	OutOfRangeThresholdInDBm	OutOfRangeTimeout	SamplingInterval	Comportement
Quelconque	<= InRangeThresholdInDBm	> = 1	0	Recevra tous les événements RSSI à mesure qu’ils arrivent tant qu’ils sont considérés comme « dans la plage ». Les événements sont considérés comme « hors limites » si OutOfRangeTimeout expire sans événements ou sans événements avec des valeurs RSSI supérieures à OutOfRangeThresholdInDBm. Aucun événement supplémentaire n’est généré lorsque OutOfRangeTimeout expire.
Quelconque	<= InRangeThresholdInDBm	> = 1	(0, 25.5)	Reçoit des événements RSSI à intervalle régulier défini par SamplingInterval tant qu’ils sont considérés comme « dans la plage ». La valeur RSSI est une moyenne des valeurs des événements reçus dans un SamplingInterval. Si aucun événement n’est reçu dans SamplingInterval, aucun événement n’est propagé. Si OutOfRangeTimeout expire sans événements ou sans événements avec des valeurs RSSI supérieures à OutOfRangeThresholdInDBm, les événements sont considérés comme « hors plage » et un événement avec la dernière valeur RSSI reçue est généré. Si la dernière valeur RSSI était supérieure à OutOfRangeThresholdInDBm, elle est définie sur -127 dBm.
Quelconque	<= InRangeThresholdInDBm	> = 1	>=25,5 (désactivé)	Reçoit un événement RSSI lorsque les événements RSSI sont en transition vers « in range » à partir de « hors plage ». Si OutOfRangeTimeout expire sans événements ou sans événements avec des valeurs RSSI supérieures à OutOfRangeThresholdInDBm, les événements sont considérés comme « hors plage » et un événement avec la dernière valeur RSSI reçue est généré. Si la dernière valeur RSSI était supérieure à OutOfRangeThresholdInDBm, elle est définie sur OutOfRangeThresholdInDBm.

Constructeurs

BluetoothSignalStrengthFilter()

Créez un objet BluetoothSignalStrengthFilter .

Propriétés

InRangeThresholdInDBm	Valeur minimale de l’indicateur de puissance du signal reçu (RSSI) en dBm sur laquelle les événements RSSI seront propagés ou considérés dans la plage si les événements précédents étaient considérés comme hors plage.
OutOfRangeThresholdInDBm	Valeur minimale de l’indicateur de puissance du signal reçu (RSSI) en dBm sur laquelle les événements RSSI seront considérés comme hors limites.
OutOfRangeTimeout	Délai d’expiration d’un événement d’indicateur de force du signal (RSSI) reçu à considérer comme hors limites.
SamplingInterval	Intervalle auquel les événements RSSI (Signal Strength Indicator) reçus sont échantillonnées.

S’applique à

Partager via