Release Note
release note release date september 22, 2024 release version v1 3 0 target device the samsung health sensor sdk are 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 tracking library of the samsung health sensor sdk import it in 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 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 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 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