BluetoothSignalStrengthFilter Klasse

Definition

Namespace:

Windows.Devices.Bluetooth

Gruppiert Parameter, die zum Konfigurieren der RSSI-basierten Filterung (Received Signal Strength Indicator) verwendet werden.

public ref class BluetoothSignalStrengthFilter sealed

/// [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.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

Vererbung

Object Platform::Object IInspectable BluetoothSignalStrengthFilter

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	bluetooth

Hinweise

Die BluetoothSignalStrengthFilter-Klasse akzeptiert nur einen begrenzten Bereich für ihre Eigenschaften. Je nachdem, wie diese Klasse von einer App verwendet wird, können jedoch zusätzliche Einschränkungen gelten. Beispielsweise unterscheidet sich der gültige Bereich für RSSI-Werte zwischen Bluetooth LE- und Bluetooth BR/EDR-Geräten.

Der gültige Bereich für diese Eigenschaften lautet wie folgt:

• InRangeThresholdInDBm : Der Mindestschwellenwert für ein RSSI-Ereignis, das im Bereich berücksichtigt werden soll. Der gültige Bereich ist -128 bis 127.
• OutOfRangeThresholdInDBm : Der Mindestschwellenwert für ein RSSI-Ereignis, das außerhalb des Bereichs liegt. Der gültige Bereich ist -128 bis 127.
• OutOfRangeTimeout : Timeout für ein RSSI-Ereignis, das außerhalb des Bereichs liegt. Der gültige Bereich ist gleich oder größer als 1 Sekunde.
• SamplingInterval : Das Intervall, in dem RSSI-Ereignisse stichprobeniert werden. Der gültige Bereich ist gleich oder größer als 0. Bei einem Stichprobenintervall, das größer oder gleich 25,5 Sekunden ist, wird die Stichprobenentnahme vollständig deaktiviert. In diesem speziellen Fall ist die Filterung triggerbasiert. Es gibt zwei mögliche Zustände zum Filtern von RSSI-Werten für jedes Gerät:
• Im Bereich.
• Außerhalb des Bereichs. Alle RSSI-Ereignisse werden weitergegeben, wenn sie im Bereich betrachtet werden. Dies schließt Ereignisse ein, deren RSSI-Werte niedriger oder gleich OutOfRangeThresholdInDBm sind, solange OutOfRangeTimeout nicht abgelaufen ist.

Diese Klasse hat zusätzliche Einschränkungen für ihre Eigenschaften, wenn sie von der BluetoothLEAdvertisementWatcher-Klasse verwendet wird. Eine Ausnahme wird ausgelöst, wenn bluetoothLEAdvertisementWatcher mit Parametern außerhalb des gültigen Bereichs für BluetoothLEAdvertisementWatcher gestartet wird.

Im Allgemeinen gibt es drei Standard Anwendungsfälle für diese API:

InRangeThresholdInDBm	OutOfRangeThresholdInDBm	OutOfRangeTimeout	SamplingInterval	Verhalten
Any	<= InRangeThresholdInDBm	>= 1	0	Empfängt alle RSSI-Ereignisse beim Eintreffen, solange sie als "im Bereich" betrachtet werden. Die Ereignisse gelten als "außerhalb des Bereichs", wenn OutOfRangeTimeout ohne Ereignisse oder ohne Ereignisse abläuft, deren RSSI-Werte größer als OutOfRangeThresholdInDBm sind. Beim Ablauf von OutOfRangeTimeout werden keine zusätzlichen Ereignisse generiert.
Any	<= InRangeThresholdInDBm	>= 1	(0, 25.5)	Empfängt RSSI-Ereignisse in einem von SamplingInterval definierten regulären Intervall, solange sie als "im Bereich" gelten. Der RSSI-Wert ist ein Durchschnitt der Werte von Ereignissen, die innerhalb eines SamplingInterval empfangen werden. Wenn keine Ereignisse innerhalb von SamplingInterval empfangen werden, wird kein Ereignis weitergegeben. Wenn OutOfRangeTimeout ohne Ereignisse oder ohne Ereignisse abläuft, deren RSSI-Werte größer als OutOfRangeThresholdInDBm sind, werden die Ereignisse als "außerhalb des Bereichs" betrachtet, und ein Ereignis mit dem letzten empfangenen RSSI-Wert wird generiert. Wenn der letzte RSSI-Wert über OutOfRangeThresholdInDBm lag, wird er auf -127 dBm festgelegt.
Any	<= InRangeThresholdInDBm	>= 1	>=25.5 (deaktiviert)	Empfängt ein RSSI-Ereignis, wenn die RSSI-Ereignisse von "außerhalb des Bereichs" zu "im Bereich" wechseln. Wenn OutOfRangeTimeout ohne Ereignisse oder ohne Ereignisse abläuft, deren RSSI-Werte größer als OutOfRangeThresholdInDBm sind, werden die Ereignisse als "außerhalb des Bereichs" betrachtet, und ein Ereignis mit dem letzten empfangenen RSSI-Wert wird generiert. Wenn der letzte RSSI-Wert über OutOfRangeThresholdInDBm lag, wird er auf OutOfRangeThresholdInDBm festgelegt.

Konstruktoren

BluetoothSignalStrengthFilter()

Erstellen Sie ein neues BluetoothSignalStrengthFilter-Objekt .

Eigenschaften

InRangeThresholdInDBm	Der minimale RSSI-Wert (Empfangener Signalstärkeindikator) in dBm, für den RSSI-Ereignisse weitergegeben oder im Bereich berücksichtigt werden, wenn die vorherigen Ereignisse als außerhalb des Bereichs betrachtet wurden.
OutOfRangeThresholdInDBm	Der minimale RSSI-Wert (Empfangener Signalstärkeindikator) in dBm, bei dem RSSI-Ereignisse außerhalb des Bereichs betrachtet werden.
OutOfRangeTimeout	Das Timeout für ein RSSI-Ereignis (Received Signal Strength Indicator), das als außerhalb des Bereichs betrachtet werden soll.
SamplingInterval	Das Intervall, in dem RSSI-Ereignisse (Empfangene Signalstärkenanzeige) stichprobeniert werden.

Weitere Informationen

• BluetoothLEAdvertisementWatcher
• SignalStrengthFilter