Release Note

• 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.

  • 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.

[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.