QNearFieldTarget Class

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

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

parent を使用して、新しい近距離場ターゲットを作成します。

[virtual noexcept] QNearFieldTarget::~QNearFieldTarget()

近距離のターゲットを破壊する。

QNearFieldTarget::AccessMethods QNearFieldTarget::accessMethods() const

この近距離フィールドターゲットがサポートしているアクセスメソッドを返します。

bool QNearFieldTarget::disconnect()

ターゲットとの接続を閉じ、別のインスタンスからターゲットとの通信を可能にします。また、QNearFieldTarget が破棄されると、接続も閉じられます。コマンドの処理やNDEFメッセージの読み取り・書き込みを行う際には、ターゲットデバイスへの接続が（再）確立されます。

既存の接続が正常に閉じられた場合にのみ、true を返します。それ以外の場合は、false を返します。

[signal] void QNearFieldTarget::disconnected()

この信号は、近距離のターゲットが検知範囲外へ移動したときに発信されます。

[signal] void QNearFieldTarget::error(QNearFieldTarget::Error error, const QNearFieldTarget::RequestId &id)

このシグナルは、リクエストid の処理中にエラーが発生した際に発せられます。error パラメータには、そのエラーの詳細が記述されています。

bool QNearFieldTarget::hasNdefMessage()

近距離通信ターゲットに少なくとも1つのNDEFメッセージが保存されている場合はtrue を返し、そうでない場合はfalse を返します。

int QNearFieldTarget::maxCommandLength() const

sendCommand で送信可能な最大バイト数を返します。ターゲットがタグタイプ固有のコマンドの送信に対応していない場合は、0 が返されます。

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

[signal] void QNearFieldTarget::ndefMessageRead(const QNdefMessage &message)

このシグナルは、ターゲットから完全なNDEFデータ（message ）が読み取られたときに発信されます。

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

QNearFieldTarget::RequestId QNearFieldTarget::readNdefMessages()

近距離通信ターゲットに保存されているNDEFメッセージの読み取りを開始します。リクエストの完了状況を追跡するために使用できるリクエストIDを返します。ターゲットがNDEFメッセージの読み取りに対応していない場合、無効なリクエストIDが返されます。

各NDEFメッセージごとに、ndefMessageRead()シグナルが発行されます。すべてのNDEFメッセージの読み取りが完了すると、requestCompleted()シグナルが発行されます。エラーが発生した場合は、error()シグナルが発行されます。

[signal] void QNearFieldTarget::requestCompleted(const QNearFieldTarget::RequestId &id)

このシグナルは、リクエスト `id ` が完了した際に発せられます。

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

QVariant QNearFieldTarget::requestResponse(const QNearFieldTarget::RequestId &id) const

リクエスト「id 」のデコード済みレスポンスを返します。リクエストが不明であるか、まだ処理が完了していない場合は、無効なQVariant が返されます。

QNearFieldTarget::RequestId QNearFieldTarget::sendCommand(const QByteArray &command)

近距離のターゲットに「command 」を送信します。リクエストの完了状況を追跡するために使用できるリクエストIDを返します。ターゲットがタグタイプ固有のコマンドの送信に対応していない場合、無効なリクエストIDが返されます。

リクエストが正常に完了すると、requestCompleted() シグナルが発行されます。そうでない場合は、error() シグナルが発行されます。

リクエストが正常に完了すると、requestResponse() 関数から応答を取得できます。このリクエストの応答はQByteArray となります。

requestCompleted() およびwaitForRequestCompleted()も参照してください 。

QNearFieldTarget::Type QNearFieldTarget::type() const

この近距離フィールドターゲットのタグタイプを返します。

QByteArray QNearFieldTarget::uid() const

近距離ターゲットのUIDを返します。

「QNearFieldTarget::AccessMethod」も参照してください 。

bool QNearFieldTarget::waitForRequestCompleted(const QNearFieldTarget::RequestId &id, int msecs = 5000)

リクエスト `id ` が完了するまで、最大msecs ミリ秒待機します。リクエストが正常に完了し、`requestCompeted()` シグナルが発行された場合は `true ` を返します。それ以外の場合は `false` を返します。

QNearFieldTarget::RequestId QNearFieldTarget::writeNdefMessages(const QList<QNdefMessage> &messages)

messages 内のNDEFメッセージをターゲットに書き込みます。リクエストの完了状況を追跡するために使用できるリクエストIDを返します。ターゲットがNDEFメッセージの書き込みに対応していない場合、無効なリクエストIDが返されます。

書き込み操作が正常に完了すると、requestCompleted() シグナルが発信されます。そうでない場合は、error() シグナルが発信されます。