Lumia SensorCore SDK

Lumia SensorCore SDK is a collection of APIs utilising data from different sensors (for example, accelerometer) and also location information. This information can be used to track user’s physical activities and motion. The sensors are able to run constantly in the background, collecting and preserving data for up to past ten days. Even though they are constantly active, the sensors run in a low power mode, consuming only a negligible amount of battery. Since the sensors may provide access to user’s private data, data privacy is a critical part of the design. User has always the option of disabling SensorCore SDK sensors and clearing any collected data.

The Lumia SensorCore SDK is available for Lumia 630, Lumia 635, Lumia 730, Lumia 735, Lumia 830, Lumia 930, Lumia 1520 and Lumia Icon, running on Windows Phone 8.1 with Lumia Cyan or Denim firmware.

Lumia SensorCore SDK 1.0

The following features are included in Lumia SensorCore SDK 1.0:

  • Step counter counts the user's walking and running steps.
  • Activity monitor determines the current type of motion of the phone and the user.
  • Place monitor identifies user's home, work, frequent and known visited places.
  • Track point monitor records location points along the route the user has taken.
  • Triggers for background tasks, for example, to recognize changes in the step count, or if the user has chaged essential settings (location or motion data) in the phone.

Key characteristics of Lumia SensorCore SDK:

  • Power and memory efficient.
  • Secure data storage on the phone.
  • Access to Motion history for up to ten days.

This documentation contains overview of each SensorCore SDK API, a Quick Start to get you started, and some more advanced samples. Essential practices and Best practices sections offer guides on how to implement SensorCore SDK support in your application safely and how to handle required hardware and privacy requirements. There is also a link to the full Lumia SensorCore API reference.

The SDK is delivered via NuGet service, and instructions how to add the libraries to your project in Visual Studio can be found as part of the Quick Start.

What's new in SDK 1.0 and in Lumia Denim firmware?

The following table describes the new features and functionality (compared to SDK beta and Lumia Cyan firmware). Some new functionality is available via SDK 1.0 release (for both Lumia Cyan and Denim device firmware), some via Lumia Denim firmware update, and some features require both the SDK 1.0 and the Lumia Denim firmware update to be available.

Feature

SDK 1.0

With both Lumia Cyan and Denim SW

Lumia Denim SW

With both beta and 1.0 SDK

SDK 1.0 and Lumia Denim SW

Improved step counting algorithms and activity detection

 

X

 

Trigger for StepCountUpdate

Called when user has moved at least 5 steps and at least 10 minutes have elapsed since last step counter trigger. Used for example, in order for the app to update the step count in the live tile.

   

X

Trigger for MotionDataCleared

Called when motion data is cleared from settings.

   

X

Trigger for SenseApiStateChanged

Called when motion data or location has been switched on or off.

   

X

Ability to ask if certain API features or capabilities are supported

You can query the availability of StepCounterTrigger and MotionDataSettingsTriggers capabilities. For more details see the “Verifying hardware support” topic.

X

   

Known places linked to Track Point

If track point is a known place, the Track Point API will include the known place ID provided by the Place Monitor API for that track point.

   

X

New place category: Frequent

Places where the user often spends time (visits more than 3 times or spends over 36 hours) are categorized as frequent.

   

X

Helper methods to ask step counts for specific time range

X

   

Number of collected track points is higher and minimum distance shorter

Time interval is 30 seconds and minimum distance 50 meters. Mainly visible in data when GPS is active.

 

X

 

Subtopics in this section:


Last updated 10 October 2014

Back to top

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×