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)

このシグナルは、ローカル・デバイスが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()も参照してください 。