QBluetooth Namespace

QBluetooth 네임스페이스에는 블루투스와 관련된 클래스와 함수가 제공됩니다. 더 보기...

헤더:	`#include <qbluetooth.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Bluetooth)` `target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)`
qmake:	`QT += bluetooth`

유형

enum class	AttAccessConstraint { AttAuthorizationRequired, AttAuthenticationRequired, AttEncryptionRequired }
flags	AttAccessConstraints
	QLowEnergyHandle
enum class	Security { NoSecurity, Authorization, Authentication, Encryption, Secure }
flags	SecurityFlags

상세 설명

유형 설명서

enum class QBluetooth::AttAccessConstraint
flags QBluetooth::AttAccessConstraints

이 열거형은 ATT 속성을 읽거나 쓰기 위해 필요한 조건을 설명합니다.

상수	값	설명
`QBluetooth::AttAccessConstraint::AttAuthorizationRequired`	`0x1`	클라이언트가 속성에 액세스하려면 ATT 서버의 인증이 필요합니다.
`QBluetooth::AttAccessConstraint::AttAuthenticationRequired`	`0x2`	클라이언트는 속성에 접근하기 위해 인증을 받아야 합니다.
`QBluetooth::AttAccessConstraint::AttEncryptionRequired`	`0x4`	연결이 암호화된 경우에만 속성에 액세스할 수 있습니다.

AttAccessConstraints 유형은 QFlags<AttAccessConstraint>에 대한 typedef입니다. 이 유형은 AttAccessConstraint 값들의 OR 조합을 저장합니다.

QLowEnergyHandle

블루투스 저에너지(BLE) ATT 속성 핸들을 위한 typedef.

enum class QBluetooth::Security
flags QBluetooth::SecurityFlags

이 열거형은 블루투스 서비스의 보안 요구 사항을 설명합니다.

상수	값	설명
`QBluetooth::Security::NoSecurity`	`0x00`	이 서비스는 보안이 필요하지 않습니다.
`QBluetooth::Security::Authorization`	`0x01`	장치가 'Authorized-Paired' 상태가 아닌 한, 이 서비스는 사용자의 인증을 필요로 합니다.
`QBluetooth::Security::Authentication`	`0x02`	이 서비스에는 인증이 필요합니다. 기기가 '승인된 페어링(Authorized-Paired)' 상태가 아닌 경우, 기기는 페어링되어 있어야 하며 연결 시 사용자에게 확인 메시지가 표시됩니다.
`QBluetooth::Security::Encryption`	`0x04`	이 서비스를 이용하려면 통신 링크가 암호화되어 있어야 합니다. 이를 위해서는 기기가 페어링되어 있어야 합니다.
`QBluetooth::Security::Secure`	`0x08`	이 서비스는 통신 링크가 안전해야 합니다. Bluetooth 2.1 이상 버전의 단순 페어링이 필요합니다. 레거시 페어링은 허용되지 않습니다.

SecurityFlags 유형은 QFlags<Security>에 대한 typedef입니다. 이 유형은 Security 값들의 OR 조합을 저장합니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.