Measurement preparation

After successfully installing, initializing and optionally configuring the SDK, your app should be ready to start the video measurement.

Before starting the measurement, the user should be instructed to keep a stable position without talking and changing the facial expression.

Initial conditions

After initialization, the SDK will start to analyze the video stream from the camera.

In order for the measurement to begin, the user needs to locate their face in the middle of the screen, in good lighting conditions. The embedded user interface displays face positioning hints, but you can also use the GetFaceState() and GetNormalizedFaceBbox() methods to check the current face position.

enum FaceState {
  ok,
  tooFar,
  tooClose,
  notCentered,
  notVisible,
  unknown,
}
 
val faceState = ShenaiSdk.getFaceState();
 
class NormalizedFaceBbox {
  double x;
  double y;
  double width;
  double height;
}
 
val normalizedFaceBbox = ShenaiSdk.getNormalizedFaceBbox();

  import { getFaceState, getNormalizedFaceBbox, FaceState, NormalizedFaceBbox } from 'react-native-shenai-sdk';
 
  enum FaceState {
    OK = 0,
    TOO_FAR,
    TOO_CLOSE,
    NOT_CENTERED,
    NOT_VISIBLE,
    UNKNOWN,
  }
  
  const faceState = await getFaceState();
 
  interface NormalizedFaceBbox {
    x: number;
    y: number;
    width: number;
    height: number;
  }
 
  const normalizedFaceBbox = await getNormalizedFaceBbox();

enum FaceState {
  case .ok
  case .tooFar
  case .tooClose
  case .notCentered
  case .notVisible
  case .unknown
};
 
let faceState = ShenaiSDK.getFaceState()
 
class NormalizedFaceBbox {
  var x: Float
  var y: Float
  var width: Float
  var height: Float
}
 
let normalizedFaceBbox = ShenaiSDK.getNormalizedFaceBbox()

 
enum FaceState {
  OK,
  NOT_CENTERED,
  TOO_CLOSE,
  TOO_FAR,
  NOT_VISIBLE,
  INVALID,
}
 
FaceState faceState = shenaiSDKHandler.getFaceState();
 
class NormalizedFaceBbox {
  float x;
  float y;
  float width;
  float height;
}
 
NormalizedFaceBbox normalizedFaceBbox = shenaiSDKHandler.getNormalizedFaceBbox();

enum FaceState {
  OK = 0,
  NOT_CENTERED,
  TOO_CLOSE,
  TOO_FAR,
  NOT_VISIBLE,
  INVALID,
}
 
const faceState = shenai.getFaceState();
 
interface NormalizedFaceBbox {
  x: number;
  y: number;
  width: number;
  height: number;
}
 
const normalizedFaceBbox = shenai.getNormalizedFaceBbox();

Starting the measurement

To allow the measurement to start, the user can click the START button in the embedded UI. Alternatively, you can attain the same effect programmatically by setting the SDK operating mode to Measure:

ShenaiSdk.setOperatingMode(OperatingMode.measure);

import { setOperatingMode, OperatingMode } from 'react-native-shenai-sdk';
 
await setOperatingMode(OperatingMode.MEASURE);

ShenaiSDK.setOperatingMode(.measure)

shenaiSDKHandler.setOperatingMode(OperatingMode.MEASURE);

shenaiSDK.setOperatingMode(shenaiSDK.OperatingMode.MEASURE);

Note that the actual measurement will not start until the user’s face is in the correct position.

Web Measurement