ITagTechnology Interface

Reference

Definition

Namespace:: Android.Nfc.Tech

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

TagTechnology is an interface to a technology in a Tag.

[Android.Runtime.Register("android/nfc/tech/TagTechnology", "", "Android.Nfc.Tech.ITagTechnologyInvoker")]
public interface ITagTechnology : IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable

[<Android.Runtime.Register("android/nfc/tech/TagTechnology", "", "Android.Nfc.Tech.ITagTechnologyInvoker")>]
type ITagTechnology = interface
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Derived: Android.Nfc.Tech.BasicTagTechnology

Android.Nfc.Tech.IsoDep

Android.Nfc.Tech.MifareClassic

Android.Nfc.Tech.MifareUltralight

Android.Nfc.Tech.Ndef

More…

Attributes: RegisterAttribute

Implements: IJavaObject IJavaPeerable ICloseable IDisposable

Remarks

TagTechnology is an interface to a technology in a Tag.

Obtain a TagTechnology implementation by calling the static method get() on the implementation class.

NFC tags are based on a number of independently developed technologies and offer a wide range of capabilities. The TagTechnology implementations provide access to these different technologies and capabilities. Some sub-classes map to technology specification (for example NfcA, IsoDep, others map to pseudo-technologies or capabilities (for example Ndef, NdefFormatable).

It is mandatory for all Android NFC devices to provide the following TagTechnology implementations. <ul> <li>NfcA (also known as ISO 14443-3A) <li>NfcB (also known as ISO 14443-3B) <li>NfcF (also known as JIS 6319-4) <li>NfcV (also known as ISO 15693) <li>IsoDep<li>Ndef on NFC Forum Type 1, Type 2, Type 3 or Type 4 compliant tags </ul> It is optional for Android NFC devices to provide the following TagTechnology implementations. If it is not provided, the Android device will never enumerate that class via Tag#getTechList. <ul> <li>MifareClassic<li>MifareUltralight<li>NfcBarcode<li>NdefFormatable must only be enumerated on tags for which this Android device is capable of formatting. Proprietary knowledge is often required to format a tag to make it NDEF compatible. </ul>

TagTechnology implementations provide methods that fall into two classes: <em>cached getters</em> and <em>I/O operations</em>. <h4>Cached getters</h4> These methods (usually prefixed by get or is) return properties of the tag, as determined at discovery time. These methods will never block or cause RF activity, and do not require #connect to have been called. They also never update, for example if a property is changed by an I/O operation with a tag then the cached getter will still return the result from tag discovery time. <h4>I/O operations</h4> I/O operations may require RF activity, and may block. They have the following semantics. <ul> <li>#connect must be called before using any other I/O operation. <li>#close must be called after completing I/O operations with a TagTechnology, and it will cancel all other blocked I/O operations on other threads (including #connect with IOException. <li>Only one TagTechnology can be connected at a time. Other calls to #connect will return IOException. <li>I/O operations may block, and should never be called on the main application thread. </ul>

<p class="note"><strong>Note:</strong> Methods that perform I/O operations require the android.Manifest.permission#NFC permission.

Java documentation for android.nfc.tech.TagTechnology.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Properties

Handle	Gets the JNI value of the underlying Android object. (Inherited from IJavaObject)
IsConnected	Helper to indicate if I/O operations should be possible.
JniIdentityHashCode	Returns the value of `java.lang.System.identityHashCode()` for the wrapped instance. (Inherited from IJavaPeerable)
JniManagedPeerState	State of the managed peer. (Inherited from IJavaPeerable)
JniPeerMembers	Member access and invocation support. (Inherited from IJavaPeerable)
PeerReference	Returns a JniObjectReference of the wrapped Java object instance. (Inherited from IJavaPeerable)
Tag	Get the Tag object backing this ITagTechnology object.

Methods

Close()	Disable I/O operations to the tag from this `TagTechnology` object, and release resources.
Connect()	Enable I/O operations to the tag from this `TagTechnology` object.
Disposed()	Called when the instance has been disposed. (Inherited from IJavaPeerable)
DisposeUnlessReferenced()	If there are no outstanding references to this instance, then calls `Dispose()`; otherwise, does nothing. (Inherited from IJavaPeerable)
Finalized()	Called when the instance has been finalized. (Inherited from IJavaPeerable)
SetJniIdentityHashCode(Int32)	Set the value returned by `JniIdentityHashCode`. (Inherited from IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	(Inherited from IJavaPeerable)
SetPeerReference(JniObjectReference)	Set the value returned by `PeerReference`. (Inherited from IJavaPeerable)
UnregisterFromRuntime()	Unregister this instance so that the runtime will not return it from future Java.Interop.JniRuntime+JniValueManager.PeekValue invocations. (Inherited from IJavaPeerable)

Extension Methods

ConnectAsync(ITagTechnology)
JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to

Share via