NdefLibrary

Description

NFC Data Exchange format (NDEF) specifies a common data format for NFC Forum-compliant devices and NFC Forum-compliant tags. Version 1.0 of this specification can be found here.^[1]

This library is intended for use in applications that use external NFC readers (such as TapTrack Tappy readers) from which NDEF messages must be validated, parsed, and composed.

This library supports NDEF messages with the following record types:

• Text records
• URI records
• Generic records

Installation Using CocoaPods

pod'NdefLibrary'

How to Use

Creating Records

Text Records

You can create a text record by specifying the text encoding type, the language code, and the text.

letencoding=TextRecord.TextEncodingType.Utf8
letlanguageCode:String="en"lettext:String="hello world!"
// Construct the text record.
lettextRecord=Ndef.CreateTextRecord(textEncoding: encoding, languageCode: languageCode, text: text)

You can create a TextRecord from a raw byte array by passing it to the Ndef.makeNdefMessage(rawByteArray:) function (see Parsing Raw NDEF Messages below).

URI Records

You can create a URI record by specifying the URI string.

letgithubUrl="https://www.github.com/"
// Construct the URI record.
leturiRecord=Ndef.CreateUriRecord(uri: githubUrl)

You can create a UriRecord from a raw byte array by passing it to the Ndef.makeNdefMessage(rawByteArray:) function (see Parsing Messages below).

Generic Records

To create a record of any other type, you can use the GenericRecord object. You will need to specify the Type Name Format, the record type, and the payload.

lettnf=Ndef.TypeNameFormat.external
letrecordType:[UInt8]=[0x74,0x65,0x73,0x74]letrecordPayload:[UInt8]=[0x63,0x75,0x73,0x74,0x6f,0x6d]
// Construct a custom NDEF record. This method will return nil if the payload is invalid.
letcustomRecord=Ndef.CreateGenericRecord(tnf: tnf, type: recordType, payload: recordPayload)

Creating NDEF Messages

You can construct an NDEF message by specifying an array of records.

letmyRecords:[NdefRecord]=[record1, record2, record3]
// Construct an NDEF message.
letmessage=Ndef.CreateNdefMessage(records: myRecords)

You can also convert the NdefMessage object into a raw byte array by calling the toByteArray() instance method.

letrawMessage= message.toByteArray()

Parsing Raw NDEF Messages

You can parse raw NDEF messages by passing the raw byte array to the Ndef.makeNdefMessage(rawByteArray:) function. It will return an NdefMessage object that contains an array of NDEF records, which you can access though the records field.

Note: Chunked records are not currently supported. The Ndef.makeNdefMessage(rawByteArray:) function will return nil if it encounters a record with the chunked flag set.

// Empty NDEF record for example purposes.
letrawNdefMessage:[UInt8]=[0xD0,0x00,0x00]
// Construct an NdefMessage from a raw byte array. If the raw byte array does
// not represent a valid, complete NDEF message, this method will return nil.
letmessage=Ndef.CreateNdefMessage(rawByteArray: rawNdefMessage)
// Unwrap the message and get the array of records.
varrecords:[NdefRecord]=[]iflet unwrappedMsg = message {
records = unwrappedMsg.records
}

You can then access the fields of each record.

// Print out the TNF, type, and payload of each record in the NDEF message.
forrecordin records {print("Type Name Format: \(record.tnf)")print("Type: \(record.type)")print("Payload: \(record.payload)")}

To access record-specific fields, you will need to downcast.

// Get the contents of a TextRecord by downcasting.
iflet textRecord =records[0]as?TextRecord{letencoding= textRecord.textEncoding
letlanguage= textRecord.languageCode
lettext= textRecord.text
}
// Get the contents of a UriRecord by downcasting.
iflet uriRecord =records[1]as?UriRecord{leturiString= uriRecord.uri
}

Optional Return Values

Note that some of the record constructing functions will return optional values that must be unwrapped before use. See above for examples of unwrapping. You can also refer to the official Swift documentation for a more detailed explanation.

Contributors

Author: Alice Cai

Library maintained by TapTrack (info@taptrack.com).

License

NdefLibrary is available under the MIT license. See the LICENSE file for more info.

Footnotes

^[1] This link may not persist because the NFC Forum has limited access to its specifications to paying members and may force this page to be removed in the future.