com.reelyactive.blesdk.application

Class ReelyAwareApplicationCallback

java.lang.Object

com.reelyactive.blesdk.application.ReelyAwareApplicationCallback

All Implemented Interfaces:

android.app.Application.ActivityLifecycleCallbacks, BleServiceCallback

public abstract class ReelyAwareApplicationCallback
extends java.lang.Object
implements android.app.Application.ActivityLifecycleCallbacks, BleServiceCallback

This class provides a convenient way to make your application aware of any Reelceivers.

Register it using Application.registerActivityLifecycleCallbacks(Application.ActivityLifecycleCallbacks)

Extend it to customize the behaviour of your application.

The default behaviour is to bind to the BleService as soon as the app is created.

See Also:

Application.ActivityLifecycleCallbacks

Constructor Summary

Constructors

Constructor and Description
ReelyAwareApplicationCallback(android.content.Context context) As soon as the component is created, we bindBleService to the BleService

Method Summary

Methods

Modifier and Type	Method and Description
protected void	bindBleService() ************* PRIVATE STUFF ******************
protected int	getActivityCount() Get the number of ReelyAwareActivities currently running (0 or 1 basically)
protected BleService	getBleService() Get access to the underlying service.
protected android.content.Context	getContext() Access the application Context.
protected android.app.Activity	getCurrentActivity() Get currently running Activity.
protected ScanFilter	getScanFilter() Override this in order to chose which scan filter is to be used before startScan() is called when the service starts.
protected BleService.ScanType	getScanType() Override this in order to chose which kind of scan is to be used before startScan() is called when the service starts.
protected static boolean	isReelyAware(android.app.Activity activity) Find out if an Activity implements ReelyAwareActivity
void	onActivityPaused(android.app.Activity activity) The default behaviour is to check if any ReelyAwareActivity is still running, and call a scan if so.
void	onActivityResumed(android.app.Activity activity) The default behaviour is to check if a ReelyAwareActivity is running, and call a scan if so.
void	onBleEvent(BleService.Event event, java.lang.Object data) This method is called when a BleService.Event is received.
protected void	onBleServiceBound() This method is called when the is available.
protected void	startScan() This method sends a scan request to the BleService.
protected void	unbindBleService()
protected void	updateScanFilter(ScanFilter scanFilter) This method sets the scan filter of the BleService.
protected void	updateScanType(BleService.ScanType scanType) This method sets the scan type of the BleService.

Methods inherited from class java.lang.Object

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

Methods inherited from interface android.app.Application.ActivityLifecycleCallbacks

onActivityCreated, onActivityDestroyed, onActivitySaveInstanceState, onActivityStarted, onActivityStopped

Constructor Detail

ReelyAwareApplicationCallback

public ReelyAwareApplicationCallback(android.content.Context context)

As soon as the component is created, we bindBleService to the BleService

Parameters:

context - The application's Context

Method Detail

onActivityResumed

public void onActivityResumed(android.app.Activity activity)

The default behaviour is to check if a ReelyAwareActivity is running, and call a scan if so.
See startScan() and getScanType()

Specified by:

onActivityResumed in interface android.app.Application.ActivityLifecycleCallbacks

Parameters:

activity - The resumed Activity

onActivityPaused

public void onActivityPaused(android.app.Activity activity)

The default behaviour is to check if any ReelyAwareActivity is still running, and call a scan if so.
See startScan() and getScanType()

Specified by:

onActivityPaused in interface android.app.Application.ActivityLifecycleCallbacks

Parameters:

activity - The resumed Activity.

startScan

protected void startScan()

This method sends a scan request to the BleService.

updateScanType

protected void updateScanType(BleService.ScanType scanType)

This method sets the scan type of the BleService.

Parameters:

scanType - The scan type

updateScanFilter

protected void updateScanFilter(ScanFilter scanFilter)

This method sets the scan filter of the BleService.

Parameters:

scanFilter - The scan filter

getScanFilter

protected ScanFilter getScanFilter()

Override this in order to chose which scan filter is to be used before startScan() is called when the service starts.

Returns:

The ScanFilter to be used in the current application state.

getScanType

protected BleService.ScanType getScanType()

Override this in order to chose which kind of scan is to be used before startScan() is called when the service starts.

Returns:

The BleService.ScanType to be used in the current application state.

getActivityCount

protected int getActivityCount()

Get the number of ReelyAwareActivities currently running (0 or 1 basically)

Returns:

The number of ReelyAwareActivities running

onBleEvent

public void onBleEvent(BleService.Event event,
              java.lang.Object data)

This method is called when a BleService.Event is received.
Its default behaviour is to notify the currently running ReelyAwareActivity (if any).
Override this and you can customize the behaviour of the application.

Specified by:

onBleEvent in interface BleServiceCallback

Parameters:

event - The BleService.Event received from the BleService.

getContext

protected android.content.Context getContext()

Access the application Context.

Returns:

The application Context.

getCurrentActivity

protected android.app.Activity getCurrentActivity()

Get currently running Activity.

Returns:

The currently running Activity.

getBleService

protected BleService getBleService()

Get access to the underlying service.

Returns:

The BleService instance running.

isReelyAware

protected static boolean isReelyAware(android.app.Activity activity)

Find out if an Activity implements ReelyAwareActivity

Parameters:

activity - The Activity

Returns:

true if the Activity implements ReelyAwareActivity, false if not.

onBleServiceBound

protected void onBleServiceBound()

This method is called when the is available.
The default behaviour is to start a scan.

bindBleService

protected void bindBleService()

************* PRIVATE STUFF ******************

unbindBleService

protected void unbindBleService()