BluetoothDevice 클래스

정의

네임스페이스:

Windows.Devices.Bluetooth

Bluetooth 디바이스를 나타냅니다.

이 클래스를 사용하는 샘플 애플리케이션에는 디바이스 열거형 및 페어링 샘플 및Bluetooth RFCOMM 채팅 샘플이 포함됩니다.

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

상속

Object Platform::Object IInspectable BluetoothDevice

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable IDisposable

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 버전	추가된 값
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

속성

BluetoothAddress	디바이스 주소를 가져옵니다.
BluetoothDeviceId	bluetooth 디바이스 ID를 가져옵니다.
ClassOfDevice	디바이스의 Bluetooth 디바이스 클래스 정보를 가져옵니다.
ConnectionStatus	디바이스의 연결 상태 가져옵니다.
DeviceAccessInformation	디바이스에 대한 현재 DeviceAccessInformation 개체입니다. 디바이스에 대한 액세스 변경 내용을 검사 모니터링하는 데 사용됩니다.
DeviceId	Windows.Devices.Enumeration.DeviceInformation.Id 제공된 디바이스 ID를 가져옵니다.
DeviceInformation	Bluetooth 디바이스에 대한 DeviceInformation 개체를 가져옵니다.
HostName	디바이스의 HostName을 가져옵니다.
Name	디바이스의 이름을 가져옵니다.
RfcommServices	디바이스에서 지원하는 RFCOMM 서비스의 읽기 전용 목록을 가져옵니다. 중요 RfcommServices API는 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다. 대신 GetRfcommServicesAsync를 사용합니다.
SdpRecords	디바이스에 대한 SDP(서비스 검색 프로토콜) 레코드의 읽기 전용 목록을 가져옵니다.
WasSecureConnectionUsedForPairing	보안 연결을 사용하여 BluetoothDevice가 페어링되었는지 여부를 나타내는 부울을 가져옵니다.

메서드

Close()	Bluetooth 장치를 닫습니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
FromBluetoothAddressAsync(UInt64)	지정된 BluetoothAddress에 대한 BluetoothDevice 개체를 반환합니다.
FromHostNameAsync(HostName)	지정된 HostName으로 식별된 BluetoothDevice 개체를 반환합니다.
FromIdAsync(String)	지정된 DeviceId로 식별된 BluetoothDevice 개체를 반환합니다.
GetDeviceSelector()	이 디바이스의 인스턴스를 식별하기 위한 AQS(고급 쿼리 구문) 문자열을 가져옵니다. 이 문자열은 FindAllAsync 또는 CreateWatcher 메서드에 전달됩니다.
GetDeviceSelectorFromBluetoothAddress(UInt64)	Bluetooth 디바이스를 나타내는 64비트 주소에서 AQS(고급 쿼리 구문) 필터 문자열을 만듭니다. AQS 문자열은 DeviceInformation 개체의 컬렉션을 반환하기 위해 CreateWatcher 메서드에 전달됩니다.
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)	BluetoothClassOfDevice 개체에서 AQS(고급 쿼리 구문) 필터 문자열을 만듭니다. AQS 문자열은 DeviceInformation 개체의 컬렉션을 반환하기 위해 CreateWatcher 메서드에 전달됩니다.
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	BluetoothConnectionStatus가 표시된 Bluetooth 디바이스에 대한 쿼리를 포함하는 AQS(고급 쿼리 구문) 필터 문자열을 만듭니다. AQS 문자열은 CreateWatcher 메서드에 전달되어 표시된 Bluetooth 연결 상태 있는 DeviceInformation 개체 컬렉션을 반환합니다.
GetDeviceSelectorFromDeviceName(String)	Bluetooth 디바이스 이름에 대한 쿼리를 포함하는 AQS(고급 쿼리 구문) 필터 문자열을 만듭니다. AQS 문자열은 CreateWatcher 메서드에 전달되어 지정된 Bluetooth 디바이스 이름을 포함하는 DeviceInformation 개체의 컬렉션을 반환합니다.
GetDeviceSelectorFromPairingState(Boolean)	페어링되거나 페어링되지 않은 Bluetooth 디바이스에 대한 쿼리를 포함하는 AQS(고급 쿼리 구문) 필터 문자열을 만듭니다. AQS 문자열은 DeviceInformation 개체의 컬렉션을 반환하기 위해 CreateWatcher 메서드에 전달됩니다.
GetRfcommServicesAsync()	원격 Bluetooth 디바이스에서 모든 Rfcomm Services를 검색합니다.
GetRfcommServicesAsync(BluetoothCacheMode)	원격 Bluetooth 디바이스에서 캐시된 모든 Rfcomm Services를 검색합니다.
GetRfcommServicesForIdAsync(RfcommServiceId)	지정된 RfcommServiceId와 일치하는 원격 Bluetooth 디바이스에서 모든 Rfcomm Services를 검색합니다.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	지정된 RfcommServiceId와 일치하는 원격 Bluetooth 디바이스에서 캐시된 모든 Rfcomm Services를 검색합니다.
RequestAccessAsync()	Bluetooth 디바이스에 대한 명시적 액세스를 요청하는 데 사용됩니다. 이렇게 하면 디바이스 동의가 호출되고 UI 스레드에서 호출되어야 합니다.

이벤트

ConnectionStatusChanged	디바이스의 연결 상태 변경된 경우에 발생합니다.
NameChanged	디바이스 이름이 변경되면 발생합니다.
SdpRecordsChanged	디바이스에 대한 목록 SDP 레코드가 변경된 경우에 발생합니다.

추가 정보

• 디바이스 열거형 및 페어링 샘플
• Bluetooth RFCOMM 채팅 샘플