NDEF Library for NFC
npm install ndef-lib> Easily parse and create NDEF records.
> A wrapping of Andijakl NDEF library in a npm module
- Install
- Usage
- Original doc
- License
npm:
``sh`
npm install ndef-lib
yarn:
`sh`
yarn add ndef-lib
1. Install node.js from: http://nodejs.org/
2. Start "node.js command prompt" as administrator
3. Install grunt CLI: > npm install -g grunt-cli
4. Go to project root directory and download & install project dependencies: > npm install
5. Run grunt build: > grunt build
Example:
`sh`
node node_modules/ndef-lib/example.js
- [x] text record
- [x] uri record
- [x] geolocation record (uri)
- [x] social record (uri)
- [x] Tel record (uri)
- [x] Android App record
- [x] NDEF message
`js`
// Create NDEF Message
var ndefMessage = new NdefLibrary.NdefMessage();
// Create NDEF Uri Record
var ndefUriRecord = new NdefLibrary.NdefUriRecord();
// Set Uri in record
ndefUriRecord.setUri("https://www.mobilefactory.at");
// Add record to message
ndefMessage.push(ndefUriRecord);
// Get byte array for NFC tag
var byteArray = ndefMessage.toByteArray();
`js
var recordType = new Array(1, 3, 1, 3, 5, 6, 7);
var recordPayload = new Array(1, 2, 1);
var id = new Array(3, 3);
var ndefRecord2 = new NdefLibrary.NdefRecord(
NdefLibrary.NdefRecord.TypeNameFormatType.NfcRtd,
recordType
);
ndefRecord2.setPayload(recordPayload);
ndefRecord2.setId(id);
var ndefMessage = new NdefLibrary.NdefMessage();
ndefMessage.push(ndefRecord2);
var byteArray = ndefMessage.toByteArray();
`
`js``
var ndefMessage = NdefLibrary.NdefMessage.fromByteArray(byteArray);
NFC tags as well as the content sent in device-to-device communication when tapping two phones is based on certain standards by the NFC Forum (called NDEF – NFC Data Exchange format). Luckily, these standards were well received and nearly all manufacturers are part of the standardization body. This ensures that public NFC tags can actually be read by all mobile phones today.
When it comes to storing data on NFC tags that can have as little writable storage as around 40 bytes, very efficient and complex data storage schemes are necessary. The downside is that most operating systems do integrate the NFC data transmission at the base level, but offer developers very little support for the NDEF standards on top. Obviously, reading those technical documents isn’t generally too much fun – to create an own implementation of a message that stores a simple URL on a tag, a developer would need to read and understand 59 pages of specifications.
As this is a lot work, there is the risk of people creating own solutions, leading to a fragmented NFC ecosystem
The open source NFC / NDEF Library contains a large set of classes that take care of formatting your data according to NDEF standards, so that these can be directly written to NFC tags or sent to other devices.
In your app, you choose the corresponding record type (e.g., for URLs, emails or geo tags) and provide the necessary data. The library creates an NDEF message out of the data, which you can directly send to the NFC stack in your operating system as a byte array, which takes care of writing it to a tag or publishing it to another device (using the SNEP protocol).
Additionally, the library can parse NDEF byte arrays that you read from tags or receive from other devices and create a list (NDEF Message) of data classes (NDEF records) that you can easily analyze and use in your app.
For Windows (Phone) 8, the NFC stack is represented through the Proximity APIs - they encapsulate NFC hardware communication and basic NDEF formatting for a very limited subset of the NDEF standards. This missing part is added by this NDEF library.
- Parse NDEF message & records from raw byte arrays
- Extract all information from the bits & bytes contained in the record
- Create standard compliant records just by providing your data
- Identify the exact record type when reading an NDEF message
- Records check their contents for validity according to standards
- Can throw NdefException in case of content validity issues, with translatable messages defined in a resource file
- Fully documented source code, following Doxygen standards
- Supported NDEF records:
- URI: the most common type: any kind of URI, for example an Internet address, email link or any custom URI scheme.
- Smart Poster: combines a URL with textual descriptions in various languages
- Text records: contains text in a specific language
- Microsoft LaunchApp: launch a Windows (Phone) app just by tapping a tag
- Android Application Record (AAR): launch an Android app
- Convenience classes extending the basic URI class for common use case scenarios:
- Geo: longitude & latitude of a place, using different Geo URI schemes (more details)
- Social: linking to social networks like Twitter, Facebook, Foursquare or Skype
- Telephone call: defining the number to call
Any open issues as well as planned features are tracked in:
https://github.com/andijakl/ndef-nfc/issues
Known issues and limitations:
- Text record does not support UTF-16 encoding yet.
- Does not identify specialized types for URL records (e.g., Tel record)
- Unit test issue: URL encoding of special characters not equivalent to C# output.
- Unit test issue: UTF-16 text comparison with string.
Released under the LGPL license - see the LICENSE.LGPL file for details.
Ported to Javascript by Sebastian Höbarth, http://www.mobilefactory.at/
Developed by Andreas Jakl, https://twitter.com/andijakl
Parts of this library are based on the respective code of the Connectivity Module of Qt Mobility (NdefMessage, NdefRecord, NdefUriRecord and NdefTextRecord classes. Original source code: http://qt.gitorious.org/qt-mobility).
More information about the library:
http://andijakl.github.io/ndef-nfc/