GattCharacteristic クラス

定義

名前空間:

Windows.Devices.Bluetooth.GenericAttributeProfile

GATT サービスの特性を表します。 GattCharacteristic オブジェクトは、特定のサービスの GATT 特性を表し、GattDeviceService オブジェクトの Characteristics プロパティから取得されます。

public ref class GattCharacteristic 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)]
class GattCharacteristic 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)]
public sealed class GattCharacteristic

Public NotInheritable Class GattCharacteristic

継承

Object Platform::Object IInspectable GattCharacteristic

属性

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

注釈

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	GetDescriptorsAsync
1703	15063	GetDescriptorsAsync(BluetoothCacheMode)
1703	15063	GetDescriptorsForUuidAsync(Guid)
1703	15063	GetDescriptorsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	WriteClientCharacteristicConfigurationDescriptorWithResultAsync
1703	15063	WriteValueWithResultAsync(IBuffer)
1703	15063	WriteValueWithResultAsync(IBuffer,GattWriteOption)

プロパティ

AttributeHandle	Bluetooth LE デバイスで宣言されている GATT ベースの特性属性を一意に識別するために使用されるハンドルを取得します。
CharacteristicProperties	GATT プロファイルで定義されている GATT 特性プロパティを取得します。 ExtendedProperties フラグが存在する場合は、拡張特性プロパティ記述子のプロパティも表します。
PresentationFormats	集約形式記述子で指定された順序で、この GattCharacteristic に関連付けられているプレゼンテーション形式記述子の一覧を取得します。 PresentationFormat 記述子または集計形式記述子が見つからない場合、リストは空になります。
ProtectionLevel	デバイスとの空中通信に必要な GATT セキュリティ オプションを取得または設定します。 Windows では、ペアリング プロセスの一環としてデバイスで可能な最大限のセキュリティがネゴシエートされ、低いレベルのセキュリティを指定しても、既存のセキュリティ レベルは低下しません。
Service	この特性がメンバーである GattDeviceService を取得します。
UserDescription	この GattCharacteristic のわかりやすい説明を取得します。ユーザー記述記述子が存在する場合は、空の文字列になります。
Uuid	この GattCharacteristic の GATT 特性 UUID を取得します。

メソッド

ConvertShortIdToUuid(UInt16)	Bluetooth SIG で定義された短い ID を完全な GATT UUID に変換します。 重要 ConvertShortIdToUuid API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 BluetoothUuidHelper.FromShortId を使用します。
GetAllDescriptors()	この GattCharacteristic インスタンスに属するすべての記述子のコレクションを取得します。 重要 GetAllDescriptors API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetDescriptorsAsync を使用します。
GetDescriptors(Guid)	指定した UUID で識別され、この GattCharacteristic インスタンスに属する記述子のベクトルを返します。 重要 GetDescriptors API は非推奨であり、今後のバージョンの Windows では使用できない可能性があります。 代わりに、 GetDescriptorsForUuidAsync を使用します。
GetDescriptorsAsync()	この GattCharacteristic インスタンスの記述子を返します。
GetDescriptorsAsync(BluetoothCacheMode)	この GattCharacteristic インスタンスの指定されたキャッシュ モードを持つ記述子を返します。
GetDescriptorsForUuidAsync(Guid)	UUID が descriptorUuid と一致する記述子を返します。
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	UUID が descriptorUuid と指定された cacheMode と一致する記述子を返します。
ReadClientCharacteristicConfigurationDescriptorAsync()	ClientCharacteristicConfigurationDescriptor の現在の値を読み取ります。
ReadValueAsync()	Windows によって管理されている値キャッシュから読み取られた特性値を実行します。
ReadValueAsync(BluetoothCacheMode)	Windows によって管理されている値キャッシュから、またはデバイスから直接読み取られた特性値を実行します。
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	ClientCharacteristicConfigurationDescriptor を Bluetooth LE デバイスに書き込み、書き込まれる値が表示または通知を表し、ValueChanged イベント ハンドラーが登録されている場合は、デバイスから ValueChanged イベントを受信できるようにします。
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	ClientCharacteristicConfigurationDescriptor を Bluetooth LE デバイスに書き込み、書き込まれる値が表示または通知を表し、ValueChanged イベント ハンドラーが登録されている場合は、デバイスから ValueChanged イベントを受信できるようにします。
WriteValueAsync(IBuffer)	Bluetooth LE デバイスに特性値の書き込みを実行します。
WriteValueAsync(IBuffer, GattWriteOption)	Bluetooth LE デバイスに特性値の書き込みを実行します。
WriteValueWithResultAsync(IBuffer)	Bluetooth LE デバイスに特性値の書き込みを実行します。
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Bluetooth LE デバイスに特性値の書き込みを実行します。

イベント

ValueChanged

アプリは、クライアント特性構成記述子を設定した後、デバイスから通知または表示を受信したときにイベントを受信するためにイベント ハンドラーを登録できます。