# Modules.CoreMotion.Pedometer

Allows Titanium client applications to access CoreMotion's Pedometer APIs. Note: This API is only available in iOS 8 and later.

Availability
5.2.0

# Methods

# isCadenceAvailable

Availability
5.2.0
isCadenceAvailable() Boolean

Returns a Boolean value indicating whether cadence information is available on the current device. Note: This API is only available on iOS 9 and later.

Returns

Type
Boolean

# isDistanceAvailable

Availability
5.2.0
isDistanceAvailable() Boolean

Returns a Boolean value indicating whether distance support is available on the current device.

Returns

Type
Boolean

# isFloorCountingAvailable

Availability
5.2.0
isFloorCountingAvailable() Boolean

Returns a Boolean value indicating whether floor counting is available on the current device.

Returns

Type
Boolean

# isPaceAvailable

Availability
5.2.0
isPaceAvailable() Boolean

Returns a Boolean value indicating whether pace information is available on the current device. Note: This API is only available on iOS 9 and later.

Returns

Type
Boolean

# isStepCountingAvailable

Availability
5.2.0
isStepCountingAvailable() Boolean

Returns a Boolean indicating whether step-counting support is available on the current device.

Returns

Type
Boolean

# isSupported DEPRECATED

Availability
5.2.0
isSupported() Boolean

DEPRECATED SINCE 8.3.0

This API is supported on IOS 8+ and this module is now targeting iOS 8 as minimum, so this method will always return true.

Returns a Boolean value indicating whether the pedometer is supported on the current device. Returns true for iOS 8+.

Returns

Type
Boolean

# queryPedometerData

Availability
5.2.0
queryPedometerData(args, callback) void

Retrieves the data between the specified start and end dates.

Use this method to retrieve historical pedestrian data between the specified dates. This method runs asynchronously and delivers the data to the block you provide. Only the past seven days worth of data is stored and available for you to retrieve. Specifying a start date that is more than seven days in the past returns only the available data.

It is safe to call this method at the same time that you are generating continuous updates using the startPedometerUpdates method.

Parameters

Name Type Description
args CoreMotionStartPedometerArgs

An object of arguments

callback Callback<CoreMotionPedometerDataWithSuccess>

The callback to execute with the results.

Returns

Type
void

# startPedometerUpdates

Availability
5.2.0
startPedometerUpdates(args, callback) void

Starts the delivery of recent pedestrian-related data to your app.

Upon calling this method, the pedometer object starts calling your handler block regularly with data. The data passed to your handler block represents the cumulative data starting at the specified start date and ending at the current time. (You can get the start and end dates from the CMPedometerData object passed to your handler.) This method initiates the event delivery process asynchronously and executes your block on a serial dispatch queue, which ensures that only one copy of the block runs at any given time.

When the app is suspended, the delivery of updates stops temporarily. Upon returning to foreground or background execution, the pedometer object begins updates again.

To stop the delivery of events, call the stopPedometerUpdates method.

Parameters

Name Type Description
args CoreMotionStartPedometerArgs

An object of arguments

callback Callback<CoreMotionPedometerDataWithSuccess>

The callback to execute with the results.

Returns

Type
void

# stopPedometerUpdates

Availability
5.2.0
stopPedometerUpdates() void

Stops the delivery of recent pedestrian data updates to your app.

Use this method to stop the delivery of continuous updates that were initiated by a call to the startPedometerUpdates method.

Returns

Type
void