com.estimote.mgmtsdk.feature.bulk_updater

Interface BulkUpdater

public interface BulkUpdater

Bulk updater is a stand alone object that takes scans from your BeaconManager and updates devices that belongs to the user. In basic form it will simply connect to the device and synchronise it with Estimote cloud. This operation can be customised with firmware update or custom settings to write. The bulk updater runs constantly and checks if scanned devices have any new changes to apply. You need to feed it with actual scans from BeaconManager.ConfigurableDevicesListener using method onDevicesFound(List); Each beacon status is being reported via BulkUpdater.BulkUpdaterCallback so you can easily display it in the UI.

Author:

Pawel Dylag (pawel.dylag@estimote.com)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BulkUpdater.BulkUpdaterCallback Callback for listening on bulk update events.
static class	BulkUpdater.Status Current status of scanned devices.

Method Summary

Modifier and Type	Method and Description
void	destroy() Because bulk updater uses underlying service for handling connection to devices, it is necessary to call this on your activity's onDestroy method.
boolean	isDeviceUpdating(DeviceId device) Checks if given device is currently being updated by bulk updater.
void	onDevicesFound(java.util.List<ConfigurableDevice> devices) Feeds bulk updater with current scanned data.
void	start(BulkUpdater.BulkUpdaterCallback callback) Starts bulk updating process with callback to notify about progress.
void	stop() Stops bulk updating process.

Method Detail

start

void start(BulkUpdater.BulkUpdaterCallback callback)

Starts bulk updating process with callback to notify about progress. When restarting, new callback will override old one.

stop

void stop()

Stops bulk updating process. It will simply make all onDevicesFound(List) calls to do nothing. You can restart updater using again start(BulkUpdaterCallback) method (callback will be overridden).

isDeviceUpdating

boolean isDeviceUpdating(DeviceId device)

Checks if given device is currently being updated by bulk updater. Returned value will be 'true' if corresponding device current status is BulkUpdater.Status.UPDATING

onDevicesFound

void onDevicesFound(java.util.List<ConfigurableDevice> devices)

Feeds bulk updater with current scanned data. It is recommended to hook this method in BeaconManager.ConfigurableDevicesListener which is notified by BeaconManager. You can configure whole scanning parameters there.

destroy

void destroy()

Because bulk updater uses underlying service for handling connection to devices, it is necessary to call this on your activity's onDestroy method.