Nfc

Class Overview

This class acts as an abstraction layer for Android's Nfc stack. The goals of this project are to:

• Provide compatibility for Nfc across platforms.
• Degrade gracefully on platforms and devices lacking Nfc support.
• Extend the capabilities of Nfc by following Connection Handover Requests.
• Simplify the Nfc experience for developers.

The Nfc class must be run from a foregrounded activity. It requires a few lifecycle events be triggered during an activity's runtime:

 class MyActivity extends Activity {
 
   public void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     mNfc = new Nfc(this);
     mNfc.onCreate(this);
   }
 
   public void onResume() {
     super.onResume();
     mNfc.onResume(this);
     // your activity's onResume code
   }

  public void onPause() {
    super.onPause();
    mNfc.onPause(this);
    // your activity's onPause code
  }
  
  public void onNewIntent(Intent intent) {
    if (mNfc.onNewIntent(this, intent)) {
      return;
    }
    // your activity's onNewIntent code
  }
 }
 

Your application must hold the android.permission.NFC permission to use this class. However, this class will degrade gracefully on devices lacking Nfc capabilities.

The Nfc interface can be in one of three modes: MODE_WRITE, for writing to a passive NFC tag, and MODE_EXCHANGE, in which the interface can read data from passive tags and exchange data with another active Nfc device, or MODE_PASSTHROUGH which disables this interface.

• share(NdefMessage) and similar, to share messages with other Nfc devices.
• addNdefHandler(NdefHandler), for acting on received messages.
• enableTagWriteMode(NdefMessage), to write to physical Nfc tags.

Summary

[Expand] Inherited Methods
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)