com.dsi.ant.plugins.antplus.pcc

Class AntPlusStrideSdmPcc

java.lang.Object

com.dsi.ant.plugins.antplus.pccbase.AntPluginPcc

com.dsi.ant.plugins.antplus.pccbase.AntPlusCommonPcc

com.dsi.ant.plugins.antplus.pcc.AntPlusStrideSdmPcc

public class AntPlusStrideSdmPcc
extends AntPlusCommonPcc

Enables communication between a client and the StrideSdm plugin service.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AntPlusStrideSdmPcc.ICalorieDataReceiver Receiver for the CalorieData event, which is: The total calories consumed over the session.
static interface	AntPlusStrideSdmPcc.IComputationTimestampReceiver Receiver for the ComputationTimestamp event, which is: Data about the timing of the last speed and distance computation.
static interface	AntPlusStrideSdmPcc.IDataLatencyReceiver Receiver for the DataLatency event, which is: The sensor reported latency between calculation and sensor transmission.
static interface	AntPlusStrideSdmPcc.IDistanceReceiver Receiver for the Distance event, which is: The total distance travelled since the plugin connected to this device.
static interface	AntPlusStrideSdmPcc.IInstantaneousCadenceReceiver Receiver for the InstantaneousCadence event, which is: The instantaneous cadence data.
static interface	AntPlusStrideSdmPcc.IInstantaneousSpeedReceiver Receiver for the InstantaneousSpeed event, which is: The instantaneous speed data.
class	AntPlusStrideSdmPcc.IpcDefines Defines the keys and values used to communicate between the PCC and plugin.
static interface	AntPlusStrideSdmPcc.ISensorStatusReceiver Receiver for the SensorStatus event, which is: Various status information about the sensor.
static interface	AntPlusStrideSdmPcc.IStrideCountReceiver Receiver for the StrideCount event, which is: The cumulative stride count since the plugin connected to this device.
static class	AntPlusStrideSdmPcc.SensorHealth Reported health of sensor.
static class	AntPlusStrideSdmPcc.SensorLocation Reported location of sensor.
static class	AntPlusStrideSdmPcc.SensorUseState Reported state of use of sensor

Nested classes/interfaces inherited from class com.dsi.ant.plugins.antplus.pccbase.AntPlusCommonPcc

AntPlusCommonPcc.CommonDataPage, AntPlusCommonPcc.IBatteryStatusReceiver, AntPlusCommonPcc.IManufacturerIdentificationReceiver, AntPlusCommonPcc.IManufacturerSpecificDataReceiver, AntPlusCommonPcc.IProductInformationReceiver, AntPlusCommonPcc.IRequestFinishedReceiver, AntPlusCommonPcc.IRssiReceiver

Nested classes/interfaces inherited from class com.dsi.ant.plugins.antplus.pccbase.AntPluginPcc

AntPluginPcc.IDeviceStateChangeReceiver, AntPluginPcc.IPluginAccessResultReceiver<T extends AntPluginPcc>

Field Summary

Fields inherited from class com.dsi.ant.plugins.antplus.pccbase.AntPluginPcc

PATH_ANTPLUS_PLUGINS_PKG

Method Summary

Methods

Modifier and Type	Method and Description
static PccReleaseHandle<AntPlusStrideSdmPcc>	requestAccess(Activity userActivity, Context bindToContext, AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver, AntPluginPcc.IDeviceStateChangeReceiver stateReceiver) Sends a request to the plugin to access a device and receive a live PCC instance.
static PccReleaseHandle<AntPlusStrideSdmPcc>	requestAccess(Activity userActivity, Context bindToContext, boolean skipPreferredSearch, int searchProximityThreshold, AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver, AntPluginPcc.IDeviceStateChangeReceiver stateReceiver) Sends a request to the plugin to access a device and receive a live PCC instance.
static PccReleaseHandle<AntPlusStrideSdmPcc>	requestAccess(Context bindToContext, int antDeviceNumber, int searchProximityThreshold, AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver, AntPluginPcc.IDeviceStateChangeReceiver stateReceiver) Sends a request to the plugin to access a device and receive a live PCC instance.
static AsyncScanController<AntPlusStrideSdmPcc>	requestAsyncScanController(Context bindToContext, int searchProximityThreshold, AsyncScanController.IAsyncScanResultReceiver scanResultReceiver) Sends a request to the plugin to start an asynchronous search for available devices.
void	subscribeCalorieDataEvent(AntPlusStrideSdmPcc.ICalorieDataReceiver CalorieDataReceiver) Subscribe to receive CalorieData events, which contain: The total calories consumed over the session.
void	subscribeComputationTimestampEvent(AntPlusStrideSdmPcc.IComputationTimestampReceiver ComputationTimestampReceiver) Subscribe to receive ComputationTimestamp events, which contain: Data about the timing of the last speed and distance computation.
void	subscribeDataLatencyEvent(AntPlusStrideSdmPcc.IDataLatencyReceiver DataLatencyReceiver) Subscribe to receive DataLatency events, which contain: The sensor reported latency between calculation and sensor transmission.
void	subscribeDistanceEvent(AntPlusStrideSdmPcc.IDistanceReceiver DistanceReceiver) Subscribe to receive Distance events, which contain: The total distance travelled since the plugin connected to this device.
void	subscribeInstantaneousCadenceEvent(AntPlusStrideSdmPcc.IInstantaneousCadenceReceiver InstantaneousCadenceReceiver) Subscribe to receive InstantaneousCadence events, which contain: The instantaneous cadence data.
void	subscribeInstantaneousSpeedEvent(AntPlusStrideSdmPcc.IInstantaneousSpeedReceiver InstantaneousSpeedReceiver) Subscribe to receive InstantaneousSpeed events, which contain: The instantaneous speed data.
void	subscribeSensorStatusEvent(AntPlusStrideSdmPcc.ISensorStatusReceiver SensorStatusReceiver) Subscribe to receive SensorStatus events, which contain: Various status information about the sensor.
void	subscribeStrideCountEvent(AntPlusStrideSdmPcc.IStrideCountReceiver StrideCountReceiver) Subscribe to receive StrideCount events, which contain: The cumulative stride count since the plugin connected to this device.

Methods inherited from class com.dsi.ant.plugins.antplus.pccbase.AntPlusCommonPcc

requestCommonDataPage, subscribeBatteryStatusEvent, subscribeManufacturerIdentificationEvent, subscribeManufacturerSpecificDataEvent, subscribeProductInformationEvent, subscribeRssiEvent, supportsRssi

Methods inherited from class com.dsi.ant.plugins.antplus.pccbase.AntPluginPcc

getAntDeviceNumber, getCurrentDeviceState, getDeviceName, getInstalledPluginsVersionNumber, getInstalledPluginsVersionString, getMissingDependencyName, getMissingDependencyPackageName, isUserPreferredDeviceForPlugin, isUserRecognizedDevice, releaseAccess, startPluginManagerActivity

Methods inherited from class java.lang.Object

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

Method Detail

requestAccess

public static PccReleaseHandle<AntPlusStrideSdmPcc> requestAccess(Activity userActivity,
                                                  Context bindToContext,
                                                  boolean skipPreferredSearch,
                                                  int searchProximityThreshold,
                                                  AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver,
                                                  AntPluginPcc.IDeviceStateChangeReceiver stateReceiver)

Sends a request to the plugin to access a device and receive a live PCC instance. If the minimum version of the desired plugin is installed, this will start a search for a device to connect to and return the result on the provided result receiver. This method displays a search dialog UI while the search is in progress.

If the user has a preferred device set for this plugin and skipPreferredSearch is not set true, this request will attempt to connect to that device first. Then if the search for the preferred device times-out, the user can choose to retry, cancel, or search for other devices. If there is no preferred device configured or skipPreferredSearch is set to true, the search will begin directly at searching for other devices.During the search for other devices, a list of devices detected in range is presented to the user. Any time during the search the user can select a device from the list to connect to, and can optionally save a name for that device and set it as the preferred device for future searches.

Regardless of how the search proceeds, as soon as a device is connected or if an error occurs or the user cancels then the result will be posted to the supplied result receiver.

Note: During the search this function will display UI elements to display the progress of the search to the user and allow them to interact and control the search. If this is not acceptable to the calling application, then do not use this version of requestAccess().

Parameters:

userActivity - The current foreground activity. Used to display search progress and results.

bindToContext - The context to which the plugin will be bound. Used for plugin lifecycle management.

skipPreferredSearch - True = Don't automatically connect to user's preferred device, but always go to search for other devices.

searchProximityThreshold - It is recommended to always use -1 to use the user's default settings unless your application has a specific reason to do otherwise. This value represents the signal strength 'proximity' requirement on finding matches during searching, if a device does not meet the requirements it will not show up in the search at all. The value is a generic signal strength threshold from 1-10 where 1 is the strongest (ie: closest) and 10 is the lowest(ie: farthest away). 0 = don't use proximity search and -1 = use plugin user-specified default.

resultReceiver - The receiver to receive the results of the request. Possible returns include:

• RequestAccessResult.SUCCESS
• RequestAccessResult.USER_CANCELLED
• RequestAccessResult.CHANNEL_NOT_AVAILABLE
• RequestAccessResult.BAD_PARAMS
• RequestAccessResult.ADAPTER_NOT_DETECTED
• RequestAccessResult.DEPENDENCY_NOT_INSTALLED
• RequestAccessResult.OTHER_FAILURE

stateReceiver - The receiver to receive the state updates of the accessed device, assuming the request is successful. This receiver will receive notifications of all state changes to the device that occur subsequent to the initial state returned in the result receiver.

Returns:

A release handle for the device. This can be used to guarantee the device is properly shutdown and cleaned up, even before the device is actually received through the result receiver.

requestAccess

public static PccReleaseHandle<AntPlusStrideSdmPcc> requestAccess(Activity userActivity,
                                                  Context bindToContext,
                                                  AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver,
                                                  AntPluginPcc.IDeviceStateChangeReceiver stateReceiver)

Sends a request to the plugin to access a device and receive a live PCC instance. If the minimum version of the desired plugin is installed, this will start a search for a device to connect to and return the result on the provided result receiver. This method displays a search dialog UI while the search is in progress. This overload calls #requestAccess(Activity, Context, boolean, int, IPluginAccessResultReceiver, IDeviceStateChangeReceiver) with skipPreferrredSearch=false and searchProximityThreshold=-1(user default).

If the user has a preferred device set for this plugin and skipPreferredSearch is not set true, this request will attempt to connect to that device first. Then if the search for the preferred device times-out, the user can choose to retry, cancel, or search for other devices. If there is no preferred device configured or skipPreferredSearch is set to true, the search will begin directly at searching for other devices.During the search for other devices, a list of devices detected in range is presented to the user. Any time during the search the user can select a device from the list to connect to, and can optionally save a name for that device and set it as the preferred device for future searches.

Regardless of how the search proceeds, as soon as a device is connected or if an error occurs or the user cancels then the result will be posted to the supplied result receiver.

Note: During the search this function will display UI elements to display the progress of the search to the user and allow them to interact and control the search. If this is not acceptable to the calling application, then do not use this version of requestAccess().

Parameters:

userActivity - The current foreground activity. Used to display search progress and results.

bindToContext - The context to which the plugin will be bound. Used for plugin lifecycle management.

resultReceiver - The receiver to receive the results of the request. Possible returns include:

• RequestAccessResult.SUCCESS
• RequestAccessResult.USER_CANCELLED
• RequestAccessResult.CHANNEL_NOT_AVAILABLE
• RequestAccessResult.BAD_PARAMS
• RequestAccessResult.ADAPTER_NOT_DETECTED
• RequestAccessResult.DEPENDENCY_NOT_INSTALLED
• RequestAccessResult.OTHER_FAILURE

stateReceiver - The receiver to receive the state updates of the accessed device, assuming the request is successful. This receiver will receive notifications of all state changes to the device that occur subsequent to the initial state returned in the result receiver.

Returns:

A release handle for the device. This can be used to guarantee the device is properly shutdown and cleaned up, even before the device is actually received through the result receiver.

requestAccess

public static PccReleaseHandle<AntPlusStrideSdmPcc> requestAccess(Context bindToContext,
                                                  int antDeviceNumber,
                                                  int searchProximityThreshold,
                                                  AntPluginPcc.IPluginAccessResultReceiver<AntPlusStrideSdmPcc> resultReceiver,
                                                  AntPluginPcc.IDeviceStateChangeReceiver stateReceiver)

Sends a request to the plugin to access a device and receive a live PCC instance. If the minimum version of the desired plugin is installed, this will start an asynchronous search for a device to connect to and return the result on the provided result receiver.

The plugin will attempt to connect to a device with the provided deviceNumber and return a result when the device is connected or the search fails. The search will timeout after 10s, if you wish to keep searching you can call this method again.

Note: If you set deviceNumber to 0 it will connect to the first available/found device.

Parameters:

bindToContext - The context to which the plugin will be bound. Used for plugin lifecycle management.

antDeviceNumber - DeviceNumber to attempt to connect to. A deviceNumber of 0 indicates a desire to connect to first available device.

searchProximityThreshold - This value represents the signal strength 'proximity' requirement on finding matches during searching, if a device does not meet the requirements it will not show up in the search at all. The value is a generic signal strength threshold from 1-10 where 1 is the strongest (ie: closest) and 10 is the lowest(ie: farthest away). 0 = don't use proximity search.

resultReceiver - The receiver to receive the results of the request. Possible returns include:

• RequestAccessResult.SUCCESS
• RequestAccessResult.SEARCH_TIMEOUT
• RequestAccessResult.CHANNEL_NOT_AVAILABLE
• RequestAccessResult.BAD_PARAMS
• RequestAccessResult.ADAPTER_NOT_DETECTED
• RequestAccessResult.DEPENDENCY_NOT_INSTALLED
• RequestAccessResult.OTHER_FAILURE

stateReceiver - The receiver to receive the state updates of the accessed device, assuming the request is successful. This receiver will receive notifications of all state changes to the device that occur subsequent to the initial state returned in the result receiver.

Returns:

A release handle for the device. This can be used to guarantee the device is properly shutdown and cleaned up, even before the device is actually received through the result receiver.

requestAsyncScanController

public static AsyncScanController<AntPlusStrideSdmPcc> requestAsyncScanController(Context bindToContext,
                                                                  int searchProximityThreshold,
                                                                  AsyncScanController.IAsyncScanResultReceiver scanResultReceiver)

Sends a request to the plugin to start an asynchronous search for available devices. Using the returned AsyncScanController you can view available devices (including devices already connected to the plugin by other applications), receive user saved info and preferences for available devices, and eventually request access to a device you desire to connect to.

Note: The scan is started automatically, and must be stopped by your application to avoid resource leaks. (See the controller documentation for more details: AsyncScanController.

Parameters:

bindToContext - The context to which the plugin will be bound. Used for plugin lifecycle management.

searchProximityThreshold - This value represents the signal strength 'proximity' requirement on finding matches during searching, if a device does not meet the requirements it will not show up in the search at all. The value is a generic signal strength rating from 1-10 where 1 is the strongest (ie: closest) and 10 is the lowest(ie: farthest away). 0 = don't use proximity search.

scanResultReceiver - The receiver to receive the info for available devices and status of the scan.

Returns:

The controller object for the asynchronous controller. Note: The scan is started automatically, and must be stopped by your application to avoid resource leaks. (See the controller documentation for more details: AsyncScanController.

subscribeInstantaneousSpeedEvent

public void subscribeInstantaneousSpeedEvent(AntPlusStrideSdmPcc.IInstantaneousSpeedReceiver InstantaneousSpeedReceiver)

Subscribe to receive InstantaneousSpeed events, which contain: The instantaneous speed data. This data is optional and may not be sent by all sensors. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

InstantaneousSpeedReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeInstantaneousCadenceEvent

public void subscribeInstantaneousCadenceEvent(AntPlusStrideSdmPcc.IInstantaneousCadenceReceiver InstantaneousCadenceReceiver)

Subscribe to receive InstantaneousCadence events, which contain: The instantaneous cadence data. This data is optional and may not be sent by all sensors. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

InstantaneousCadenceReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeDistanceEvent

public void subscribeDistanceEvent(AntPlusStrideSdmPcc.IDistanceReceiver DistanceReceiver)

Subscribe to receive Distance events, which contain: The total distance travelled since the plugin connected to this device. This data is optional and may not be sent by all sensors. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

DistanceReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeStrideCountEvent

public void subscribeStrideCountEvent(AntPlusStrideSdmPcc.IStrideCountReceiver StrideCountReceiver)

Subscribe to receive StrideCount events, which contain: The cumulative stride count since the plugin connected to this device. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

StrideCountReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeComputationTimestampEvent

public void subscribeComputationTimestampEvent(AntPlusStrideSdmPcc.IComputationTimestampReceiver ComputationTimestampReceiver)

Subscribe to receive ComputationTimestamp events, which contain: Data about the timing of the last speed and distance computation. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

ComputationTimestampReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeDataLatencyEvent

public void subscribeDataLatencyEvent(AntPlusStrideSdmPcc.IDataLatencyReceiver DataLatencyReceiver)

Subscribe to receive DataLatency events, which contain: The sensor reported latency between calculation and sensor transmission. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

DataLatencyReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeCalorieDataEvent

public void subscribeCalorieDataEvent(AntPlusStrideSdmPcc.ICalorieDataReceiver CalorieDataReceiver)

Subscribe to receive CalorieData events, which contain: The total calories consumed over the session. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

CalorieDataReceiver - receiver to receive events (or null to unsubscribe from this event).

subscribeSensorStatusEvent

public void subscribeSensorStatusEvent(AntPlusStrideSdmPcc.ISensorStatusReceiver SensorStatusReceiver)

Subscribe to receive SensorStatus events, which contain: Various status information about the sensor. This function can also be used to unsubscribe from an event, by passing null as the receiver.

Parameters:

SensorStatusReceiver - receiver to receive events (or null to unsubscribe from this event).