class QNearFieldTarget

The QNearFieldTarget class provides an interface for communicating with a target device. More…

Synopsis

Methods

• def __init__()

• def accessMethods()

• def disconnect()

• def hasNdefMessage()

• def maxCommandLength()

• def type()

• def uid()

Signals

• def disconnected()

• def ndefMessageRead()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

QNearFieldTarget provides a generic interface for communicating with an NFC target device. Both NFC Forum devices and NFC Forum Tag targets are supported by this class. All target specific classes subclass this class.

The type() function can be used to get the type of the target device. The uid() function returns the unique identifier of the target. The AccessMethods flags returns from the accessMethods() function can be tested to determine which access methods are supported by the target.

If the target supports NdefAccess , hasNdefMessage() can be called to test if the target has a stored NDEF message, readNdefMessages() and writeNdefMessages() functions can be used to get and set the NDEF message.

If the target supports TagTypeSpecificAccess , sendCommand() can be used to send a single proprietary command to the target and retrieve the response.

class Type

This enum describes the type of tag the target is detected as.

Constant	Description
QNearFieldTarget.ProprietaryTag	An unidentified proprietary target tag.
QNearFieldTarget.NfcTagType1	An NFC tag type 1 target.
QNearFieldTarget.NfcTagType2	An NFC tag type 2 target.
QNearFieldTarget.NfcTagType3	An NFC tag type 3 target.
QNearFieldTarget.NfcTagType4	An NFC tag type 4 target. This value is used if the NfcTagType4 cannot be further refined by NfcTagType4A or NfcTagType4B below.
QNearFieldTarget.NfcTagType4A	An NFC tag type 4 target based on ISO/IEC 14443-3A.
QNearFieldTarget.NfcTagType4B	An NFC tag type 4 target based on ISO/IEC 14443-3B.
QNearFieldTarget.MifareTag	A Mifare target.

class AccessMethod

(inherits enum.Flag) This enum describes the access methods a near field target supports.

Constant	Description
QNearFieldTarget.UnknownAccess	The target supports an unknown access type.
QNearFieldTarget.NdefAccess	The target supports reading and writing NDEF messages using readNdefMessages() and writeNdefMessages() .
QNearFieldTarget.TagTypeSpecificAccess	The target supports sending tag type specific commands using sendCommand() .
QNearFieldTarget.AnyAccess	The target supports any of the known access types.

class Error

This enum describes the error codes that a near field target reports.

Constant	Description
QNearFieldTarget.NoError	No error has occurred.
QNearFieldTarget.UnknownError	An unidentified error occurred.
QNearFieldTarget.UnsupportedError	The requested operation is unsupported by this near field target.
QNearFieldTarget.TargetOutOfRangeError	The target is no longer within range.
QNearFieldTarget.NoResponseError	The target did not respond.
QNearFieldTarget.ChecksumMismatchError	The checksum has detected a corrupted response.
QNearFieldTarget.InvalidParametersError	Invalid parameters were passed to a tag type specific function.
QNearFieldTarget.ConnectionError	Failed to connect to the target.
QNearFieldTarget.NdefReadError	Failed to read NDEF messages from the target.
QNearFieldTarget.NdefWriteError	Failed to write NDEF messages to the target.
QNearFieldTarget.CommandError	Failed to send a command to the target.
QNearFieldTarget.TimeoutError	The request could not be completed within the time specified in waitForRequestCompleted() .

__init__([parent=None])

Parameters:

parent – QObject

Constructs a new near field target with parent.

accessMethods()

Return type:

Combination of AccessMethod

Returns the access methods supported by this near field target.

disconnect()

Return type:

bool

Closes the connection to the target to enable communication with the target from a different instance. The connection will also be closed, when the QNearFieldTarget is destroyed. A connection to the target device is (re)created to process a command or read/write a NDEF messages.

Returns true only if an existing connection was successfully closed; otherwise returns false.

disconnected()

This signal is emitted when the near field target moves out of proximity.

hasNdefMessage()

Return type:

bool

Returns true if at least one NDEF message is stored on the near field target; otherwise returns false.

maxCommandLength()

Return type:

int

Returns the maximum number of bytes that can be sent with sendCommand . 0 will be returned if the target does not support sending tag type specific commands.

See also

sendCommand()

ndefMessageRead(message)

Parameters:

message – QNdefMessage

This signal is emitted when a complete NDEF message has been read from the target.

See also

readNdefMessages()

type()

Return type:

Type

Returns the type of tag type of this near field target.

uid()

Return type:

QByteArray

Returns the UID of the near field target.

Note

On iOS, this function returns an empty QByteArray for a near field target discovered using NdefAccess method.

See also

AccessMethod