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).
| Parameter | Type | Default | Applies to | What it does internally |
| motionTrackingSettingOn | boolean | true | Settings modal | When false, hides the tracking-mode choice (Self / AI) in the in-app Settings, so users cannot change it themselves |
| motionTrackingEnabled | boolean | the user's saved choice (on) | Workout player | Forces AI tracking on or off for this session. When sent (true or false), it clears the user's saved choice and uses your value |
| motionDataEnabled | boolean | true | Workout player, Camera | When 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= |
| selfModeEnabled | boolean | true | Workout player, AI Trainer | What 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_progressandworkout_endedevents are sent. No form accuracy or mistake data is recorded (the accuracy score inworkout_overviewonly 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
videoURLinstead: 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)