BluetoothDevice 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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.IDisposablePublic NotInheritable Class BluetoothDevice
Implements 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 레코드가 변경된 경우에 발생합니다. |