The tracking APIs of the Samsung Health Sensor SDK enable partner application to register an event for tracking health sensor data and to retrieve that data while tracking on a Galaxy Watch.
Capabilities
The Samsung Health Sensor SDK provides the available tracker types on the watch.
Measuring Watch’s Health Sensor Data
A partner application using the SDK can measure health-sensor data of a Galaxy Watch. The following tracker types are supported:
[Continuous Tracker Types]
The following tracker types can be measured continuously until unsetting the tracker type’s event listener. Continuous tracker types operate with low battery consumption of the Galaxy Watch.
Accelerometer
Heart rate including IBI (inter-beat interval)
Photoplethysmogram (PPG) green, Infrared (IR), and red
Skin temperature
[On-demand Tracker Types]
The following tracker types are on-demand tracker types. Use only one on-demand tracker type at a time and only when needed.
Bioelectrical impedance analysis (BIA)
Electrocardiogram (ECG)
PPG green, Infrared (IR), and red
Skin temperature
SpO2 (blood oxygen)
[Other]
Measuring the user’s sweat loss amount after a running is available with the following tracker type.
Sweat loss
Developer Mode
A developer mode is supported for testing and debugging. See the Developer Mode for more information.
Limitations
The emulator is not supported.
Data measured by the Samsung Health Sensor SDK is for fitness and wellness information only, not for the diagnosis or treatment of any medical condition.
Changes
Rebranding the SDK name to "Samsung Health Sensor SDK".
[New]
Continuous and on-demand enum constant names of HealthTrackerType have been defined.
ACCELEROMETER_CONTINUOUS
BIA_ON_DEMAND
ECG_ON_DEMAND
HEART_RATE_CONTINUOUS
PPG_CONTINUOUS
PPG_ON_DEMAND
SKIN_TEMPERATURE_ON_DEMAND
SPO2_ON_DEMAND
An application can track one or more PpgTypes with PPG_CONTINUOUS or PPG_ON_DEMAND. The following API has been added.
ValueKey.PpgSet has been added. It includes PPG Green, IR, Red data.
The following fields for BIA’s raw data have been added in ValueKey.BiaSet.
BODY_IMPEDANCE_DEGREE
BODY_IMPEDANCE_MAGNITUDE
[Deprecated]
The following enum constant names of HealthTrackerType have been deprecated.
ACCELEROMETER : Use ACCELEROMETER_CONTINUOUS.
BIA : Use BIA_ON_DEMAND.
ECG : Use ECG_ON_DEMAND.
HEART_RATE : Use HEART_RATE_CONTINUOUS.
PPG_GREEN : Use PPG_CONTINUOUS.
PPG_IR : Use PPG_ON_DEMAND.
PPG_RED : Use PPG_ON_DEMAND.
SKIN_TEMPERATURE : Use SKIN_TEMPERATURE_ON_DEMAND.
SPO2 : Use SPO2_ON_DEMAND.
The following PPG data set of ValueKey have been deprecated. Use ValueKey.PpgSet instead of them.
ValueKey.PpgGreenSet
ValueKey.PpgIrSet
ValueKey.PpgRedSet
[Removed]
The following fields of ValueKey.EcgSet have been removed. Use alternative fields.
ValueKey.EcgSet.ECG : Use ValueKey.EcgSet.ECG_MV.
ValueKey.EcgSet.MAX_THRESHOLD : Use ValueKey.EcgSet.MAX_THRESHOLD_MV.
ValueKey.EcgSet.MIN_THRESHOLD : Use ValueKey.EcgSet.MIN_THRESHOLD_MV.
The following fields of ValueKey.HeartRateSet have been removed. Use alternative fields.
ValueKey.HeartRateSet.HEART_RATE_IBI : Use ValueKey.HeartRateSet.IBI_LIST.
ValueKey.HeartRateSet.STATUS : Use ValueKey.HeartRateSet.HEART_RATE_STATUS and ValueKey.HeartRateSet.IBI_STATUS_LIST.
[New]
The skin temperature tracker type and data point set have been added. Skin temperature can be measured on-demand or as a batching event. For more information, see the API Reference.
HealthTrackerType.SKIN_TEMPERATURE
HealthTrackerType.SKIN_TEMPERATURE_CONTINUOUS
ValueKey.SkinTemperatureSet
The following interfaces for values in millivolts have been added to the ECG data point set:
ECG_MV
MAX_THRESHOLD_MV
MIN_THRESHOLD_MV
The following interfaces for heart rate status and IBI-related information have been added to the heart rate data point set:
ValueKey.HeartRateSet.HEART_RATE_STATUS
ValueKey.HeartRateSet.IBI_LIST
ValueKey.HeartRateSet.IBI_STATUS_LIST
The status interface has been added to the following data point sets:
ValueKey.AccelerometerSet.STATUS
ValueKey.PpgGreenSet.STATUS
ValueKey.PpgIrSet.STATUS
ValueKey.PpgRedSet.STATUS
[Change]
The error description of the first bit in the 1 ~ 127 value for ValueKey.SweatLossSet.STATUS has been updated.
[Deprecated]
The following interfaces in the ECG data point set have been deprecated.
ValueKey.EcgSet.ECG, replaced by ValueKey.EcgSet.ECG_MV.
ValueKey.EcgSet.MAX_THRESHOLD, replaced by ValueKey.EcgSet.MAX_THRESHOLD_MV.
ValueKey.EcgSet.MIN_THRESHOLD, replaced by ValueKey.EcgSet.MIN_THRESHOLD_MV.
The following interfaces in the heart rate data point set have been deprecated.
ValueKey.HeartRateSet.HEART_RATE_IBI, replaced by ValueKey.HeartRateSet.IBI_LIST.
ValueKey.HeartRateSet.STATUS, replaced by ValueKey.HeartRateSet.HEART_RATE_STATUS and ValueKey.HeartRateSet.IBI_STATUS_LIST.
[Removed]
ValueKey.HeartRateSet.FLAG has been removed.
Minor stability improvements have been made to the SDK library.
[New]
The SpO2 tracker type and data point set have been added, which are supported by Health Platform v1.3.0:
HealthTrackerType.SPO2
ValueKey.Spo2Set
ValueKey.HeartRateSet.STATUS has been added, which replaces ValueKey.HeartRateSet.FLAG.
[Changes]
The TrackingSampleApp application code has been updated.
[Deprecated]
ValueKey.HeartRateSet.FLAG has been deprecated.
The values for SweatLossSet.STATUS have changed. For more information, see the API Reference.
Minor issues related to the sweat loss feature have been fixed.
[New]
The sweat loss feature has been added, which measures how much sweat is lost during a run. The following interfacess have been added:
DataType enum
ExerciseState enum
ExerciseType enum
HealthTrackerType.SWEAT_LOSS enum vale
HealthTrackingService.getHealthTracker(HealthTrackerType healthTrackerType, TrackerUserProfile userProfile, ExerciseType type) API
ValueKey.SweatLossSet class
[Known Issue]
The following issues are to be resolved in February 2022 watch software update:
A timestamp period variation issue in received sensor data for accelerometer, heart rate and PPG grenn.
An issue where HealthTracker.TrackerEventListener.onFlushCompleted() is not received.
[Change]
The SDK policy has been applied. Tracking watch sensor data with the SDK is available only for the tracking types within the registered scope. If SDK_POLICY_ERROR occurs, talk to your Samsung contact point.
The following interfaces have been added to the tracking data point sets:
The BIA status has been defined: ValueKey.BiaSet.STATUS
Check this value after a BIA measurement. If the status indicates an error, guide the user with a message and appropriate UI.
The ECG’s lead on/off values have been defined: ValueKey.EcgSet.LEAD_OFF
The flag for heart rate measurement has been added: ValueKey.HeartRateSet.FLAG
In HealthTracker.TrackerError:
The following unused errors have been removed.
LOW_SIGNAL
MOVEMENT_DETECTED
NOT_WEARING
TIME_OUT
The following error has been added:
SDK_POLICY_ERROR
Measurement guides for each sensor data have been added to the Programing Guide.
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.