QBluetoothLocalDevice Class

メンバー機能のドキュメント

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

QBluetoothLocalDevice をparent で構築します。

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)

この信号は、ローカル・デバイスがリモートのBluetoothデバイスから切断する際にaddress 。

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 の現在のブルートゥースペアリングステータス（ペアリングされていない、ペアリングされている、ペアリングされており認証されている）を返します。

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()も参照して ください。