com.kontakt.sdk.android.connection

Class SyncableKontaktDeviceConnection

java.lang.Object

com.kontakt.sdk.android.connection.SyncableKontaktDeviceConnection

public class SyncableKontaktDeviceConnection
extends java.lang.Object

Syncable Kontakt device connection combines KontaktDeviceConnection and KontaktApiClient functionalities. The syncable iBeacon connection allows for immediate pushes to both Bluetooth iBeacon and its representation in kontakt.io Web API.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SyncableKontaktDeviceConnection.SyncWriteBatchListener<T> Abstract class used as listener to notify about batch updating device and syncing with REST API
static class	SyncableKontaktDeviceConnection.SyncWriteListener Abstract class used as listener to notify about updating device and syncing with REST API

Constructor Summary

Constructors

Constructor and Description
SyncableKontaktDeviceConnection(android.content.Context context, RemoteBluetoothDevice remoteBluetoothDevice, IKontaktDeviceConnection.ConnectionListener connectionListener) Instantiates a new Syncable Kontakt device connection.

Method Summary

Modifier and Type	Method and Description
void	applyConfig(IConfig config, SyncableKontaktDeviceConnection.SyncWriteBatchListener<IConfig> syncWriteBatchListener) Applies pending configuration (Config) for Beacon.
void	applySecureConfig(SecureSingleConfig secureConfig, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes secure config and tries to sync with REST API
void	close() Closes Beacon connection releases provided resources.
boolean	connectToDevice() Connects to beacon device
RemoteBluetoothDevice	getDevice() Gets devices that the connection is established with.
boolean	isConnectedToDevice() Returns true if Connection with Beacon is established.
boolean	isDeviceAuthenticated() Returns true if Beacon was successfully authenticated.
void	overwriteAdvertisingInterval(long interval, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes advertising interval and tries to sync with REST API
void	overwriteInstanceId(java.lang.String instanceId, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Overwrites instanceId
void	overwriteMajor(int value, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes major value and tries to sync with REST API
void	overwriteMinor(int value, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes minor value and tries to sync with REST API
void	overwriteModelName(java.lang.String modelName, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes model name and tries to sync with REST API
void	overwriteNamespace(java.lang.String namespaceId, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Overwrites namespae
void	overwritePassword(java.lang.String password, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes password and tries to sync with REST API
void	overwritePowerLevel(int value, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes power level and tries to sync with REST API
void	overwriteProximityUUID(java.util.UUID proximityUUID, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Writes proximity uuid value and tries to sync with REST API
void	overwriteUrl(java.lang.String url, SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener) Overwrites url
void	resetDevice(WriteListener writeListener) Resets device so that connection is established once again.

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncableKontaktDeviceConnection

public SyncableKontaktDeviceConnection(android.content.Context context,
                                       RemoteBluetoothDevice remoteBluetoothDevice,
                                       IKontaktDeviceConnection.ConnectionListener connectionListener)

Instantiates a new Syncable Kontakt device connection.

Parameters:

context - the context

remoteBluetoothDevice - the beacon device

connectionListener - the connection listener

Method Detail

connectToDevice

public boolean connectToDevice()

Connects to beacon device

Returns:

true, if the connection attempt was initiated succesfully

isConnectedToDevice

public boolean isConnectedToDevice()

Returns true if Connection with Beacon is established.

Returns:

the boolean flag indicating whether connection is established.

close

public void close()

Closes Beacon connection releases provided resources.

getDevice

public RemoteBluetoothDevice getDevice()

Gets devices that the connection is established with.

Returns:

the iBeacon device.

isDeviceAuthenticated

public boolean isDeviceAuthenticated()

Returns true if Beacon was successfully authenticated.

Returns:

the boolean flag indicating whether beacon was authenticated.

overwriteMinor

public void overwriteMinor(int value,
                           SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes minor value and tries to sync with REST API

Parameters:

value - the minor value to set

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteMajor

public void overwriteMajor(int value,
                           SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes major value and tries to sync with REST API

Parameters:

value - the major value

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwritePowerLevel

public void overwritePowerLevel(int value,
                                SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes power level and tries to sync with REST API

Parameters:

value - the power level

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteProximityUUID

public void overwriteProximityUUID(java.util.UUID proximityUUID,
                                   SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes proximity uuid value and tries to sync with REST API

Parameters:

proximityUUID - the proximity UUID

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwritePassword

public void overwritePassword(java.lang.String password,
                              SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes password and tries to sync with REST API

Parameters:

password - the password for device

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteAdvertisingInterval

public void overwriteAdvertisingInterval(long interval,
                                         SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes advertising interval and tries to sync with REST API

Parameters:

interval - advertising interval

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteModelName

public void overwriteModelName(java.lang.String modelName,
                               SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes model name and tries to sync with REST API

Parameters:

modelName - model name

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

resetDevice

public void resetDevice(WriteListener writeListener)

Resets device so that connection is established once again.

For more information see kontakt.io Datasheet - version 2.0.

The result callback is invoked by WriteListener.

Parameters:

writeListener - SyncableKontaktDeviceConnection.SyncWriteListener

See Also:

kontakt.io Beacon Datasheet - version 2.0.

overwriteUrl

public void overwriteUrl(java.lang.String url,
                         SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Overwrites url

Parameters:

url - the url

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteNamespace

public void overwriteNamespace(java.lang.String namespaceId,
                               SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Overwrites namespae

Parameters:

namespaceId - the namespace

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

overwriteInstanceId

public void overwriteInstanceId(java.lang.String instanceId,
                                SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Overwrites instanceId

Parameters:

instanceId - the instanceId

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener

applyConfig

public void applyConfig(IConfig config,
                        SyncableKontaktDeviceConnection.SyncWriteBatchListener<IConfig> syncWriteBatchListener)

Applies pending configuration (Config) for Beacon.

* It is possible to encounter problems during batch (the Config in this case) write operation which results in launching error handle callback method. Once the write batch operation failes, the Write Batch Processor will attempt performing rollback write batch operation aiming at restoring original Beacon configuration. The rollback operation however may not succeed as well leaving Beacon device changed partially. Therefore it is strongly advisable to write batches in relatively close distance to Beacon device. Thus, the risk of leaving Beacon in unspecified state may be avoided.

If batch write succeed attempt to sync with REST API will be done

Parameters:

config - Config

syncWriteBatchListener - SyncableKontaktDeviceConnection.SyncWriteBatchListener

applySecureConfig

public void applySecureConfig(SecureSingleConfig secureConfig,
                              SyncableKontaktDeviceConnection.SyncWriteListener syncWriteListener)

Writes secure config and tries to sync with REST API

Parameters:

secureConfig - the secureConfig

syncWriteListener - SyncableKontaktDeviceConnection.SyncWriteListener