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()

如果近场目标上存储了至少一条 NDEF 消息，则返回true ；否则返回false 。

int QNearFieldTarget::maxCommandLength() const

返回可通过 `sendCommand` 发送的最大字节数。如果目标不支持发送特定标签类型的命令，则返回 0。

另请参阅 sendCommand()。

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

当从目标设备读取完整的NDEFmessage 时，会发出此信号。

另请参阅 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)

等待最多msecs 毫秒，直至请求id 完成。如果请求成功完成且触发了 requestCompleted() 信号，则返回true ；否则返回false 。

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

将messages 中的NDEF消息写入目标设备。返回一个请求ID，可用于跟踪请求的完成状态。如果目标设备不支持写入NDEF消息，则会返回一个无效的请求ID。

当写入操作成功完成时，将触发requestCompleted()信号；否则将触发error()信号。