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()

사용 가능한 모든 로컬 블루투스 장치 목록을 반환합니다. 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)

이 신호는 로컬 장치가 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 가 사용 가능한 로컬 블루투스 장치를 나타내는 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.

이 클래스의 인스턴스가 나타내는 로컬 블루투스 어댑터가 시스템에서 제거되면(예: 기본 블루투스 동글 제거), 이 인스턴스는 무효화됩니다. 이미 무효화된 QBluetoothLocalDevice 인스턴스는 동일한 블루투스 어댑터가 시스템에 다시 연결되더라도 계속 무효한 상태로 유지됩니다.

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 을 설정할 수 없으며, Paired와 동일한 동작을 보입니다. Windows에서는 정확한 페어링 모드 결정은 운영 체제에 달려 있습니다.

macOS에서는 기기의 페어링을 해제할 수 없습니다. Unpaired가 요청되면, 기기는 페어링된 상태를 유지하지만 pairingFinished() 신호가 즉시 발생합니다. 이전에 페어링이 해제된 기기에 대해 페어링을 다시 요청할 수 있습니다. 또한 AuthorizedPaired 는 Paired 와 동일한 동작을 보입니다.

주의: 페어링 설정에는 몇 분이 소요될 수 있으며, 사용자의 확인이 필요할 수 있습니다.

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

이 로컬 블루투스 장치의 호스트 모드를 ‘ mode ’로 설정합니다.

장치의 전원을 켜거나 끄는 것과 같은 일부 전환 작업에는 시간이 다소 소요될 수 있습니다. 따라서 hostModeStateChanged() 신호가 이전 요청을 완료한 후에만 후속 호출을 수행해야 합니다. 이를 무시할 경우, 이러한 일련의 호출 결과는 정의되지 않을 수 있습니다.

hostMode()도 참조하십시오 .