QBluetoothLocalDevice Class

멤버 기능 문서

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(QObject *parent = nullptr)

parent 를 사용하여 QBluetoothLocalDevice를 구축합니다.

isValid()도 참조하세요 .

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)

address 에 대한 새 QBluetoothLocalDevice를 생성합니다. address 이 기본 구성되면 결과 로컬 장치는 로컬 기본 장치를 선택합니다.

isValid()도 참조하세요 .

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

QBluetoothLocalDevice 를 파괴합니다.

QBluetoothAddress QBluetoothLocalDevice::address() const

이 블루투스 장치의 MAC 주소를 반환합니다.

[static] QList<QBluetoothHostInfo> QBluetoothLocalDevice::allDevices()

사용 가능한 모든 로컬 Bluetooth 장치 목록을 반환합니다. macOS에서는 '기본' 로컬 장치만 있습니다.

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

연결된 디바이스 목록을 반환합니다. 이 목록은 현재 페어링된 디바이스 목록과 다릅니다.

Android 및 macOS에서는 연결된 디바이스 목록을 검색할 수 없습니다. (연결 해제) 변경 사항을 수신하는 것만 가능합니다. 편의를 위해 이 클래스는 인스턴스화 이후 모든 연결 및 연결 해제 이벤트를 모니터링하고 이 함수를 호출할 때 현재 목록을 반환합니다. 따라서 이 함수는 인스턴스를 생성한 직후 빈 리스트를 반환할 수 있습니다.

deviceConnected() 및 deviceDisconnected()도 참조하세요 .

[signal] void QBluetoothLocalDevice::deviceConnected(const QBluetoothAddress &address)

이 신호는 로컬 장치가 address 를 사용하여 원격 장치에 연결을 설정할 때 발생합니다.

deviceDisconnected() 및 connectedDevices()도 참조하세요 .

[signal] void QBluetoothLocalDevice::deviceDisconnected(const QBluetoothAddress &address)

이 신호는 로컬 장치가 원격 Bluetooth 장치에서 address 을 사용하여 연결을 끊을 때 방출됩니다.

deviceConnected() 및 connectedDevices()도 참조하세요 .

[signal, since 6.2] void QBluetoothLocalDevice::errorOccurred(QBluetoothLocalDevice::Error error)

페어링 중 error 예외가 발생하면 신호가 전송됩니다.

이 기능은 Qt 6.2에 도입되었습니다.

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

이 로컬 블루투스 장치의 현재 호스트 모드를 반환합니다. macOS에서는 HostPoweredOff 또는 HostConnectable 입니다.

setHostMode()도 참조하세요 .

[signal] void QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

호스트의 state 이 다른 HostMode 으로 전환되었습니다.

bool QBluetoothLocalDevice::isValid() const

QBluetoothLocalDevice 이 사용 가능한 로컬 Bluetooth 장치를 나타내면 true 을 반환하고, 그렇지 않으면 false 를 반환합니다.

이 클래스의 인스턴스로 표시되는 로컬 Bluetooth 어댑터가 시스템에서 제거되면(예: 기본 Bluetooth 동글 제거) 이 인스턴스는 유효하지 않게 됩니다. 이미 유효하지 않은 QBluetoothLocalDevice 인스턴스는 동일한 Bluetooth 어댑터가 시스템으로 반환되더라도 유효하지 않은 상태로 유지됩니다.

allDevices()도 참조하세요 .

QString QBluetoothLocalDevice::name() const

이 블루투스 장치에 사용자가 지정한 이름을 반환합니다.

[signal] void QBluetoothLocalDevice::pairingFinished(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

페어링 또는 페어링 해제가 완료되었습니다 address. 현재 페어링 상태는 pairing 입니다. 페어링 요청이 성공하지 못한 경우 이 신호는 전송되지 않습니다. 페어링 요청이 실패한 경우 errorOccurred() 신호가 전송됩니다. 이 신호는 현재 개체 인스턴스의 requestPairing()를 호출하여 이전에 요청했던 페어링 요청에 대해서만 발생합니다.

QBluetoothLocalDevice::Pairing QBluetoothLocalDevice::pairingStatus(const QBluetoothAddress &address) const

address 의 현재 블루투스 페어링 상태(페어링되지 않았거나, 페어링되었거나, 페어링되고 인증된 경우)를 반환합니다.

void QBluetoothLocalDevice::powerOn()

디바이스의 전원이 꺼져 있는 경우 hostMode() 상태로 되돌리고 나서 디바이스의 전원을 켭니다.

void QBluetoothLocalDevice::requestPairing(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

address 으로 pairing 상태를 설정합니다. 결과는 pairingFinished() 신호로 반환됩니다.

Android 및 macOS에서는 AuthorizedPaired 을 사용할 수 없으며 페어링된 상태와 동일한 동작을 합니다. Windows에서는 정확한 페어링 모드 결정은 운영 체제에 따라 다릅니다.

macOS에서는 디바이스의 페어링을 해제할 수 없습니다. 페어링 해제를 요청하면 장치가 페어링된 상태로 유지되더라도 pairingFinished()가 즉시 전송됩니다. 이전에 페어링되지 않은 디바이스에 대해 페어링을 요청할 수 있습니다. 또한 AuthorizedPaired 은 Paired 과 동일한 동작을 합니다.

주의: 페어링을 만드는 데 몇 분 정도 걸릴 수 있으며 사용자의 승인이 필요할 수 있습니다.

void QBluetoothLocalDevice::setHostMode(QBluetoothLocalDevice::HostMode mode)

이 로컬 Bluetooth 장치의 호스트 모드를 mode 으로 설정합니다.

장치를 켜거나 끄는 등의 일부 전환에는 다소 시간이 걸릴 수 있습니다. 따라서 후속 호출은 hostModeStateChanged() 신호가 이전 요청을 완료한 후에만 수행해야 합니다. 이를 무시하면 이러한 일련의 호출 결과가 제대로 정의되지 않습니다.

hostMode()도 참조하세요 .