程序包 ohos.nfc.tag

类 NdefTag

java.lang.Object

ohos.nfc.tag.TagManager

ohos.nfc.tag.NdefTag

public class NdefTag
extends TagManager

Provides interfaces to create an NdefTag object, control connections to the NDEF tag, and read data from and write data to the NDEF tag.

This class inherits from TagManager.

从以下版本开始:

3

SystemCapability

SystemCapability.Communication.NFC

字段概要

字段

限定符和类型	字段	说明
static String	NDEF_TYPE_1	Indicates the NDEF tag of type 1.
static String	NDEF_TYPE_2	Indicates the NDEF tag of type 2.
static String	NDEF_TYPE_3	Indicates the NDEF tag of type 3.
static String	NDEF_TYPE_4	Indicates the NDEF tag of type 4.
static String	NDEF_TYPE_ICODE_SLI	Indicates the NDEF tag of the iCODE SLI type.
static String	NDEF_TYPE_MIFARE_CLASSIC	Indicates the NDEF tag of the Mifare Classic type..

从类继承的字段 ohos.nfc.tag.TagManager

ISO_DEP, MIFARE_CLASSIC, MIFARE_ULTRALIGHT, NDEF, NFC_A, NFC_B, NFC_F, NFC_V

构造器概要

构造器

构造器	说明
NdefTag(TagInfo tagInfo)	Obtains an NdefTag object based on the given tag information.

方法概要

限定符和类型	方法	说明
boolean	canSetReadOnly()	Checks whether this NDEF tag can be set to read-only.
static Optional<NdefTag>	getInstance(TagInfo tagInfo)	Obtains an instance of NdefTag object based on the given tag information.
int	getNdefMaxSize()	Obtains the maximum NDEF message size.
NdefMessage	getNdefMessage()	Obtains the NDEF message from this NDEF tag.
String	getTagType()	Obtains the NDEF tag type.
boolean	isNdefWritable()	Checks whether the NDEF tag is writable.
NdefMessage	readNdefMessage()	Reads the NDEF message from currently connected tag.
boolean	setReadOnly()	Sets the NDEF tag to read-only.
void	writeNdefMessage(NdefMessage msg)	Writes the NDEF message to currently connected NDEF tag.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从类继承的方法 ohos.nfc.tag.TagManager

checkConnected, connectTag, getMaxSendLength, getSendDataTimeout, getTagInfo, isTagConnected, reset, sendData, setSendDataTimeout

字段详细资料

NDEF_TYPE_1

public static final String NDEF_TYPE_1

Indicates the NDEF tag of type 1.

从以下版本开始:

3

另请参阅:

常量字段值

NDEF_TYPE_2

public static final String NDEF_TYPE_2

Indicates the NDEF tag of type 2.

从以下版本开始:

3

另请参阅:

常量字段值

NDEF_TYPE_3

public static final String NDEF_TYPE_3

Indicates the NDEF tag of type 3.

从以下版本开始:

3

另请参阅:

常量字段值

NDEF_TYPE_4

public static final String NDEF_TYPE_4

Indicates the NDEF tag of type 4.

从以下版本开始:

3

另请参阅:

常量字段值

NDEF_TYPE_ICODE_SLI

public static final String NDEF_TYPE_ICODE_SLI

Indicates the NDEF tag of the iCODE SLI type.

从以下版本开始:

3

另请参阅:

常量字段值

NDEF_TYPE_MIFARE_CLASSIC

public static final String NDEF_TYPE_MIFARE_CLASSIC

Indicates the NDEF tag of the Mifare Classic type..

从以下版本开始:

3

另请参阅:

常量字段值

构造器详细资料

NdefTag

public NdefTag(TagInfo tagInfo)

Obtains an NdefTag object based on the given tag information.

If the given tag is NDEF formatted, an NdefTag object will be created based on the given tag information; otherwise, an empty NdefTag object will be created.

参数:

tagInfo - Indicates the information about the given tag.

从以下版本开始:

3

方法详细资料

getInstance

public static Optional<NdefTag> getInstance(TagInfo tagInfo)

Obtains an instance of NdefTag object based on the given tag information.

If the given tag is NDEF formatted, an NdefTag object will be created based on the given tag information; otherwise, an empty NdefTag object will be created.

参数:

tagInfo - Indicates the information about the given tag.

返回:

NdefTag object

从以下版本开始:

3

getNdefMessage

public NdefMessage getNdefMessage()

Obtains the NDEF message from this NDEF tag.

返回:

Returns the NDEF message obtained from this NDEF tag.

从以下版本开始:

3

getNdefMaxSize

public int getNdefMaxSize()

Obtains the maximum NDEF message size.

返回:

Returns the maximum NDEF message size in bytes.

从以下版本开始:

3

getTagType

public String getTagType()

Obtains the NDEF tag type. Example types include NDEF_TYPE_1, NDEF_TYPE_2, NDEF_TYPE_3, and NDEF_TYPE_4.

返回:

Returns the NDEF tag type.

从以下版本开始:

3

readNdefMessage

public NdefMessage readNdefMessage()
                            throws IOException,
                                   IllegalArgumentException

Reads the NDEF message from currently connected tag.

返回:

Returns the NDEF message.

抛出:

IOException - if there is an I/O failure, or the operation is canceled.

IllegalArgumentException - if the NDEF Message on the tag is malformed.

RemoteException - if read the NDEF failed.

从以下版本开始:

3

writeNdefMessage

public void writeNdefMessage(NdefMessage msg)
                      throws IOException,
                             IllegalArgumentException

Writes the NDEF message to currently connected NDEF tag.

参数:

msg - Indicates the NDEF message to write, must not be null.

抛出:

IOException - if there is an I/O failure, or the operation is canceled.

IllegalArgumentException - if the NDEF Message to write is malformed.

RemoteException - if write NDEF Message failed.

从以下版本开始:

3

canSetReadOnly

public boolean canSetReadOnly()

Checks whether this NDEF tag can be set to read-only.

返回:

Returns true if this NDEF tag can be set to read-only; returns false otherwise.

从以下版本开始:

3

setReadOnly

public boolean setReadOnly()
                    throws IOException

Sets the NDEF tag to read-only.

返回:

Returns true if the NDEF tag is set to read-only; returns false otherwise.

抛出:

IOException - if there is an I/O failure, or the operation is canceled.

从以下版本开始:

3

isNdefWritable

public boolean isNdefWritable()

Checks whether the NDEF tag is writable.

返回:

Returns true if the NDEF tag is writable; returns false otherwise.

从以下版本开始:

3