Filter

Samsung Health Sensor SDK 63
Sorry, no results
found for "Samsung Health Sensor SDK" on the website

Develop Health

doc

Release Note

release note release date august 20, 2025 release version v1 4 1 target device the samsung health sensor sdk is supported on the following watch devices that run on wear os powered by samsung galaxy watch4 series and later models sdk content content description documents api reference programming guide library the tracking library of the samsung health sensor sdk import it into your app project samsung-health-sensor-api aar sample apps measure blood oxygen measure blood oxygen and heart rate heart rate tracker transfer measured heart rate to a connected phone measure skin temperature ecg monitor sweat loss monitor features the tracking apis of the samsung health sensor sdk enable partner apps to register events 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 galaxy watch’s health sensor data a partner app 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 the tracker type’s event listener is unset continuous tracker types operate with low battery consumption on the galaxy watch accelerometer electrodermal activity eda 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 multi-frequency bioelectrical impedance mf-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 restrictions 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 1 4 1 - august 20, 2025 this patch version improves operational stability 1 4 0 - july 31, 2025 [new] the following enum values have been added to the healthtrackertype for measuring electrodermal activity eda and multi-frequency bioelectrical impedance mf-bia eda_continuous mf_bia_on_demand the following data sets have been added to the valuekey to receive the measured eda and mf-bia data edaset mfbiaset [change] required permissions to use each healthtrackertype have been changed for targeting android 16 api level or higher healthtrackertype for android 16 or higher bia_on_demand com samsung android hardware sensormanager permission read_additional_health_data ecg_on_demand eda_continuous mf_bia_on_demand ppg_continuous ppg_on_demand heart_rate_continuous healthpermissions read_heart_rate spo2_on_demand healthpermissions read_oxygen_saturation skin_temperature_continuous healthpermissions read_skin_temperature skin_temperature_on_demand sweat_loss manifest permission activity_recognition and com samsung android hardware sensormanager permission read_additional_health_data 1 3 0 - september 22, 2024 rebranding the sdk name to "samsung health sensor sdk" 1 3 0 - august 22, 2024 [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 healthtrackingservice gethealthtracker healthtrackertype, set<ppgtype> the following ppg types have been added ppgtype green ppgtype ir ppgtype red 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 1 2 0 - august 30, 2023 [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 1 1 0 - march 31, 2022 minor stability improvements have been made to the sdk library 1 1 0 alpha - march 17, 2022 [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 1 0 0 - feb 25, 2022 the values for sweatlossset status have changed for more information, see the api reference 1 0 0 beta1 - dec 31, 2021 minor issues related to the sweat loss feature have been fixed 1 0 0 alpha3 - dec 17, 2021 [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 1 0 0 alpha2 - july 28, 2021 [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

https://developer.samsung.com/health/sensor/release-note.html

Develop Health

doc

ECG Monitor

ecg monitor in this blog post we are going to show how to track on-demand data, using ecg as an example make sure you are acquainted with the general overview on using the samsung health sensor sdk, by reading samsung health sensor sdk introduction we created a sample application called ecg monitor which allows you to track ecg using functionality covered in the article you can download it and try it yourself ecg monitor v1 3 0 142 7 kb nov 21, 2025 how to prepare for a measurement on successful connection to the health tracking service, but before starting a measurement, we have to check if the device is able to track ecg data we can do this by calling checkcapabilities list<healthtrackertype> availabletrackers = healthtrackingservice gettrackingcapability getsupporthealthtrackertypes ; make sure the returned list contains healthtrackertype ecg_on_demand if !availabletrackers contains healthtrackertype ecg_on_demand { toast maketext getapplicationcontext , getstring r string noecgsupport , toast length_long show ; log e app_tag, "device does not support ecg tracking" ; finish ; } after that, we can set up the ecg tracker object ecgtracker = healthtrackingservice gethealthtracker healthtrackertype ecg_on_demand ; the next step is to prepare an event listener – an object to process incoming data we create one at the start of the application and implement its functionality in this blog, we focus on the ondatareceived event it contains data gathered by the samsung health sensor sdk as a list of data points a full description of all elements of the list can be found in the api reference document for valuekey ecgset, so here we only focus on the necessary parts, which are lead_off and, of course, the ecg values checking if watch electrodes are in contact in order to track ecg values correctly, the watch electrodes must be in contact – meaning the watch must be worn tightly on the wrist and the user has to hold their index finger on the “home” key to track electrode contact, the lead_off flag is used if its value is 0 – it means that electrodes are in contact otherwise – if it's 5 – it means the electrodes are not in contact the ecg readings are valid only if the flag is set, otherwise they should be ignored the flag can be read in valuekey ecgset final int isleadoff = list get 0 getvalue valuekey ecgset lead_off ; in the sample application we set a variable, which holds the current status of electrodes contact final int no_contact = 5; if isleadoff == no_contact { leadoff set true ; return; } else leadoff set false ; how to read ecg values when the ondatareceived event is called, it provides a list of data points the list has either 5 or 10 elements and each of them contains an ecg value since ecg has a 500 hz sample rate, we are going to use last value from received list to show the most recent value on the ui the following example shows how to receive last value obtained in a sample private final healthtracker trackereventlistener ecglistener = new healthtracker trackereventlistener { @override public void ondatareceived @nonnull list<datapoint> list { if list size == 0 return; curecg set list get list size - 1 getvalue valuekey ecgset ecg_mv ; how to track incoming ecg data with the prerequisites in the previous steps done, we are now ready to measure ecg first, we set up a listener ecghandler post -> ecgtracker seteventlistener ecglistener ; we can now start receiving ecg data since the sampling frequency is 500 hz, we cannot update the ui with each sample instead, we create a timer which updates ecg values every second for 30 seconds – the time required to make a successful measurement in the timer, we analyze ecg data and act accordingly first, we check if both electrodes are in contact if they are not, we show a warning to the user if leadoff get { runonuithread -> binding txtoutput settext r string outputwarning ; } if the data received is valid, we read the current average ecg value after that, we update the ui with the result for convenience, we also provide information on how much time is left until the end of the measurement else { final string measurevalue = getstring r string measurementupdate, timeleft / 1000, string format locale english, "% 2f", curecg get ; runonuithread -> binding txtoutput settext measurevalue ; } after 30 seconds, the timer reaches its end, and we stop the measurement by unsetting the listener ecgtracker unseteventlistener ; finally, we update the ui for the last time – with either the last measured ecg value or an error if electrodes were not in contact these steps show how we can use on-demand sensors to perform an ecg measurement we encourage you to try doing it yourself and explore the other available features provided by the samsung health sensor sdk

https://developer.samsung.com/health/sensor/sample/ecg-monitor.html

Learn Code Lab

codelab

Measure electrodermal activity on Galaxy Watch

measure electrodermal activity on galaxy watch objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung health sensor sdk to obtain electrodermal activity eda measurement results overview samsung health sensor sdk provides tools for accessing and tracking health information stored in the health data repository its tracking service delivers both raw and processed sensor data, including accelerometer readings and body composition metrics, collected by the samsung bioactive sensor electrocardiogram ecg , bioelectrical impedance analysis bia , photoplethysmogram ppg , heart rate, skin temperature, blood oxygen spo2 , and sweat loss data can be measured furthermore, the galaxy watch8 introduces electrodermal activity tracking electrodermal activity eda is a non-invasive physiological index that measures changes in skin conductance driven by sweat gland activity, reflecting the autonomic nervous system's response to both thermoregulation and psychological arousal see samsung health sensor sdk documentation for detailed information set up your environment you will need the following galaxy watch8 or newer android studio latest version recommended java se development kit jdk 17 or later android api level 36 or later sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! electrodermal activity sample code 159 8 kb set up your galaxy watch click the following links to set up your device connect to your galaxy watch enable the developer mode of health sensor service start your project in android studio, click open to open existing project locate the downloaded android project edatracking from the directory and click select folder request for health permission the app utilizing samsung health sensor sdk requires the appropriate permissions and the user’s consent to access the vital signs information different permissions are required depending on the healthtrackertype you want to measure while this code lab focuses solely on healthtrackertype eda_continuous tracker type, the read_additional_health_data permission is also being used noteif the app’s target sdk version is android 15 api level 35 or lower, body_sensors permission is used go to app > manifests > androidmanifest xml and ensure the required permissions are added <uses-permission android name="android permission body_sensors" /> <uses-permission android name="com samsung android hardware sensormanager permission read_additional_health_data" /> next, the app needs to check if the user has already granted the permissions private fun ispermissiongranted = activitycompat checkselfpermission applicationcontext, permission!! == packagemanager permission_granted if no permission is granted, request the necessary permissions go to app > kotlin+java > com samsung health sensorsdksample edatracking > presentation > mainactivity kt and navigate to the preparepermission function complete the function to provide appropriate permissions based on the android version /**************************************************************************** * [practice 1] request health permissions * -------------------------------------------------------------------------- * * use the provided variable 'permission' * replace 'null' with proper value based on android version * if android sdk version is higher or equal android sdk 36 baklava use "com samsung android hardware sensormanager permission read_additional_health_data" permission * otherwise use "android permission body_sensors" ****************************************************************************/ fun preparepermission string? { val permission = if build version sdk_int >= build version_codes baklava { // todo replace 'null' with proper string value here null } else { // todo replace 'null' with proper string value here null } return permission } the returned permission is used in the requestpermissions function, which displays a pop-up asking for the user’s consent initialize eda tracker before starting the measurement, initialize the eda tracker by creating a healthtracker object navigate to app > kotlin+java > com samsung health sensorsdksample edatracking > tracking > edatrackingmanager kt and locate the obtainedatracker function using the provided healthtrackingservice object, create an instance of the healthtracker class with the eda_continuous type and assign it to the edatracker variable retrieve the healthtracker object using gethealthtracker use healthtrackertype eda_continuous as the parameter healthtrackerservice healthtrackerservice initiates a connection to samsung's health tracking service and provides an healthtracker instance to track a healthtrackertype healthtracker gethealthtracker healthtrackertype healthtrackertype provide a healthtracker instance for the given healthtrackertype /**************************************************************************** * [practice 2] setup eda tracker * -------------------------------------------------------------------------- * * use the provided variable 'edatracker' which is currently null * initialize eda tracker with proper sensor sdk functionality * call gethealthtracker function on 'healthtrackingservice' object * as an argument use healthtrackertype eda_continuous * assign the obtained tracker to 'edatracker' variable ****************************************************************************/ fun obtainedatracker healthtracker? { var edatracker healthtracker? = null // todo assign the tracker to the 'edatracker' variable here return edatracker } start and stop the tracker for the client app to begin retrieving data through the sdk, set a listener method on the healthtracker if successful, the event listener collects the sensor data until the measurement is stopped in the app noteonly one healthtracker trackereventlistener should be set per healthtrackertype healthtracker healthtracker enables an application to set an event listener and receive the galaxy watch's sensor data for a specific healthtrackertype void seteventlistener healthtracker trackereventlistener listener set an event listener for this healthtracker instance fun starttracking { edatracker = obtainedatracker if edatracker != null { edatracker!! seteventlistener trackerlistener _progressstate value = progressstate measuring true } else { scope launch { _messagestate emit messagestate trackernotinitialized } } } to stop the measurement, unset the trackereventlistener from the healthtracker object healthtracker healthtracker enables an application to set an event listener and receive the galaxy watch's sensor data for a specific healthtrackertype void unseteventlistener stop the registered event listener for this healthtracker instance fun stoptracking { if edatracker != null { edatracker!! unseteventlistener _progressstate value = progressstate measuring false } } obtain eda data the eda values are provided in the ondatareceived callback of trackereventlistener at a frequency of 1hz the platform's response is asynchronous and includes a data point object containing all the required information in the edatrackingmanager kt file, navigate to extractedavalues function to obtain eda data, read the skin conductance value and measurement status this can be extracted by specifying the appropriate keys in the getvalue function from the datapoint additionally, obtain the timestamp of the incoming data by calling the gettimestamp function from the datapoint retrieve the skin conductance value using the getvalue function with the key valuekey edaset skin_conductance retrieve the measurement status using the getvalue function with the key valuekey edaset status obtain the timestamp of the incoming data using the gettimestamp function datapoint datapoint is a map of valuekey and value with a timestamp long gettimestamp get a timestamp of the datapoint <t> t getvalue valuekey<t> type get a data value for the given key /**************************************************************************** * [practice 3] read values from datapoint object * - get skin conductance value * - get status value * - get timestamp * -------------------------------------------------------------------------- * * use the provided variable 'skinconductance' which is currently null * obtain skin conductance value using datapoint getvalue valuekey edaset skin_conductance * assign the obtained value into 'skinconductance' variable * * use the provided variable 'edastatus' which is currently null * obtain status using datapoint getvalue valuekey edaset status * assign the obtained value into 'edastatus' variable * * use the provided variable 'edatimestamp' which is currently null * obtain the 'timestamp' property from 'datapoint' object * assign the obtained value into 'edatimestamp' variable ****************************************************************************/ fun extractedavalues datapoint datapoint edavalue { var skinconductance float? = null var edastatus int? = null var edatimestamp long? = null // todo assign the skin_conductance value to the 'skinconductance' variable here // todo assign the status value to the 'edastatus' variable here // todo assign the timestamp property to the 'edatimestamp' variable here return edavalue skinconductance, edastatus fromint edastatus , edatimestamp } run unit tests for your convenience, you can find an additional unit tests package this lets you verify your code changes even without using a physical watch see the instructions below on how to run the unit tests right-click on com samsung health sensorsdksample edatracking test and select run ‘tests in ‘com samsung health sensorsdksample edatracking’’ if you completed all the tasks correctly, you can see that all the unit tests passed successfully run the app after building the apk, you can run the application on a connected device to measure your electrodermal activity values once the application starts, grant the app permission to access your vital signs information tap the start button to begin the electrodermal activity measurement the app shows your skin conductance, measurement status, and the time of the recorded data tap the stop button to stop the measurement you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a health app that measures electrodermal activity eda on your own! if you are having trouble, you may download this file electrodermal activity complete code 159 3 kb to learn more, explore samsung health sensor sdk

https://developer.samsung.com/codelab/health/electrodermal-activity.html

Learn Code Lab

codelab

Measure blood oxygen and heart rate on Galaxy Watch

measure blood oxygen and heart rate on galaxy watch objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung health sensor sdk to trigger and obtain results of simultaneous blood oxygen spo2 and heart rate measurements overview samsung health sensor sdk provides means of accessing and tracking health information contained in the health data storage its tracking service gives raw and processed sensor data such as accelerometer and body composition data sent by the samsung bioactive sensor the latest bioactive sensor of galaxy watch runs powerful health sensors such as photoplethysmogram ppg , electrocardiogram ecg , bioelectrical impedance analysis bia , sweat loss, and spo2 see samsung health sensor sdk descriptions for detailed information set up your environment you will need the following galaxy watch4 or newer android studio latest version recommended java se development kit jdk 11 or later sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! measuring blood oxygen and heart rate sample code 190 1 kb set up your galaxy watch click the following links to set up your device connect to your galaxy watch enable the developer mode of health sensor service start your project in android studio, click open to open existing project locate the downloaded android project from the directory and click select folder establish service connection and check capabilities for the device to track data with the samsung health sensor sdk, it must connect to the service by healthtrackingservice api after establishing a connection, verify if the required tracker type is available to check this, get the list of available tracker types and verify that the tracker is on the list in this code lab, you're going to utilize blood oxygen and heart rate trackers the healthtrackingservice api usage is in the table below healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype public void connectservice establish connection with samsung's health tracking service public void disconnectservice release connection for samsung's health tracking service public healthtrackercapability gettrackingcapability provide a healthtrackercapability instance to get a supported health tracker type list initialize multiple trackers before the measurement starts, initialize the spo2 tracker by obtaining the proper health tracker object in the trackingmanager kt file, navigate to the initspo2 method and create a blood oxygen healthtracker instance retrieve the healthtracker object using the healthtrackingservice gethealthtracker api use the healthtrackertype spo2_on_demand type as parameter healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype public healthtracker gethealthtracker healthtrackertype healthtrackertype provide a healthtracker instance for the given healthtrackertype /******************************************************************************************* * [practice 1] create a spo2 healthtracker object * - retrieve the healthtracker object * - use the provided variable 'spo2tracker' ------------------------------------------------------------------------------------------- * * hint replace todo 1 with the code as follows * - retrieve the healthtracker object using healthtrackingservice gethealthtracker * - use the healthtrackertype spo2_on_demand type as a parameter * - assign it to the 'spo2tracker' variable ******************************************************************************************/ fun initspo2 healthtracker? { var spo2tracker healthtracker? = null //todo 1 return spo2tracker } next, in the initheartrate function, create a heart rate healthtracker instance retrieve the healthtracker object using the healthtrackingservice gethealthtracker api use the healthtrackertype heart_rate_continuous type as a parameter /******************************************************************************************* * [practice 2] create a heart rate healthtracker object * - retrieve the healthtracker object * - use the provided variable 'heartratetracker' ------------------------------------------------------------------------------------------- * * hint replace todo 2 with the code as follows * - retrieve the healthtracker object using healthtrackingservice gethealthtracker * - use the healthtrackertype heart_rate_continuous type as a parameter * - assign it to the 'heartratetracker' variable ******************************************************************************************/ fun initheartrate healthtracker? { var heartratetracker healthtracker? = null //todo 2 return heartratetracker } start and stop trackers for the client app to start obtaining the data through the sdk, set a listener method on healthtracker this method is called every time there is new data after the measurement completes, the listener has to be disconnected to start measurement in the trackingmanager kt file, navigate to the starttracker function and set the trackereventlistener as the listener of the healthtracker object set the event listener on the healthtracker object using healthtracker seteventlistener use the healthtracker trackereventlistener object instance as a parameter healthtrackerhealthtracker enables an application to set an event listener and get tracking data for a specific healthtrackertype public void seteventlistener healthtracker trackereventlistener listener set an event listener to this healthtracker instance /******************************************************************************************* * [practice 3] start tracking by setting an event listener on the healthtracker object ------------------------------------------------------------------------------------------- * * hint replace todo 3 with the code as follows * - use the provided variables 'healthtracker' and 'trackereventlistener' * - set the event listener on the healthtracker object using healthtracker seteventlistener * - use the 'trackereventlistener' object as a parameter ******************************************************************************************/ fun starttracker healthtracker healthtracker, trackereventlistener trackereventlistener { log i logtags app_tag, "starttracker called" log d logtags app_tag, "healthtracker $healthtracker" log d logtags app_tag, "trackereventlistener $trackereventlistener" //todo 3 } to stop measurement, unset the trackereventlistener from the healthtracker object in the stoptracker function unset the event listener on the healthtracker object using the healthtracking unseteventlistener function healthtrackerhealthtracker enables an application to set an event listener and receive the galaxy watch's sensor data for a specific healthtrackertype public void unseteventlistener stop the registered event listener for this healthtracker instance /******************************************************************************************* * [practice 4] stop tracking by removing the event listener from the healthtracker object ------------------------------------------------------------------------------------------- * * hint replace todo 4 with the code as follows * - use the provided variable 'healthtracker' * - unset the event listener on the healthtracker object using healthtracker unseteventlistener ******************************************************************************************/ fun stoptracker healthtracker healthtracker { log i logtags app_tag, "stoptracker called" log d logtags app_tag, "healthtracker $healthtracker" //todo 4 } process obtained data the response from the platform is asynchronous with the results you want to obtain follow the steps below to get blood oxygen and heart rate data navigate to the readspo2 function and retrieve spo2 data from the datapoint retrieve the blood oxygen status using the datapoint getvalue function with valuekey spo2set status as a parameter retrieve the blood oxygen value using the datapoint getvalue function with valuekey spo2set spo2 as a parameter datapointdatapoint provides a map of valuekey and value with a timestamp public <t>t getvalue valuekey<t> type get a data value for the given key /******************************************************************************************* * [practice 5] read values from the datapoint object * - retrieve the spo2 status * - retrieve the spo2 value ------------------------------------------------------------------------------------------- * * hint replace todo 5 with the code as follows * - set the provided local variable 'status' using datapoint getvalue valuekey spo2set status * - set the provided local variable 'spo2value' using datapoint getvalue valuekey spo2set spo2 ******************************************************************************************/ fun readspo2 datapoint datapoint spo2 { var status int? = null var spo2value int? = null //todo 5 return spo2 status, spo2value } next, navigate to the readheartrate function and read heart rate data from the datapoint retrieve the heart rate status using the datapoint getvalue function with valuekey heartrateset heart_rate_status as a parameter retrieve the heart rate value using the datapoint getvalue function with valuekey heartrateset heart_rate as a parameter retrieve the heart rate ibi value list using the datapoint getvalue function with valuekey heartrateset ibi_list as a parameter retrieve the ibi status list using the datapoint getvalue function with valuekey heartrateset ibi_status_list as a parameter /******************************************************************************************* * [practice 6] read values from the datapoint object * - retrieve the heart rate status * - retrieve the heart rate value * - retrieve the list of ibi for the heart rate data * - retrieve the list of ibi statuses for the heart rate data ------------------------------------------------------------------------------------------- * * hint replace todo 6 with the code as follows * - set the provided local variable 'heartratestatus' using datapoint getvalue valuekey heartrateset heart_rate_status * - set the provided local variable 'heartrate' using datapoint getvalue valuekey heartrateset heart_rate * - set the provided local variable 'ibilist' using datapoint getvalue valuekey heartrateset ibi_list * - set the provided local variable 'ibistatuslist' using datapoint getvalue valuekey heartrateset ibi_status_list ******************************************************************************************/ fun readheartrate datapoint datapoint heartrate { var heartratestatus int? = null var heartrate int? = null var ibilist list<int>? = null var ibistatuslist list<int>? = null //todo 6 log i logtags app_tag, "heart rate $heartrate, hr status $heartratestatus, ibi $ibilist, ibi status $ibistatuslist" return heartrate heartrate, heartratestatus, ibilist, ibistatuslist } run unit tests for your convenience, you can find an additional unit tests package this lets you verify your code changes even without using a physical watch see instructions below on how to run unit tests right-click on com samsung health sensorsdksample multisensormeasurement test and execute run 'tests in 'com samsung health sensorsdksample multisensormeasurement' command if you completed all the tasks correctly, you can see that all the unit tests passed successfully run the app after building the apk, you can run the application on a connected device to see blood oxygen and heart rate values right after the app is started, it requests for user permission allow the app to receive data from heart rate and blood oxygen sensors afterwards, it shows the application's main screen and automatically display the heart rate to get the blood oxygen spo2 value, tap on the start button to stop the measurement, tap on the stop button swipe right to view details of heart rate data you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a health app that measures blood oxygen and heart rate by yourself! if you're having trouble, you may download this file measuring blood oxygen and heart rate complete code 189 6 kb to learn more, explore samsung health sensor sdk

https://developer.samsung.com/codelab/health/blood-oxygen-heart-rate.html

Develop Health

doc

Developer Support

developer support if you meet a trouble using samsung health sensor sdk, please submit a query at developer support with a bug report log and a detailed issue description reproduce the trouble case on a watch open galaxy wearable app on the phone and select more ξ > galaxy wearable info touch galaxy wearable 10 times tap get dumpstate tap run watch dump and wait find and share myfiles > internal storage > download > log > gearlog > bundled-bugreport-xx zip notefor wear os’s health services apis issues, use "create a new issue" in android developer site

https://developer.samsung.com/health/sensor/developer-support.html

Develop Health

doc

Tracking Sweat Loss

tracking sweat loss notetracking sweat loss is available only for a running exercise samsung health sensor sdk provides tracking sweat loss after an exercise implementation of the sweat loss tracker differs a little from other tracker types, as it requires one more step – feeding the tracker with additional data the ‘steps per minute’ value provided from another source such as wear os’s health services library in addition, the tracker object requires one more element – trackeruserprofile which includes weight, height, age, and gender the following steps describe how to track sweat loss data getting a healthtracker instance for sweat loss after successfully connecting to the healthtrackingservice, a starting point is to get a healthtracker instance healthtrackingservice gethealthtracker healthtrackertype, trackeruserprofile, exercisetype the trackeruserprofile should be set with trackeruserprofile builder private trackeruserprofile profile; // set the user profile profile = new trackeruserprofile builder setheight height setweight weight setgender gender setage age build ; create a healthtracker instance for sweat loss with the user profile from the example above and the exercisetype running private healthtracker sweatlosstracker = null; // after healthtrackingservice connectservice is called private final connectionlistener connectionlistener = new connectionlistener { @override public void onconnectionsuccess { try { // get a healthtracker instance for sweat loss sweatlosstracker = healthtrackingservice gethealthtracker healthtrackertype sweat_loss, profile, com samsung android service health tracking data exercisetype running ; } catch final illegalargumentexception e { // exception handling } catch final unsupportedoperationexception e { // exception handling } } // override other functions of the listener }; set the event listener we discuss the listener later // set an event listener for getting sweat loss data sweatlosstracker seteventlistener trackereventlistener ; starting an exercise with health services during the exercise, you should keep feeding sweat loss tracker with steps_per_minute such data is available through health services create an exerciseclient and set the event listener for an exercise data update private exerciseclient exerciseclient; private void initexerciseclient { if exerciseclient == null { exerciseclient = healthservicesclientprovider getclient context getexerciseclient ; exerciseclient setupdatecallback exerciseupdatecallback ; } } configure a running exercise so that it can track steps_per_minute and distance steps_per_minute is later sent to health tracker using healthtracker setexercisedata and distance is helpful to check an error case when a sweat loss’s status is not zero final exerciseconfig builder exerciseconfigbuilder = exerciseconfig builder exercisetype running setdatatypes new hashset<> arrays aslist datatype distance, steps_per_minute setisautopauseandresumeenabled false setisgpsenabled false ; the data from health services comes in exerciseupdatecallback private final exerciseupdatecallback exerciseupdatecallback = new exerciseupdatecallback { @override public void onexerciseupdatereceived exerciseupdate update { // ‘steps per minute’ values are represented as sample data points extractstepsperminute update getlatestmetrics getsampledatapoints ; // use update getlatestmetrics getintervaldatapoints to get access // to such data as ‘distance’ } // override other functions of the callback }; setting the exercise state to start start the exercise using exerciseclient startexerciseasync after configuring and starting the exercise in health services, it is time to set the exercise state to start on the sweat loss tracker try { // set the exercise state to start sweatlosstracker setexercisestate exercisestate start ; } catch final illegalstateexception e { // exception handling } extracting exercise data and sending them to the tracker the example below shows how to extract ‘steps per minute’ from onexerciseupdatereceived exerciseupdate exerciseupdate they reside in exerciseupdate getlatestmetrics getsampledatapoints private void extractstepsperminute list<sampledatapoint<?>> datapoints { final int listsize = datapoints size ; final float[] spmdata = new float[listsize]; final long[] timestamp = new long[listsize]; for sampledatapoint<?> element datapoints { if element getdatatype equals steps_per_minute { spmdata[datapoints indexof element ] = long objects requirenonnull element getvalue ; timestamp[datapoints indexof element ] = getutctimefromsystemelapsedtime objects requirenonnull element gettimedurationfromboot tomillis ; } } if listsize > 0 { sweatlosstracker setexercisedata steps_per_minute, stepsperminutevalues, stepsperminutetimestamps ; } } we send the exercise data - steps_per_minute to samsung health sensor sdk’s sweat loss tracker using healthtracker setexercisedata monitoring the distance and duration of the exercise is helpful if the exercise’s duration is less than 5 minutes or the distance is less than 2 kilometers, samsung health sensor sdk gives an error in a sweat loss’ status for more errors of sweatlossset status, see samsung health sensor sdk’s api reference setting the exercise state with stop if you decide to finish the exercise, set the exercise state to stop on the tracker @override public void endexercise boolean exception, string state { try { sweatlosstracker setexercisestate exercisestate stop ; } catch final illegalstateexception e { // exception handling } } you should also stop the exercise in the context of health services using exerciseclient endexerciseasync checking the tracker event listener if the running exercise is finished, sweat loss data is available in healthtracker trackereventlistener check a sweat loss’s value and its status private final healthtracker trackereventlistener trackereventlistener = new healthtracker trackereventlistener { @override public void ondatareceived @nonnull list<datapoint> list { if list size != 0 { float sweatloss = list get 0 getvalue valuekey sweatlossset sweat_loss ; int status = list get 0 getvalue valuekey sweatlossset status ; if status == 0 // no error else // check status and handle an error } ; } else { // no data } } @override public void onflushcompleted { // } @override public void onerror healthtracker trackererror trackererror { if trackererror == healthtracker trackererror permission_error { // permission handling } if trackererror == healthtracker trackererror sdk_policy_error { // check a device’s network or submit a query in samsung dev site } // } }; unsetting the tracker event listener after getting the final sweat loss tracker, unset the registered tracker’s event listener sweatlosstracker unseteventlistener ; for more information about sweat loss tracking, refer to the sweat loss monitor sample app

https://developer.samsung.com/health/sensor/guide/tracking-sweat-loss.html

Develop Health

api

HealthTracker.TrackerError

overview package class tree deprecated index com samsung android service health tracking enum healthtracker trackererror java lang object java lang enum<healthtracker trackererror> com samsung android service health tracking healthtracker trackererror all implemented interfaces serializable, comparable<healthtracker trackererror> enclosing class healthtracker public static enum healthtracker trackererror extends enum<healthtracker trackererror> errors thrown by healthtracker's event listener since 1 0 0 see also healthtracker trackereventlistener onerror healthtracker trackererror enum constant summary enum constants enum constant and description permission_error the user has not granted the required runtime permissions sdk_policy_error sdk policy represents a relationship between a partner application and health sensor service method summary all methods static methods concrete methods modifier and type method and description static healthtracker trackererror valueof string name returns the enum constant of this type with the specified name static healthtracker trackererror[] values returns an array containing the constants of this enum type, in the order they are declared enum constant detail permission_error public static final healthtracker trackererror permission_error the user has not granted the required runtime permissions this error is common for all trackers an application needs to get required permissions before calling healthtracker seteventlistener public class mainactivity extends activity { @override protected void oncreate bundle savedinstancestate { // check and request permission if activitycompat checkselfpermission getapplicationcontext , "android permission body_sensors" == packagemanager permission_denied { requestpermissions this, new string[]{manifest permission body_sensors}, 0 ; } // } } since 1 0 0 see also healthtracker trackereventlistener onerror healthtracker trackererror checkselfpermission requestpermissions sdk_policy_error public static final healthtracker trackererror sdk_policy_error sdk policy represents a relationship between a partner application and health sensor service a partner application that uses samsung health sensor sdk requires you to register application information in samsung's system, including an application package name, signature sha256 , and available tracker types sdk_policy_error occurs in the following cases if a running application's package name is not matched with a sdk policy the running application's package name is matched, but its signature sha256 is not to test the application, activate health sensor service's developer mode find more information in the sdk guide the health tracker type is not registered a network is not connected or the connection quality is not good solving this error requires the samsung health team's support please submit an issue with a bug report at samsung developer site > developer support see more information in the sdk guide > developer support since 1 0 0 see also healthtracker trackereventlistener onerror healthtracker trackererror method detail values public static healthtracker trackererror[] values returns an array containing the constants of this enum type, in the order they are declared this method may be used to iterate over the constants as follows for healthtracker trackererror c healthtracker trackererror values system out println c ; returns an array containing the constants of this enum type, in the order they are declared valueof public static healthtracker trackererror valueof string name returns the enum constant of this type with the specified name the string must match exactly an identifier used to declare an enum constant in this type extraneous whitespace characters are not permitted parameters name - the name of the enum constant to be returned returns the enum constant with the specified name throws illegalargumentexception - if this enum type has no constant with the specified name nullpointerexception - if the argument is null

https://developer.samsung.com/health/sensor/api-reference/com/samsung/android/service/health/tracking/HealthTracker.TrackerError.html

Develop Health

doc

Heart Rate Tracker

heart rate tracking with the off-body sensor battery consumption is a critical factor when developing applications that use device sensors to prolong battery life, the samsung health sensor sdk allows you to implement batching trackers, which send multiple data points in a single callback event another way you can extend battery life is by stopping sensor tracking when it is not needed, such as when the watch is not being worn this blog describes the “hr tracker” sample application, which implements the batching heart rate tracker in combination with the off-body sensor the application enables heart rate tracking only when the watch is worn if the user tries to start tracking without wearing the watch, they are informed to put it on if the watch is removed during tracking, the tracking is stopped if you have a galaxy watch4 and later models running wear os powered by samsung, you can download the sample application and test it on your device hr tracker v1 3 0 184 4 kb aug 20 , 2025 prerequisites to implement heart rate tracking in the application in the androidmanifest xml file for the application, declare the appropriate permissions depending on targetsdk of the application and android version of device that the application will run on - one of these two permissions will be used <uses-permission android name="android permission health read_heart_rate" /> <uses-permission android name="android permission body_sensors" /> in the heartrateactivity java application code file, check whether the user has granted appropriate permission on their galaxy watch if they have not, request it since the app may be started on device with either android 15, or android 16 - we must request proper permission the following code will check on which android version the code is executed on string permission; if build version sdk_int >= build version_codes baklava { permission = healthpermissions read_heart_rate; } else { permission = manifest permission body_sensors; } if checkselfpermission permission == packagemanager permission_denied { requestpermissions new string[]{permission}, 0 ; } keep in mind, that if your application targetsdk=35 then body_sensors permissions should always be used implementing on and off-body detection to detect when the galaxy watch is being worn on the wrist create an instance of the sensormanager class msensormanager = sensormanager getsystemservice sensor_service ; from the sensormanager class, create an instance of the sensor class that contains the low-latency off-body sensor offbodysensor = msensormanager getdefaultsensor sensor type_low_latency_offbody_detect ; in the onresume method, register an event listener for changes to the offbodysensor value when the application is in the foreground msensormanager registerlistener skintemperatureactivity this, offbodysensor, sensormanager sensor_delay_normal ; in the onpause method, unregister the event listener when the application is in the background msensormanager unregisterlistener this ; override the onsensorchanged method to react to the offbodydata sensor value change when the watch is worn or removed from the wrist because the sensor value is a float, you must convert the value to an integer final float offbodydatafloat = sensorevent values[0]; final int offbodydata = math round offbodydatafloat ; if the value of offbodydata is 1, the watch is being worn we set the variable, which describes worn status, to true deviceworn set true ; if the value of offbodydata is 0, the watch is not being worn set the status variable to false and if measurement was being done at that time - end it and notify the user deviceworn set false ; if ismeasurementrunning get { endmeasurement ; toast maketext this, r string device_removed_during_measurement, toast length_long show ; } in the sample application - a toast message is shown, if the watch is removed while tracker is working watch removed during measurement measuring the heart rate to measure the user’s heart rate check which trackers are supported on the watch using the checkcapabilities method final list<healthtrackertype> availabletrackers = healthtrackingservice gettrackingcapability getsupporthealthtrackertypes ; and return if the heart rate tracker is supported return availabletrackers contains healthtrackertype heart_rate_continuous ; initialize the heart rate tracker heartratetracker = healthtrackingservice gethealthtracker healthtrackertype heart_rate_continuous ; when "measure" button is pressed - check if watch is being worn before starting tracker and cancel execution if its not if !deviceworn get { toast maketext this, r string device_not_worn, toast length_short show ; return; } set an event listener to receive and handle the tracked heart rate data if !ishandlerrunning { heartratehandler post -> heartratetracker seteventlistener heartratelistener ; ishandlerrunning = true; } a listener is an object, which will process incoming data in this blog we will focus on one of the functions included in it - ondatareceived it contains data gathered by the samsung health sensor sdk as list of datapoint type public void ondatareceived @nonnull list<datapoint> list { for datapoint data list { updateheartrate data ; } } for the heart rate sensor, each tracking result consists of a heart rate reading in beats per minute and its status parameter, and a list of inter-beat intervals and the corresponding status for each value because we are interested in the heart rate, extract the beats per minute reading and status final int status = data getvalue valuekey heartrateset heart_rate_status ; int heartratevalue = data getvalue valuekey heartrateset heart_rate ; trackerdatasubject notifyheartratetrackerobservers status, heartratevalue ; if the heart rate reading was successful, the status value is “1” to interpret other status values, see the api documentation display the heart rate and status value on the application screen activityheartratebinding txtheartratebpmvalue settext string format locale getdefault , "%d", heartratevalue ; activityheartratebinding txtheartratestatusvalue settext string format locale getdefault , "%d", status ; "hr tracker" sample application ui if the measurement is stopped by either user input, or watch being removed - stop the heart rate tracker if heartratelistener != null { heartratelistener stoptracker ; } this demonstration has shown how you can combine multiple strategies to enhance battery life when implementing sensor tracking in your watch applications, such as using batching tracker, and to disable tracking when the user is not wearing the device we encourage you to try doing it by yourself and explore other available features provided by samsung health sensor sdk

https://developer.samsung.com/health/sensor/sample/hr-tracker.html

Develop Health

web

Contact Us | Health Partnerships

health partnerships samsung partners with companies and research institutions worldwide to provide health monitoring features, helping people gain information on their well-being. contact us get in touch to learn more about out digital health solutions and partnership opportunities. first name * please fill out this field last name * please fill out this field email * please fill out this field phone number industry type * please select an item in the list please select digital health pharma/biotech academic institutions governmental and ngos other other * interest area * please select. reach samsung health users samsung health app samsung health sensor sdk samsung health data sdk samsung health accessory sdk health ai & policy health marketplace health research devices, wearables & biosensors algorithm / biomarker development research / validation other other * your message * please fill out this field agreement * please agree to the terms by clicking submit, i understand samsung will contact me to respond to my inquiry and for marketing purposes. you can unsubscribe at any time. please do not share any or confidential information. submitting this form does not create a customer, client, or contractual relationship, and the response you receive should not be considered legal, financial, or medical advice. for more information, see terms of use and privacy policy . submit submit . . .

https://developer.samsung.com/health/partnerships/contact-us

Develop Health

doc

Running App

running sample application source code of the sweat loss monitor application sweat loss monitor v1 6 0 195 3 kb aug 20, 2025 how to install the app on the watch unzip the app from the link above open unzipped project in android studio connect your galaxy watch to your pc with a usb cable in android studio select run -> run app you can check the details about how to deal with app installation on wear os here how to use the app wear the watch on your wrist open the app tap the start button start running ensure that all the values on the screen meet the criteria you should even exceed them by a little margin to ensure valid values when you are ready to finish running, tap the stop button if the sweat loss result status is 0, it means that the sweat loss is properly calculated other status values indicate some kind of problem, usually not met requirements check out the samsung health sensor sdk documentation for all possible values the tracker provides sweat loss value in milliliters

https://developer.samsung.com/health/sensor/sample/sweat-loss-monitor/running-app.html

Didn’t find what you were looking for?

FAQ

Search frequently asked
questions
by keywords.

Join the Forum

Visit the Forum to ask
questions and exchange
ideas with other developers.

Get Support

Submit a 1:1 Support request
and receive a response
within 2 business days.

Preferences Submitted

You have successfully updated your cookie preferences.