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

このBluetoothデバイスのMACアドレスを返します。

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

利用可能なすべてのローカル Bluetooth デバイスのリストを返します。macOS では、「default」というローカルデバイスしか存在しません。

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 を使用してリモートBluetoothデバイスから切断されたときに発せられます。

deviceConnected() およびconnectedDevices()も参照してください 。

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

ペアリング中にerror の例外が発生した場合にシグナルを発行します。

この関数は Qt 6.2 で導入されました。

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

このローカル Bluetooth デバイスの現在のホストモードを返します。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

このBluetoothデバイスにユーザーが割り当てた名前を返します。

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

address により、ペアリングまたはペアリング解除が完了しました。現在のペアリング状態はpairing に格納されています。ペアリング要求が成功しなかった場合、このシグナルは発火しません。ペアリング要求が失敗した場合は、errorOccurred() シグナルが発火します。このシグナルは、現在のオブジェクトインスタンスに対してrequestPairing() を呼び出して事前に要求されたペアリング要求に対してのみ発火します。

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

address の現在のBluetoothペアリング状態（ペアリングされていない、ペアリング済み、またはペアリング済みかつ認証済み）を返します。

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)

このローカルBluetoothデバイスのホストモードをmode に設定します。

デバイスの電源のオン/オフなどの一部の遷移には、時間がかかる場合があります。そのため、hostModeStateChanged() シグナルが前のリクエストを完了してからでないと、後続の呼び出しを行わないでください。これを無視した場合、一連の呼び出しの結果は未定義となります。

hostMode()も参照してください 。