com.estimote.mgmtsdk.connection.api

Class DeviceConnectionProvider

java.lang.Object

com.estimote.mgmtsdk.connection.api.DeviceConnectionProvider

public class DeviceConnectionProvider
extends java.lang.Object

Establishes connection to device based of provided ConfigurableDevice object. See method getConnection(ConfigurableDevice). Usage:

 DeviceConnectionProvider connectionProvider = new DeviceConnectionProvider(this);

 connectionProvider.connectToService(new DeviceConnectionProvider.ConnectionProviderCallback() {
      @Override public void onConnectedToService() {
        // At this point you can obtain connection from ConnectionProvider
        DeviceConnection connection = connectionProvider.getConnection(device);
        connection.connect(new DeviceConnectionCallback() {
             @Override public void onConnected() {
                // At this point Bluetooth connection is established.
                log("Connected to device");
            }

             @Override public void onAuthenticated(DeviceConnection connection) {
                // At this point device is connected and authenticated.
                readSettings(connection);
                readSensors(connection);
            }

             @Override public void onDisconnected() {
                log("Disconnected from device");
            }

             @Override public void onConnectionFailed(DeviceConnectionException exception) {
                handleException(exception);
            }
 });

  ....

   @Override protected void onDestroy() {
      connectionProvider.destroy();
      super.onDestroy();
  }

 

Author:

lukasz.pobereznik@estimote.com (Lukasz Pobereznik)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DeviceConnectionProvider.ConnectionProviderCallback

Constructor Summary

Constructors

Constructor and Description
DeviceConnectionProvider(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
void	connectToService(DeviceConnectionProvider.ConnectionProviderCallback callback) Connects to the connection service.
void	destroy() Destroys service and kills all current connections.
DeviceConnection	getConnection(ConfigurableDevice device) Gets or creates new connection for given configurable device.
DeviceConnection	getConnectionForStorageRead(ConfigurableDevice device) Gets or creates new connection for given configurable device without authorisation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DeviceConnectionProvider

public DeviceConnectionProvider(android.content.Context context)

Method Detail

connectToService

public void connectToService(DeviceConnectionProvider.ConnectionProviderCallback callback)

Connects to the connection service. See DeviceConnectionProviderService

Parameters:

callback - Callback called when connected to Android service.

getConnection

public DeviceConnection getConnection(ConfigurableDevice device)

Gets or creates new connection for given configurable device.

Note: For not supported devices it return null.

Note: Service must be connected first, otherwise it will throw an exception.

Parameters:

device - configurable device object. It can be obtained from BeaconManager.

Returns:

new or existing connection or null if device is not supported.

getConnectionForStorageRead

public DeviceConnection getConnectionForStorageRead(ConfigurableDevice device)

Gets or creates new connection for given configurable device without authorisation. This method is for reading device's settings with fast connection time.

Note: For not supported devices it return null.

Note: Service must be connected first, otherwise it will throw an exception.

Parameters:

device - configurable device object. It can be obtained from BeaconManager.

Returns:

new or existing connection or null if device is not supported.

destroy

public void destroy()

Destroys service and kills all current connections.