During the measurement

After the measurement has started, you can monitor the stage and progress of the measurement.

Checking the measurement state

To see what is happening underneath you can call the getMeasurementState() method. It returns the following enumeration informing you about the state of the measurement.


enum MeasurementState {
  notStarted,                       // Measurement has not started yet
  waitingForFace,                   // Waiting for face to be properly positioned in the frame
  runningSignalShort,               // Measurement started: Signal is too short for any conclusions
  runningSignalGood,                // Measurement proceeding: Signal quality is good
  runningSignalBad,                 // Measurement stalled due to poor signal quality
  runningSignalBadDeviceUnstable,   // Measurement stalled due to poor signal quality (caused by unstable device)
  finalizing,                       // Measurement capture has ended and final result computation is in progress
  finished,                         // Measurement has finished successfully
  failed,                           // Measurement has failed
}


enum MeasurementState {
  NOT_STARTED = 0, // Measurement has not started yet
  WAITING_FOR_FACE, // Waiting for face to be properly positioned in the frame
  RUNNING_SIGNAL_SHORT, // Measurement started: Signal is too short for any conclusions
  RUNNING_SIGNAL_GOOD, // Measurement proceeding: Signal quality is good
  RUNNING_SIGNAL_BAD, // Measurement stalled due to poor signal quality
  RUNNING_SIGNAL_BAD_DEVICE_UNSTABLE, // Measurement stalled due to poor signal quality (caused by unstable device)
  FINALIZING, // Measurement capture has ended and final result computation is in progress
  FINISHED, // Measurement has finished successfully
  FAILED // Measurement has failed
}


enum MeasurementState {
  NOT_STARTED = 0, // Measurement has not started yet
  WAITING_FOR_FACE, // Waiting for face to be properly positioned in the frame
  RUNNING_SIGNAL_SHORT, // Measurement started: Signal is too short for any conclusions
  RUNNING_SIGNAL_GOOD, // Measurement proceeding: Signal quality is good
  RUNNING_SIGNAL_BAD, // Measurement stalled due to poor signal quality
  RUNNING_SIGNAL_BAD_DEVICE_UNSTABLE, // Measurement stalled due to poor signal quality (caused by unstable device)
  FINALIZING, // Measurement capture has ended and final result computation is in progress
  FINISHED, // Measurement has finished successfully
  FAILED // Measurement has failed
}


public enum MeasurementState
{
    NOT_STARTED = 0,                // Measurement has not started yet
    WAITING_FOR_FACE,               // Waiting for face to be properly positioned in the frame
    RUNNING_SIGNAL_SHORT,           // Measurement started: Signal is too short for any conclusions
    RUNNING_SIGNAL_GOOD,            // Measurement proceeding: Signal quality is good
    RUNNING_SIGNAL_BAD,             // Measurement stalled due to poor signal quality
    RUNNING_SIGNAL_BAD_DEVICE_UNSTABLE, // Measurement stalled due to poor signal quality (caused by unstable device)
    FINALIZING,                     // Measurement capture has ended and final result computation is in progress
    FINISHED,                       // Measurement has finished successfully
    FAILED                          // Measurement has failed
}


enum MeasurementState {
  case notStarted                     // Measurement has not started yet
  case waitingForFace                 // Waiting for face to be properly positioned in the frame
  case runningSignalShort             // Measurement started: Signal is too short for any conclusions
  case runningSignalGood              // Measurement proceeding: Signal quality is good
  case runningSignalBad               // Measurement stalled due to poor signal quality
  case runningSignalBadDeviceUnstable // Measurement stalled due to poor signal quality (caused by unstable device)
  case finalizing                     // Measurement capture has ended and final result computation is in progress
  case finished                       // Measurement has finished successfully
  case failed                         // Measurement has failed
}


enum MeasurementState {
  NOT_STARTED,                        // Measurement has not started yet
  WAITING_FOR_FACE,                   // Waiting for face to be properly positioned in the frame
  RUNNING_SIGNAL_SHORT,               // Measurement started: Signal is too short for any conclusions
  RUNNING_SIGNAL_GOOD,                // Measurement proceeding: Signal quality is good
  RUNNING_SIGNAL_BAD,                 // Measurement stalled due to poor signal quality
  RUNNING_SIGNAL_BAD_DEVICE_UNSTABLE, // Measurement stalled due to poor signal quality (caused by unstable device)
  FINALIZING,                         // Measurement capture has ended and final result computation is in progress
  FINISHED,                           // Measurement has finished successfully
  FAILED                              // Measurement has failed
}


import { MeasurementState } from "@shenai/sdk"
 
// Retrieve the current measurement state
const measurementState = shenaiSDK.getMeasurementState()
 
switch (measurementState) {
  case MeasurementState.NOT_STARTED:
    console.log("Measurement has not started yet")
    break
  case MeasurementState.WAITING_FOR_FACE:
    console.log("Waiting for face to be properly positioned in the frame")
    break
  case MeasurementState.RUNNING_SIGNAL_SHORT:
    console.log("Measurement started: signal is too short for any conclusions")
    break
  case MeasurementState.RUNNING_SIGNAL_GOOD:
    console.log("Measurement proceeding: signal quality is good")
    break
  case MeasurementState.RUNNING_SIGNAL_BAD:
    console.log("Measurement stalled due to poor signal quality")
    break
  case MeasurementState.RUNNING_SIGNAL_BAD_DEVICE_UNSTABLE:
    console.log("Measurement stalled due to device instability")
    break
  case MeasurementState.FINALIZING:
    console.log("Measurement capture has ended and final result computation is in progress")
    break
  case MeasurementState.FINISHED:
    console.log("Measurement has finished successfully")
    break
  case MeasurementState.FAILED:
    console.log("Measurement has failed")
    break
}

In particular, you should wait for Finished or Failed values, because they indicate that the measurement has concluded.

Tracking the measurement progress

To check the progress of the whole measurement you can call the getMeasurementProgressPercentage() method, returning a floating point number between 0 and 100.

Real-time metrics

During the measurement you can query the SDK for real-time metrics. These metrics are updated every second.

Heart rate

You can query the real-time heart rate based on the last 10 seconds of the measurement. The provided value is the average heart rate over the specified time interval and is expressed in beats per minute (BPM), rounded to the nearest integer.


final hr10s = await ShenaiSdk.getHeartRate10s();


import { getHeartRate10s } from "@shenai/react-native-sdk"
 
const hr10s = await getHeartRate10s()


import { ShenaiSdkCapacitor } from "@shenai/capacitor-sdk"
 
const { value: hr10s } = await ShenaiSdkCapacitor.getHeartRate10s()


using Shenai.Maui;
 
var hr10s = await ShenaiSdk.GetHeartRate10sAsync();


let hr = ShenaiSDK.getHeartRate10s()


int hr10s = shenaiSDKHandler.getHeartRate10s();


const hr10s = shenaiSDK.getHeartRate10s()

Measurement success

When the Shen.AI SDK engine enters the Finished state it means that the measurement has concluded and computed metrics are available.

See Results to see how to access the results.