BluetoothLEDevice Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un dispositivo Bluetooth LE.
Para obtener ejemplos de código, consulte Ejemplo de baja energía de Bluetooth y Ejemplo de enumeración y emparejamiento de dispositivos.
public ref class BluetoothLEDevice 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 BluetoothLEDevice 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 BluetoothLEDevice : System.IDisposablePublic NotInheritable Class BluetoothLEDevice
Implements IDisposable- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
| Características de aplicaciones |
bluetooth
|
Comentarios
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1511 | 10586 | Aspecto |
| 1511 | 10586 | BluetoothAddressType |
| 1511 | 10586 | DeviceInformation |
| 1511 | 10586 | FromBluetoothAddressAsync(UInt64,BluetoothAddressType) |
| 1511 | 10586 | GetDeviceSelectorFromAppearance |
| 1511 | 10586 | GetDeviceSelectorFromBluetoothAddress(UInt64) |
| 1511 | 10586 | GetDeviceSelectorFromBluetoothAddress(UInt64,BluetoothAddressType) |
| 1511 | 10586 | GetDeviceSelectorFromConnectionStatus |
| 1511 | 10586 | GetDeviceSelectorFromDeviceName |
| 1511 | 10586 | GetDeviceSelectorFromPairingState |
| 1703 | 15063 | DeviceAccessInformation |
| 1703 | 15063 | GetGattServicesAsync |
| 1703 | 15063 | GetGattServicesAsync(BluetoothCacheMode) |
| 1703 | 15063 | GetGattServicesForUuidAsync(Guid) |
| 1703 | 15063 | GetGattServicesForUuidAsync(Guid,BluetoothCacheMode) |
| 1703 | 15063 | RequestAccessAsync |
| 1709 | 16299 | BluetoothDeviceId |
| 1803 | 17134 | WasSecureConnectionUsedForPairing |
Propiedades
| Appearance |
Obtiene el objeto BluetoothLEAppearance para el dispositivo Bluetooth LE. |
| BluetoothAddress |
Obtiene la dirección del dispositivo. |
| BluetoothAddressType |
Obtiene el tipo de dirección del dispositivo Bluetooth LE. |
| BluetoothDeviceId |
Obtiene el identificador del dispositivo Bluetooth. |
| ConnectionStatus |
Obtiene el estado de conexión del dispositivo. |
| DeviceAccessInformation |
Obtiene DeviceAccessInformation. |
| DeviceId |
Obtiene el identificador del dispositivo. |
| DeviceInformation |
Obtiene la información del dispositivo para el dispositivo Bluetooth LE. |
| GattServices |
Obtiene la lista de solo lectura de los servicios GATT admitidos por el dispositivo. Importante La API GattServices está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetGattServicesAsync. |
| Name |
Obtiene el nombre del dispositivo Bluetooth LE. |
| WasSecureConnectionUsedForPairing |
Obtiene un valor booleano que indica si el BluetoothLEDevice se ha emparejado mediante una conexión segura. |
Métodos
| Close() |
Cierra este dispositivo Bluetooth LE. Esto puede cerrar la conexión con el dispositivo si esta es la única aplicación con una conexión. |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. |
| FromBluetoothAddressAsync(UInt64) |
Devuelve un objeto BluetoothLEDevice que representa el dispositivo Bluetooth LE del mismo nivel con la dirección especificada. Vea Comentarios (en este tema de miembro). |
| FromBluetoothAddressAsync(UInt64, BluetoothAddressType) |
Devuelve un objeto BluetoothLEDevice que representa el dispositivo del mismo nivel con la dirección y el tipo de dirección especificados. Vea Comentarios (en este tema de miembro). |
| FromIdAsync(String) |
Devuelve un objeto BluetoothLEDevice para el identificador especificado. Vea Comentarios en el tema de miembro. |
| GetConnectionParameters() |
Recupera los parámetros de conexión para el dispositivo remoto. Si varias aplicaciones u otros escenarios del sistema también solicitan estos parámetros, el sistema combina automáticamente los parámetros, donde es compatible, en función de la prioridad del sistema. Nota Cuando el dispositivo no está conectado, los parámetros de conexión no son válidos (todos cero). |
| GetConnectionPhy() |
Recupera información sobre la capa física Bluetooth LE (PHY). Nota Cuando el dispositivo no está conectado, los PHY de conexión no son válidos (todos false) |
| GetDeviceSelector() |
Obtiene una cadena de sintaxis de consulta avanzada (AQS) para identificar todos los dispositivos Bluetooth de baja energía (LE). Esta cadena se pasa al método FindAllAsync o CreateWatcher para obtener una lista de dispositivos Bluetooth LE. |
| GetDeviceSelectorFromAppearance(BluetoothLEAppearance) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) a partir de un objeto BluetoothLEAppearance . La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation con la apariencia especificada. |
| GetDeviceSelectorFromBluetoothAddress(UInt64) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) a partir de una dirección de 64 bits que representa un dispositivo Bluetooth LE. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation . |
| GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) a partir de una dirección y un tipo de dirección de 64 bits que representa un dispositivo Bluetooth LE. La cadena de AQS se pasa al método CreateWatcher . |
| GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth LE con el bluetoothConnectionStatus indicado. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation con el estado de conexión Bluetooth indicado. |
| GetDeviceSelectorFromDeviceName(String) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para el nombre del dispositivo Bluetooth LE. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation que contienen el nombre de dispositivo Bluetooth LE especificado. |
| GetDeviceSelectorFromPairingState(Boolean) |
Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth LE que están emparejados o no emparejados. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation . |
| GetGattService(Guid) |
Devuelve el servicio GATT con el identificador de servicio especificado. Importante La API GetGattService está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetGattServicesAsync. |
| GetGattServicesAsync() |
Obtiene gattDeviceServices para este dispositivo Bluetooth LowEnergy. |
| GetGattServicesAsync(BluetoothCacheMode) |
Devuelve gattDeviceServices para este dispositivo Bluetooth LowEnergy con el modo de caché especificado. |
| GetGattServicesForUuidAsync(Guid) |
Devuelve gattDeviceServices para el dispositivo Bluetooth LowEnergy con el UUID especificado. |
| GetGattServicesForUuidAsync(Guid, BluetoothCacheMode) |
Devuelve gattDeviceServices para el dispositivo Bluetooth LowEnergy con el UUID especificado. |
| RequestAccessAsync() |
Solicita acceso al dispositivo Bluetooth LowEnergy. |
| RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters) |
Recupera un objeto de solicitud de parámetros de conexión preferidos de Bluetooth LE para el objeto de parámetros de conexión preferidos de Bluetooth LE especificado. |
Eventos
| ConnectionParametersChanged |
Evento que se genera cuando cambian los parámetros de conexión actuales para el dispositivo. Los parámetros solo se actualizarán después de establecer una conexión al dispositivo. |
| ConnectionPhyChanged |
Evento que se genera cuando cambia el PHY actual para el dispositivo. El PHY solo se actualizará después de establecer una conexión con el dispositivo. |
| ConnectionStatusChanged |
Se produce cuando el estado de conexión del dispositivo ha cambiado. |
| GattServicesChanged |
Se genera cuando ha cambiado la lista de servicios GATT admitidos por el dispositivo. |
| NameChanged |
Se produce cuando el nombre del dispositivo ha cambiado. |