GattCharacteristic Kelas

Definisi

Ruang nama:

Windows.Devices.Bluetooth.GenericAttributeProfile

Mewakili Karakteristik layanan GATT. Objek GattCharacteristic mewakili Karakteristik GATT dari layanan tertentu, dan diperoleh dari properti Karakteristik objek GattDeviceService.

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

Warisan

Object Platform::Object IInspectable GattCharacteristic

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	bluetooth

Keterangan

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
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)

Properti

AttributeHandle	Mendapatkan handel yang digunakan untuk mengidentifikasi atribut karakteristik berbasis GATT secara unik seperti yang dinyatakan pada perangkat Bluetooth LE.
CharacteristicProperties	Mendapatkan properti karakteristik GATT, seperti yang didefinisikan oleh profil GATT. Jika bendera ExtendedProperties ada, bendera tersebut juga mewakili properti Deskriptor Properti Karakteristik yang Diperluas.
PresentationFormats	Mendapatkan daftar deskriptor format presentasi yang terkait dengan GattCharacteristic ini, dalam urutan yang ditentukan oleh Deskriptor Format Agregat. Daftar akan kosong jika tidak ada deskriptor Format Presentasi atau Format Agregat yang ditemukan.
ProtectionLevel	Mendapatkan atau mengatur opsi keamanan GATT yang diinginkan untuk komunikasi udara dengan perangkat. Windows akan menegosiasikan keamanan maksimum yang mungkin dengan perangkat sebagai bagian dari proses pemasangan, dan menentukan tingkat keamanan yang lebih rendah tidak akan menurunkan tingkat keamanan yang ada.
Service	Mendapatkan GattDeviceService di mana karakteristik ini adalah anggota.
UserDescription	Dapatkan deskripsi ramah pengguna untuk GattCharacteristic ini, jika Deskriptor Deskripsi Pengguna ada, jika tidak, ini akan menjadi string kosong.
Uuid	Mendapatkan UUID Karakteristik GATT untuk GattCharacteristic ini.

Metode

ConvertShortIdToUuid(UInt16)	Mengonversi Id pendek yang ditentukan Bluetooth SIG menjadi UUID GATT penuh. Penting CONVERTShortIdToUuid API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Mendapatkan koleksi semua deskriptor milik instans GattCharacteristic ini. Penting GetAllDescriptors API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetDescriptorsAsync.
GetDescriptors(Guid)	Mengembalikan vektor deskriptor, yang diidentifikasi oleh UUID yang ditentukan, dan milik instans GattCharacteristic ini. Penting GetDescriptors API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Mengembalikan deskriptor untuk instans GattCharacteristic ini.
GetDescriptorsAsync(BluetoothCacheMode)	Mengembalikan deskriptor dengan mode cache yang ditentukan untuk instans GattCharacteristic ini.
GetDescriptorsForUuidAsync(Guid)	Mengembalikan deskriptor yang UUID-nya cocok dengan descriptorUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Mengembalikan deskriptor yang UUID-nya cocok dengan descriptorUuid dengan cacheMode yang ditentukan.
ReadClientCharacteristicConfigurationDescriptorAsync()	Membaca nilai ClientCharacteristicConfigurationDescriptor saat ini.
ReadValueAsync()	Melakukan pembacaan Nilai Karakteristik dari cache nilai yang dikelola oleh Windows.
ReadValueAsync(BluetoothCacheMode)	Melakukan pembacaan Nilai Karakteristik baik dari cache nilai yang dikelola oleh Windows, atau langsung dari perangkat.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Menulis ClientCharacteristicConfigurationDescriptor ke perangkat BLUETOOTH LE, dan jika nilai yang akan ditulis mewakili indikasi atau pemberitahuan dan penanganan aktivitas ValueChanged terdaftar, memungkinkan penerimaan peristiwa ValueChanged dari perangkat.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Menulis ClientCharacteristicConfigurationDescriptor ke perangkat BLUETOOTH LE, dan jika nilai yang akan ditulis mewakili indikasi atau pemberitahuan dan penanganan aktivitas ValueChanged terdaftar, memungkinkan penerimaan peristiwa ValueChanged dari perangkat.
WriteValueAsync(IBuffer)	Melakukan penulisan Nilai Karakteristik ke perangkat BLUETOOTH LE.
WriteValueAsync(IBuffer, GattWriteOption)	Melakukan penulisan Nilai Karakteristik ke perangkat BLUETOOTH LE.
WriteValueWithResultAsync(IBuffer)	Melakukan penulisan Nilai Karakteristik ke perangkat BLUETOOTH LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Melakukan penulisan Nilai Karakteristik ke perangkat BLUETOOTH LE.

Acara

ValueChanged

Aplikasi dapat mendaftarkan penanganan aktivitas untuk menerima peristiwa saat pemberitahuan atau indikasi diterima dari perangkat, setelah mengatur Deskriptor Konfigurasi Karakteristik Klien.