The Service package is deprecated. Please do not use this feature any more.
The tracker and tracker tile are the basic features of Samsung Health. Your app can show the measured data on the Samsung Health's tracker or launch it through the SDK. Understanding the tracker and tracker tile's operation on Samsung Health is required first.
The tracker is the basic building block of Samsung Health. The user's health data can be monitored, measured or updated through trackers such as counting steps, measuring heart rates, tracking exercises, collecting health data on background, or allowing the user to enter health data manually.
Samsung Health has various trackers for its supported data types already as the following figure. Check the supported trackers on the tracker tab of Samsung Health > Manage items. The user can subscribe to the tracker by switching it on the tracker tab.
The tracker is expressed to the user as the tracker tile. It is shown on the Samsung Health's main screen and represents the latest data collected by its tracker. It acts as a gateway when the user taps it. It's jumped to:
The tracker's detailed page in case that the Samsung Health tracker's tile.
The app's specific page if it's the app tracker's tile.
The Android SDK’s Health Data package enables an application to synchronize its health data with Samsung Health. If the application writes health data with the SDK and the Samsung Health has the new data’s related tracker, the new data is shown on the Samsung Health’s tracker tile.
For example, there is an application writes the measureblood pressure data to Samsung Health with the Health Data API. If writing data to Samsung Health succeeds, the new written data is shown on the *Samsung Health‘*s blood pressure tracker tiles like the following figure.
It means that the app doesn’t need to define its tracker for the blood pressure on Samsung Health separately. Otherwise, the both the app and Samsung Health's tracker tiles will show the same data, which would definitely not lead to a good user experience.
If Samsung Health has a proper tracker for your app's feature, the TrackerManager helps your app to launch the Samsung Health's available tracker.
The following figure shows the flow of launching Samsung Health's tracker.
- The app gets the interesting tracker's info and checks its availability.
- If it is, the app launches the tracker. Samsung Health's tracker is foregrounded.
- The user selects the back key and your app is foregrounded.
See Launching Samsung Health's Tracker for an example.
There are limitations on launching Samsung Health's tracker.
It works on Samsung Health 4.8 or above.
Some trackers of Samsung Health may not be available due to the local law or device specifications.
Therefore, check the wanted tracker's availability before launching it.