KinesteX

Motion Tracking Settings

Control AI motion tracking. Applies to: Workout player (in the Camera component, games and assessments motion tracking is always on and users cannot turn it off).


ParameterTypeDefaultApplies toWhat it does internally
motionTrackingSettingOnbooleantrueSettings modalWhen false, hides the tracking-mode choice (Self / AI) in the in-app Settings, so users cannot change it themselves
motionTrackingEnabledbooleanthe user's saved choice (on)Workout playerForces AI tracking on or off for this session. When sent (true or false), it clears the user's saved choice and uses your value
motionDataEnabledbooleantrueWorkout player, CameraWhen false, the SDK does not record per-frame pose data during the session. Session replay and the mistakes summary are empty for that session; rep counting and everything else work as usual. Send a boolean false by postMessage or inside ?data=
selfModeEnabledbooleantrueWorkout player, AI TrainerWhat users get when motion tracking is off. true: the Gym Log. false: the older timer-only exercise page

What happens when motion tracking is OFF (`motionTrackingEnabled: false` or the user's choice):

  • The positioning (check frame) step is skipped and no camera or pose pipeline runs; a "No AI" badge is shown.
  • Users get the Gym Log: they log each set by hand (adjusting the reps, or tapping "+1 rep" during a timed set), adjust rest, undo or redo a set, and review the session at the end. Logged reps show on the results screen, and the usual workout_started, exercise_completed, workout_progress and workout_ended events are sent. No form accuracy or mistake data is recorded (the accuracy score in workout_overview only reflects time spent against the planned time).
  • With selfModeEnabled: false, rep-based exercises become timers (about 2 seconds per configured rep) that auto-advance, and no reps are recorded.
  • For realistic tracking data without a person in front of the camera, use videoURL instead: see Testing & Simulation.

`motionDataEnabled`: only use it if you know why you need it. It exists for memory-constrained cases (for example long workouts with many unique exercise videos on older iOS devices, where memory pressure can crash the WebView). Turning motion data off saves memory at the cost of session replay. The recorder is reset on every launch, so the flag never carries over to the next session.

Motion Tracking Settings
Swift example:
1kinestex.createWorkoutView( // same customParams on every create*View method
2    workout: "Fitness Lite",
3    user: nil,
4    style: nil,
5    isLoading: $isLoading,
6    customParams: [
7        "motionTrackingSettingOn": true,
8        "motionTrackingEnabled": true,
9        "selfModeEnabled": true,
10        "motionDataEnabled": false // only when memory-constrained
11    ],
12    onMessageReceived: { message in /* ... */ }
13)