.. java:import:: android.app Activity

ReaderEvents
============

.. java:package:: com.idopte.scmapi
   :noindex:

.. java:type:: public interface ReaderEvents

   Interface used to received smart card reader events.

   The methods are not called within the context of the main UI thread. If UI actions must be made within these methods, you can delegate the operation to \ :java:ref:`android.app.Activity.runOnUiThread(Runnable)`\ , or post a \ :java:ref:`Runnable`\  to the UI thread through a \ :java:ref:`android.os.Handler`\ .

   Also note that due to system restrictions, it is only possible to correctly report events when the Smart Card Middleware application is in foreground (not the target application). See \ :java:ref:`SCMEnvironment.openWaitForTokenDialog(Activity)`\ .

Methods
-------
onReaderAdded
^^^^^^^^^^^^^

.. java:method::  void onReaderAdded(Reader reader)
   :outertype: ReaderEvents

   Called when a new reader is plugged on the device, or a bluetooth reader discovered.

   :param reader: the new \ :java:ref:`Reader`\  object.

onReaderRemoved
^^^^^^^^^^^^^^^

.. java:method::  void onReaderRemoved(Reader reader)
   :outertype: ReaderEvents

   Called when a reader is unplugged from the computer.

   :param reader: the removed \ :java:ref:`Reader`\  object.

onReaderStateChanged
^^^^^^^^^^^^^^^^^^^^

.. java:method::  void onReaderStateChanged(Reader reader)
   :outertype: ReaderEvents

   Called when the state of a reader changes (e.g. insertion or withdrawal of a card, ...).

   :param reader: the affected \ :java:ref:`Reader`\  object. Its properties can be consulted (e.g. using \ :java:ref:`Reader.getStatus()`\ , \ :java:ref:`Reader.isCardPresent()`\ , ...) to obtain more information about the event.

onTokenArrival
^^^^^^^^^^^^^^

.. java:method::  void onTokenArrival(Reader reader)
   :outertype: ReaderEvents

   Called when a token becomes available on a reader.

   Note: this method is called from the default implementation of the ``onReaderXXX`` methods, and can't be used if their implementation is overridden. You have to either use the ``onReaderXXX`` or the ``onTokenXXX`` events, but you cannot use both.

   :param reader: the \ :java:ref:`Reader`\  in which the token is located.

onTokenRemoval
^^^^^^^^^^^^^^

.. java:method::  void onTokenRemoval(Reader reader)
   :outertype: ReaderEvents

   Called when a token is made unavailable (by removing it from the reader, or when the reader is removed).

   Note: this method is called from the default implementation of the ``onReaderXXX`` methods, and can't be used if their implementation is overridden. You have to either use the ``onReaderXXX`` or the ``onTokenXXX`` events, but you cannot use both.

   :param reader: the \ :java:ref:`Reader`\  in which the token was located.