Compartir a través de


BluetoothDevice Clase

Definición

Representa un dispositivo Bluetooth.

Las aplicaciones de ejemplo que usan esta clase incluyen la enumeración de dispositivos y el ejemplo de emparejamiento y el ejemplo de chat rfCOMM de Bluetooth.

public ref class BluetoothDevice 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 BluetoothDevice 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 BluetoothDevice : System.IDisposable
Public NotInheritable Class BluetoothDevice
Implements IDisposable
Herencia
Object Platform::Object IInspectable BluetoothDevice
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 DeviceInformation
1511 10586 GetDeviceSelectorFromBluetoothAddress
1511 10586 GetDeviceSelectorFromClassOfDevice
1511 10586 GetDeviceSelectorFromConnectionStatus
1511 10586 GetDeviceSelectorFromDeviceName
1511 10586 GetDeviceSelectorFromPairingState
1607 14393 DeviceAccessInformation
1607 14393 GetRfcommServicesAsync
1607 14393 GetRfcommServicesAsync(BluetoothCacheMode)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId,BluetoothCacheMode)
1607 14393 RequestAccessAsync
1709 16299 BluetoothDeviceId
1803 17134 WasSecureConnectionUsedForPairing

Propiedades

BluetoothAddress

Obtiene la dirección del dispositivo.

BluetoothDeviceId

Obtiene el identificador del dispositivo Bluetooth.

ClassOfDevice

Obtiene la información de clase de dispositivo Bluetooth del dispositivo.

ConnectionStatus

Obtiene el estado de conexión del dispositivo.

DeviceAccessInformation

Objeto DeviceAccessInformation actual para el dispositivo. Se usa para comprobar y supervisar los cambios de acceso en el dispositivo.

DeviceId

Obtiene el identificador de dispositivo que procede del Windows.Devices.Enumeration.DeviceInformation.Id

DeviceInformation

Obtiene el objeto DeviceInformation del dispositivo Bluetooth.

HostName

Obtiene el nombre de host del dispositivo.

Name

Obtiene el nombre del dispositivo.

RfcommServices

Obtiene la lista de solo lectura de los servicios RFCOMM admitidos por el dispositivo.

Importante

La API rfcommServices está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetRfcommServicesAsync.

SdpRecords

Obtiene la lista de solo lectura de los registros del Protocolo de detección de servicios (SDP) para el dispositivo.

WasSecureConnectionUsedForPairing

Obtiene un valor booleano que indica si el BluetoothDevice se ha emparejado mediante una conexión segura.

Métodos

Close()

Cierra el dispositivo Bluetooth.

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 BluetoothDevice para el objeto BluetoothAddress especificado.

FromHostNameAsync(HostName)

Devuelve un objeto BluetoothDevice identificado por el hostName especificado.

FromIdAsync(String)

Devuelve un objeto BluetoothDevice identificado por el deviceId especificado.

GetDeviceSelector()

Obtiene una cadena de sintaxis de consulta avanzada (AQS) para identificar instancias de este dispositivo. Esta cadena se pasa al método FindAllAsync o CreateWatcher.

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. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .

GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)

Crea una cadena de filtro advanced Query Syntax (AQS) a partir de un objeto BluetoothClassOfDevice . La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .

GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)

Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth 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. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation que contienen el nombre de dispositivo Bluetooth especificado.

GetDeviceSelectorFromPairingState(Boolean)

Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth que están emparejados o no emparejados. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .

GetRfcommServicesAsync()

Recupera todos los servicios rfcomm en el dispositivo Bluetooth remoto.

GetRfcommServicesAsync(BluetoothCacheMode)

Recupera todos los servicios rfcomm almacenados en caché en el dispositivo Bluetooth remoto.

GetRfcommServicesForIdAsync(RfcommServiceId)

Recupera todos los servicios rfcomm en el dispositivo Bluetooth remoto que coincida con el rfcommServiceId especificado.

GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)

Recupera todos los servicios rfcomm almacenados en caché en el dispositivo Bluetooth remoto que coincida con el rfcommServiceId especificado.

RequestAccessAsync()

Se usa para solicitar acceso explícito al dispositivo Bluetooth. Esto invoca el consentimiento del dispositivo y se debe llamar a en el subproceso de interfaz de usuario.

Eventos

ConnectionStatusChanged

Se produce cuando ha cambiado el estado de conexión del dispositivo.

NameChanged

Se produce cuando el nombre del dispositivo ha cambiado.

SdpRecordsChanged

Se produce cuando ha cambiado la lista de registros SDP para el dispositivo.

Se aplica a

Consulte también