.. java:import:: android.annotation TargetApi

.. java:import:: android.app Activity

.. java:import:: android.content BroadcastReceiver

.. java:import:: android.content ComponentName

.. java:import:: android.content Context

.. java:import:: android.content Intent

.. java:import:: android.os Build

.. java:import:: android.os Handler

.. java:import:: android.os HandlerThread

.. java:import:: com.idopte.scmiddleware Log

.. java:import:: com.idopte.cardsystem.ble BluetoothReaderInterface

.. java:import:: com.idopte.scmapi.http HttpClient

.. java:import:: com.idopte.scmiddleware SCWSSystem

.. java:import:: com.idopte.scmapiembed SCMEmbedEnvironment

.. java:import:: com.idopte.ssl SSLWebViewClient

.. java:import:: org.json JSONArray

.. java:import:: org.json JSONException

.. java:import:: org.json JSONObject

.. java:import:: java.io IOException

.. java:import:: java.security KeyFactory

.. java:import:: java.security NoSuchAlgorithmException

.. java:import:: java.security PublicKey

.. java:import:: java.security.spec InvalidKeySpecException

.. java:import:: java.security.spec X509EncodedKeySpec

.. java:import:: java.util ArrayList

.. java:import:: java.util Base64

.. java:import:: java.util List

.. java:import:: java.util.concurrent ExecutionException

.. java:import:: java.util.concurrent ExecutorService

.. java:import:: java.util.concurrent Executors

.. java:import:: java.util.concurrent Future

.. java:import:: javax.crypto BadPaddingException

.. java:import:: javax.crypto Cipher

.. java:import:: javax.crypto IllegalBlockSizeException

.. java:import:: javax.crypto.spec IvParameterSpec

.. java:import:: javax.crypto.spec SecretKeySpec

SCMEnvironment
==============

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

.. java:type:: public class SCMEnvironment

   Event provider for the \ :java:ref:`ReaderEvents`\  interface. A long polling strategy is used to receive new events from the SCM HTTP server. Every registered \ :java:ref:`ReaderEvents`\  is notified in case of event with the appropriate method.

   This implementation of environment exists for legacy reason. Use \ :java:ref:`SCMEmbedEnvironment`\  to create a new environment to use.

   Any number of \ ``SCMEnvironment``\ , as well as `SCWS` objects from the javascript API, can receive copies of the same event from the SCM HTTP server. However, a same environment must \ **not**\  be used both in java and javascript (through an \ :java:ref:`android.webkit.WebView`\ ) APIs.

Methods
-------
addReaderEventListener
^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public void addReaderEventListener(ReaderEvents listener)
   :outertype: SCMEnvironment

   Registers a new \ :java:ref:`ReaderEvents`\ .

   :param listener: The listener object whose methods will be called when an event occurs.

areCertificatesRegistered
^^^^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public boolean areCertificatesRegistered()
   :outertype: SCMEnvironment

   Gets whether certificates are registered or not.

   :return: ``true`` if certificates are registered, ``false`` otherwise.

getReader
^^^^^^^^^

.. java:method:: public Reader getReader(String name)
   :outertype: SCMEnvironment

   Gets the reader with the given name.

   :param name: The reader name, as a string.
   :return: the \ :java:ref:`Reader`\  object.

getReaders
^^^^^^^^^^

.. java:method:: public List<Reader> getReaders()
   :outertype: SCMEnvironment

   Returns the list of all smart card readers attached to the device.

   :return: the \ :java:ref:`Reader`\  list.

registerCertificates
^^^^^^^^^^^^^^^^^^^^

.. java:method:: public void registerCertificates(Token token) throws SCMException
   :outertype: SCMEnvironment

   Registers certificates.

   Certificates are stored in *app-specific storage*. Registered certificates will be further used in SSL client certificate request through \ :java:ref:`SSLWebViewClient`\ .

   :param token: the token to register certificates for.
   :throws SCMException: if certificates registration failed.

   **See also:** :java:ref:`SCMEnvironment.unregisterCertificates()`

releaseBluetoothPeripheral
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public boolean releaseBluetoothPeripheral() throws SCMException
   :outertype: SCMEnvironment

   Releases the current connected bluetooth peripheral.

   :return: return : true if the device has been released correctly false if the device does not exist and could not be released

removeReaderEventListener
^^^^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public void removeReaderEventListener(ReaderEvents listener)
   :outertype: SCMEnvironment

   Removes a \ :java:ref:`ReaderEvents`\  listener.

   :param listener: The listener object to remove.

startBluetoothScan
^^^^^^^^^^^^^^^^^^

.. java:method:: public boolean startBluetoothScan() throws SCMException
   :outertype: SCMEnvironment

   Starts bluetooth scan.

   :throws SCMException: if bluetooth initialization failed or if a bluetooth peripheral is already paired and connected.
   :return: ``false`` if scanning has already been started, ``true`` otherwise.

startRemoteLogsRecording
^^^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public void startRemoteLogsRecording(String userId) throws SCMException
   :outertype: SCMEnvironment

   Starts to record logs on Idopte remote server.

   Note that logs are **sensitive data** and are sent through ``HTTPS`` protocol. ``userId`` must be a valid code provided by your administrator.

   Calling this function will fail if a \ :java:ref:`com.idopte.tools.Log`\  is set up through \ :java:ref:`com.idopte.tools.Log.setLog(com.idopte.tools.Log)`\ .

   :param userId: id of user given by your administrator, as a ``String`` of digits.

stopBluetoothScan
^^^^^^^^^^^^^^^^^

.. java:method:: public boolean stopBluetoothScan() throws SCMException
   :outertype: SCMEnvironment

   Stops bluetooth scan.

   :throws SCMException: if bluetooth initialization failed.
   :return: ``false`` if bluetooth has already been stopped, ``true`` otherwise.

unregisterCertificates
^^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public void unregisterCertificates() throws SCMException
   :outertype: SCMEnvironment

   Clears the list of registered certificates.

   :throws SCMException: if certificates unregistration failed.

   **See also:** :java:ref:`SCMEnvironment.registerCertificates(Token)`