QNearFieldManager Class

メンバ関数のドキュメント

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

parent を使用して、新しい近距離フィールドマネージャーを構築します。

[virtual noexcept] QNearFieldManager::~QNearFieldManager()

ニアフィールドマネージャーを破壊する。

[signal] void QNearFieldManager::adapterStateChanged(QNearFieldManager::AdapterState state)

このシグナルは、NFCアダプターのstate が変更されるたびに送信されます。

[since 6.2] bool QNearFieldManager::isEnabled() const

デバイスにNFCアダプタが搭載されており、かつそれが有効になっている場合はtrue を返し、そうでない場合はfalse を返します。

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

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

bool QNearFieldManager::isSupported(QNearFieldTarget::AccessMethod accessMethod = QNearFieldTarget::AnyAccess) const

対象のデバイスにNFCアダプタが搭載されている場合はtrue を返し、そうでない場合はfalse を返します。accessMethod が指定された場合、この関数は、NFCアダプタが指定されたaccessMethod をサポートしている場合にのみ、true を返します。

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

[since 6.2] void QNearFieldManager::setUserInformation(const QString &message)

システムがユーザーに表示するメッセージを設定します。ターゲット検出が実行中の場合、message は即座に更新され、進行状況のメッセージとして使用できます。 エラーメッセージを伴わないstartTargetDetection()の呼び出しの前に設定された最後のメッセージが、成功メッセージとして使用されます。ターゲット検出が実行されていない場合、次の検出が開始された際の初期メッセージとして、message が使用されます。デフォルトでは、ユーザーにはメッセージは表示されません。

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

startTargetDetection() およびstopTargetDetection()も参照してください 。

bool QNearFieldManager::startTargetDetection(QNearFieldTarget::AccessMethod accessMethod)

ターゲットの検出を開始し、ターゲット検出が正常に開始された場合はtrue を返し、そうでない場合はfalse を返します。ターゲットが近接範囲内に入った際に、targetDetected()シグナルを発火させます。指定されたaccessMethod を持つタグのみが報告されます。ターゲット検出は、stopTargetDetection()が呼び出されるまで継続します。

異なるaccessMethod を持つターゲットを検出するには、まずstopTargetDetection()を呼び出す必要があります。

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

void QNearFieldManager::stopTargetDetection(const QString &errorMessage = QString())

ターゲットの検出を停止します。次に `startTargetDetection()` が呼び出されるまで、targetDetected() シグナルは発行されなくなります。以前に検出されたターゲットは引き続き有効です。

errorMessage が指定された場合、それはアプリケーションの目的が達成されなかったことをシステムに示すヒントとなります。ユーザーには「errorMessage 」と、それに対応するエラーアイコンが表示されます。errorMessage を空にしてこの関数を呼び出すと、操作が正常に終了したことを意味します。それ以外の場合は、errorMessage をこの関数に渡す必要があります。

関連項目： setUserInformation()。

[signal] void QNearFieldManager::targetDetected(QNearFieldTarget *target)

この信号は、ターゲットが検出されるたびに発信されます。target パラメータは、検出されたターゲットを表します。

このシグナルは、検出されたすべてのターゲットに対して発火します。

QNearFieldManager target の所有権は保持されますが、 のデストラクタが呼び出されるまでは破棄されません。 () を呼び出すことで、所有権を譲渡することができます。QNearFieldManager setParent

このシグナルに接続されたスロットから `target ` を削除せず、代わりに `deleteLater()` を呼び出してください。

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

[signal, since 6.2] void QNearFieldManager::targetDetectionStopped()

このシグナルは、ターゲットの検出が停止されるたびに発生します。

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

[signal] void QNearFieldManager::targetLost(QNearFieldTarget *target)

この信号は、ターゲットが近接範囲外へ移動した際に発信されます。target パラメータは、失われたターゲットを表します。

このシグナルに接続されたスロットからtarget を削除せず、代わりにdeleteLater()を使用してください。

QNearFieldTarget::disconnected()も参照してください 。