GattDeviceService Kelas

Definisi

Ruang nama:

Windows.Devices.Bluetooth.GenericAttributeProfile

Mewakili Layanan Utama GATT pada perangkat Bluetooth. Kelas GattDeviceService mewakili layanan GATT pada perangkat Bluetooth LE. Ini dibuat dengan menggunakan jalur instans layanan perangkat, yang diperoleh dengan menemukan perangkat menggunakan WINDOWS.Devices.Enumeration API.

public ref class GattDeviceService sealed : IClosable

/// [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 GattDeviceService final : IClosable

[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 GattDeviceService : System.IDisposable

Public NotInheritable Class GattDeviceService
Implements IDisposable

Warisan

Object Platform::Object IInspectable GattDeviceService

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable

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	DeviceAccessInformation
1703	15063	FromIdAsync(String,GattSharingMode)
1703	15063	GetCharacteristicsAsync
1703	15063	GetCharacteristicsAsync(BluetoothCacheMode)
1703	15063	GetCharacteristicsForUuidAsync(Guid)
1703	15063	GetCharacteristicsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)
1703	15063	GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId,BluetoothCacheMode)
1703	15063	GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid)
1703	15063	GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid,BluetoothCacheMode)
1703	15063	GetIncludedServicesAsync
1703	15063	GetIncludedServicesAsync(BluetoothCacheMode)
1703	15063	GetIncludedServicesForUuidAsync(Guid)
1703	15063	GetIncludedServicesForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	OpenAsync
1703	15063	RequestAccessAsync
1703	15063	Sesi
1703	15063	SharingMode

Properti

AttributeHandle	Mendapatkan handel yang digunakan untuk mengidentifikasi atribut layanan berbasis GATT secara unik seperti yang dinyatakan pada perangkat Bluetooth LE.
Device	Mendapatkan objek BluetoothLEDevice yang menjelaskan perangkat yang terkait dengan objek GattDeviceService saat ini. Penting API Perangkat tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan Sesi.
DeviceAccessInformation	Mendapatkan informasi akses perangkat yang terkait dengan objek GattDeviceService saat ini.
DeviceId	Dapatkan string yang mewakili jalur instans layanan GATT yang digunakan untuk membuat instans GattDeviceService.
ParentServices	Mendapatkan daftar layanan induk baca-saja untuk layanan ini. Penting ParentServices API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang.
Session	Mendapatkan sesi untuk instans layanan perangkat GATT ini.
SharingMode	Mendapatkan mode berbagi untuk instans layanan perangkat GATT ini.
Uuid	Mendapatkan UUID Layanan GATT yang terkait dengan GattDeviceService ini.

Metode

Close()	Merilis sumber daya yang terkait dengan kelas GattDeviceService . Ini memungkinkan aplikasi lain untuk mengakses sumber daya GattDeviceService yang dimaksud. Jangan gunakan objek GattDeviceService setelah Anda memanggil Tutup di atasnya; sebagai gantinya, buat objek GattDeviceService baru dengan menggunakan metode FromIdAsync . Untuk C++, panggil Tutup. Untuk bahasa .NET, metode Tutup ini diproyeksikan ke dalam Buang.
ConvertShortIdToUuid(UInt16)	Mengonversi Id pendek yang ditentukan Bluetooth SIG ke UUID GATT penuh. Penting CONVERTShortIdToUuid API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan BluetoothUuidHelper.FromShortId.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
FromIdAsync(String)	Membuat instans GattDeviceService baru dari ID perangkat.
FromIdAsync(String, GattSharingMode)	Membuat instans objek GattDeviceService baru dari ID perangkat.
GetAllCharacteristics()	Mendapatkan koleksi semua karakteristik milik instans GattDeviceService ini. Penting GetAllCharacteristics API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetCharacteristicsAsync.
GetAllIncludedServices()	Mendapatkan koleksi semua layanan yang disertakan milik instans GattDeviceService ini. Penting GetAllCharacteristics API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetIncludedServicesAsync.
GetCharacteristics(Guid)	Mengembalikan vektor karakteristik, yang diidentifikasi oleh UUID yang ditentukan dan milik instans GattDeviceService ini. Penting GETCharacteristics API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetCharacteristicsForUuidAsync.
GetCharacteristicsAsync()	Mendapatkan karakteristik yang merupakan bagian dari instans GattDeviceService ini.
GetCharacteristicsAsync(BluetoothCacheMode)	Mendapatkan karakteristik yang merupakan bagian dari instans GattDeviceService ini.
GetCharacteristicsForUuidAsync(Guid)	Mendapatkan karakterisitik yang merupakan bagian dari instans GattDeviceService ini dan terkait dengan characteristicUuid.
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	Mendapatkan karakterisitik yang merupakan bagian dari instans GattDeviceService ini dan terkait dengan characteristicUuid.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari BluetoothDeviceId dan serviceUuid.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari BluetoothDeviceId dan serviceUuid.
GetDeviceSelectorFromShortId(UInt16)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari UUID Layanan GATT Bluetooth 16-bit. Penting GetDeviceSelectorFromShortId API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetDeviceSelectorFromUuid.
GetDeviceSelectorFromUuid(Guid)	Membuat string Filter AQS yang sesuai untuk digunakan dengan metode CreateWatcher , dari UUID layanan Bluetooth.
GetIncludedServices(Guid)	Mengembalikan vektor layanan yang disertakan, yang diidentifikasi oleh UUID yang ditentukan dan termasuk dalam instans GattDeviceService ini. Penting GetIncludedServices API tidak digunakan lagi, dan mungkin tidak tersedia di versi Windows yang akan datang. Sebagai gantinya, gunakan GetIncludedServicesForUuidAsync.
GetIncludedServicesAsync()	Mendapatkan layanan yang disertakan yang terkait dengan instans GattDeviceService ini.
GetIncludedServicesAsync(BluetoothCacheMode)	Mendapatkan layanan yang disertakan yang terkait dengan instans GattDeviceService ini.
GetIncludedServicesForUuidAsync(Guid)	Mendapatkan layanan yang disertakan dari serviceUuid yang terkait dengan instans GattDeviceService ini.
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	Mendapatkan layanan yang disertakan dari serviceUuid yang terkait dengan instans GattDeviceService ini.
OpenAsync(GattSharingMode)	Membuka layanan perangkat GATT dengan sharingMode yang ditentukan.
RequestAccessAsync()	Meminta akses ke GattDeviceService.

Lihat juga

• BluetoothLEDevice
• IClosable