BluetoothSignalStrengthFilter クラス

定義

名前空間:

Windows.Devices.Bluetooth

受信信号強度インジケーター (RSSI) ベースのフィルター処理を構成するために使用されるパラメーターをグループ化します。

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

継承

Object Platform::Object IInspectable BluetoothSignalStrengthFilter

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能	bluetooth

注釈

BluetoothSignalStrengthFilter クラスは、そのプロパティの制限された範囲のみを受け入れます。 ただし、このクラスをアプリで使用する方法によっては、追加の制限が適用される場合があります。 たとえば、RSSI 値の有効な範囲は、Bluetooth LE と Bluetooth BR/EDR デバイスの間で異なります。

これらのプロパティの有効な範囲は次のとおりです。

• InRangeThresholdInDBm - 範囲内で考慮される RSSI イベントの最小しきい値。 有効な範囲は -128 ~ 127 です。
• OutOfRangeThresholdInDBm - RSSI イベントが範囲外と見なされる最小しきい値。 有効な範囲は -128 ~ 127 です。
• OutOfRangeTimeout - RSSI イベントが範囲外と見なされるタイムアウト。 有効な範囲は 1 秒以上です。
• SamplingInterval - RSSI イベントがサンプリングされる間隔。 有効な範囲は 0 以上です。 サンプリング間隔が 25.5 秒以上の場合、サンプリングは完全に無効になります。 その特殊なケースでは、フィルター処理はトリガーベースです。 任意のデバイスの RSSI 値をフィルター処理するために、次の 2 つの状態が考えられます。
• 範囲内。
• 範囲外です。 RSSI イベントは、範囲内と見なされる場合に反映されます。 これには、OutOfRangeTimeout の有効期限が切れていない限り、OUTOfRangeThresholdInDBm より小さいか等しい RSSI 値を持つイベントが含まれます。

このクラスは、 BluetoothLEAdvertisementWatcher クラスで使用される場合、そのプロパティに追加の制限があります。 BluetoothLEAdvertisementWatcher の有効な範囲外のパラメーターで BluetoothLEAdvertisementWatcher が開始されると、例外がスローされます。

一般に、この API には 3 つのメインユース ケースがあります。

InRangeThresholdInDBm	OutOfRangeThresholdInDBm	OutOfRangeTimeout	SamplingInterval	動作
Any	<= InRangeThresholdInDBm	>= 1	0	"範囲内" と見なされる限り、すべての RSSI イベントを受信します。 OutOfRangeTimeout がイベントなしで期限切れになった場合、または OutOfRangeThresholdInDBm より大きい RSSI 値を持つイベントがない場合、イベントは "範囲外" と見なされます。 OutOfRangeTimeout の有効期限が切れると、追加のイベントは生成されません。
Any	<= InRangeThresholdInDBm	>= 1	(0, 25.5)	"範囲内" と見なされる限り、 SamplingInterval によって定義された一定の間隔で RSSI イベントを受信します。 RSSI 値は、 SamplingInterval 内で受信したイベントの値の平均になります。 SamplingInterval 内でイベントが受信されない場合、イベントは反映されません。 OutOfRangeTimeout がイベントなしで期限切れになった場合、または OutOfRangeThresholdInDBm より大きい RSSI 値を持つイベントがない場合、イベントは "範囲外" と見なされ、受信した最後の RSSI 値を持つイベントが生成されます。 最後の RSSI 値が OutOfRangeThresholdInDBm を超えた場合は、-127 dBm に設定されます。
Any	<= InRangeThresholdInDBm	>= 1	>=25.5 (無効)	RSSI イベントが "範囲外" から "範囲内" に移行しているときに、RSSI イベントを受信します。 OutOfRangeTimeout がイベントなしで期限切れになった場合、または OutOfRangeThresholdInDBm より大きい RSSI 値を持つイベントがない場合、イベントは "範囲外" と見なされ、受信した最後の RSSI 値を持つイベントが生成されます。 最後の RSSI 値が OutOfRangeThresholdInDBm を超える場合は、 OutOfRangeThresholdInDBm に設定されます。

コンストラクター

BluetoothSignalStrengthFilter()

新しい BluetoothSignalStrengthFilter オブジェクトを 作成します。

プロパティ

InRangeThresholdInDBm	前のイベントが範囲外と見なされた場合に RSSI イベントが伝達または範囲内と見なされる dBm の最小受信信号強度インジケーター (RSSI) 値。
OutOfRangeThresholdInDBm	RSSI イベントが範囲外と見なされる dBm の最小受信信号強度インジケーター (RSSI) 値。
OutOfRangeTimeout	受信シグナル強度インジケーター (RSSI) イベントが範囲外と見なされるタイムアウト。
SamplingInterval	受信したシグナル強度インジケーター (RSSI) イベントがサンプリングされる間隔。

こちらもご覧ください

• BluetoothLEAdvertisementWatcher
• SignalStrengthFilter