import LoadShenaiSDK from "shenai-sdk"; const shenai_sdk = await LoadShenaiSDK(); const API_KEY = "";const USER_ID = ""; shenai.initialize(API_KEY, USER_ID, (initResult) => {});

enum InitializationResult {  OK,  INVALID_API_KEY,  CONNECTION_ERROR,  INTERNAL_ERROR,} if (initResult != shenai_sdk.InitializationResult.OK) {  // handle error}

<canvas id="mxcanvas" />

<canvas id="not-mxcanvas" />...shenai_sdk.attachToCanvas("#not-mxcanvas");

Measurement settings

OperatingMode

The SDK can be in one of two operating modes:

• Positioning: the SDK will track the user’s face position and give feedback to the user to keep the face in a proper position for starting the measurement. This is the default mode after the SDK is initialized.
• Measure: the SDK will start the measurement as soon as the face is in a proper position.

Clicking on the START/STOP button in the embedded user interface will switch between those two modes. You can also switch between those modes programmatically or start the SDK in the Measure mode by providing a custom configuration object at initialization:

shenaiSDK.initialize(..., {  operatingMode: shenaiSDK.OperatingMode.MEASURE,  ...}); const mode = shenaiSDK.getOperatingMode(); shenaiSDK.setOperatingMode(shenaiSDK.OperatingMode.POSITIONING);shenaiSDK.setOperatingMode(shenaiSDK.OperatingMode.MEASURE); 

PrecisionMode

By default, the SDK will use the strict precision mode, which will only return results if the signal quality is high enough (the threshold is determined by tests on internal datasets with high-quality ECG-based Ground Truth). You may choose to use the relaxed precision mode, which will return results even if the signal quality is low.

• Strict: the SDK will only return results if the signal quality is high enough. This is the default mode after the SDK is initialized.
• Relaxed: the SDK will return results on a best-effort basis. The results obtained in this mode should not be relied upon and represent the best guess given the current conditions.

shenaiSDK.initialize(..., {  precisionMode: shenaiSDK.PrecisionMode.STRICT,  ...}); const mode = shenaiSDK.getPrecisionMode(); shenaiSDK.setPrecisionMode(shenaiSDK.PrecisionMode.STRICT);shenaiSDK.setPrecisionMode(shenaiSDK.PrecisionMode.RELAXED); 

MeasurementPreset

At this time, there are three measurement presets available:

• OneMinuteHrHrvBr: a one-minute measurement that returns Heart Rate, Heart Rate Variability and Breathing Rate. This is the default preset after the SDK is initialized.
• OneMinuteBetaMetrics: a one-minute measurement that includes metrics that are currently in beta – Blood Pressure and Stress Index
• InfiniteHr: an infinite measurement that provides continous Heart Rate without any end condition.

shenaiSDK.initialize(..., {measurementPreset: shenaiSDK.MeasurementPreset.ONE_MINUTE_HR_HRV_BR, ...}); const preset = shenaiSDK.getMeasurementPreset(); shenaiSDK.setMeasurementPreset(shenaiSDK.MeasurementPreset.ONE_MINUTE_HR_HRV_BR);shenaiSDK.setMeasurementPreset(shenaiSDK.MeasurementPreset.ONE_MINUTE_BETA_METRICS);shenaiSDK.setMeasurementPreset(shenaiSDK.MeasurementPreset.INFINITE_HR); 

CameraMode

The SDK can be in one of three camera modes:

• Off: the camera is turned off.
• FacingUser: the user-facing camera of the device is used (such as the front camera on a phone). This is the default mode after the SDK is initialized.
• FacingEnvironment: the outside-facing camera of the device is used (such as the back camera on a phone).

 shenaiSDK.initialize(..., {cameraMode: shenaiSDK.CameraMode.FACING_USER,...}); const mode = shenaiSDK.getCameraMode(); shenaiSDK.setCameraMode(shenaiSDK.CameraMode.OFF);shenaiSDK.setCameraMode(shenaiSDK.CameraMode.FACING_USER);shenaiSDK.setCameraMode(shenaiSDK.CameraMode.FACING_ENVIRONMENT); 

Preview settings

You can customize the user feedback interface by changing the following settings:

• ShowUserInterface controls whether the user feedback interface is shown. If set to false, the SDK will not display any interactive elements such as the START/STOP button.
• ShowFacePositioningOverlay controls whether the face positioning overlay is shown. If set to false, the SDK will not display the overlay that guides the user to position their face correctly.
• ShowVisualWarnings controls whether visual warnings are shown. If set to false, the SDK will not display any visual warnings such as the red bulb that indicates that the signal quality is low.
• EnableCameraSwap controls whether the user can switch between the front and back camera. If set to false, the user will not be able to switch between the front and back camera.
• ShowFaceMask controls whether the face mask visualization is shown. If set to false, the SDK will not display the 3d face mask visualization.
• ShowBloodFlow controls whether the blood flow visualization is shown. If set to false, the SDK will not display the blood flow visualization as an overlay on the user’s face.
• EnableStartAfterSuccess controls whether the START button is available after a successful measurement. If set to false, the START button will not be available after a successful measurement until the SDK is reinitialized.

shenaiSDK.setShowUserInterface(true);const showUserInterface = shenaiSDK.getShowUserInterface(); shenaiSDK.setShowFacePositioningOverlay(true);const showFacePositioningOverlay = shenaiSDK.getShowFacePositioningOverlay(); shenaiSDK.setShowVisualWarnings(true);const showVisualWarnings = shenaiSDK.getShowVisualWarnings(); shenaiSDK.setEnableCameraSwap(true);const enableCameraSwap = shenaiSDK.getEnableCameraSwap(); shenaiSDK.setShowFaceMask(true);const showFaceMask = shenaiSDK.getShowFaceMask(); shenaiSDK.setShowBloodFlow(true);const showBloodFlow = shenaiSDK.getShowBloodFlow();