KinesteX

Exercise Events

Events for individual exercise tracking in workout flows. The Camera component reports exercises with its own events (exercise_change and a differently shaped exercise_overview), see Camera & Frame Events.


EventDescription
exercise_completedIndividual exercise completed: sent when the user leaves each exercise (not rests). In the Gym Log, per set (see Workout Events)
exercise_overviewAll exercises summary (array), sent on the results screen
exercise_auto_skippedThe SDK skipped a stalled exercise on its own (see below)
exercise_setupHow each exercise starts and where the camera goes. Workouts send it only with includePoseData containing "events", see Real-Time Motion Events

exercise_completed Data Structure:

typescript
1{
2  exercise_title: string,        // Exercise name ("-" when unknown)
3  time_spent: number,            // Seconds spent
4  repeats: number,               // Reps completed
5  total_reps?: number,           // Required reps (omitted when none)
6  total_duration?: number,       // Countdown time (omitted when none)
7  perfect_hold_position: number, // Time in perfect hold position (seconds).
8                                 // 0 for non-hold exercises
9  calories: number,              // Calories burned (2 decimal places)
10  exercise_id: string,           // Exercise ID
11  exercise: string,              // Same as exercise_id
12  exercise_index: number,        // 1-based position in the workout, rest periods included
13  total_exercises: number,       // Total entries in the workout, rest periods included
14  mistakes: Array<{              // Mistakes made
15    mistake: string,
16    count: number
17  }>,
18  average_accuracy?: number      // Average accuracy (0-1). Only with
19                                 // includeRealtimeAccuracy: true
20}

exercise_index and total_exercises count rest periods here, unlike workout_progress. In the Gym Log, editing a set that was already reported sends exercise_completed again for the same exercise, so treat it as an update.


exercise_auto_skipped: sent when the SDK moves past an exercise because the user made 7 form mistakes in a row (a correct rep resets the count), or no rep or mistake was detected for 30 seconds in a rep-based exercise. A 5-second warning comes first, and a correct rep during it cancels the skip. The usual exercise_completed and workout_progress for that exercise follow. Only in Workout, Plan, Personalized Plan and Custom Workout. It cannot be turned off; includePhrases can only drop the spoken auto_skip line.

typescript
1{
2  type: "exercise_auto_skipped",
3  data: {
4    exercise_id: string,
5    exercise_title: string,
6    trigger: "mistake_count" | "inactivity",
7    exercise_index: number,      // 1-based, rest periods included
8    total_exercises: number
9  },
10  date: string                   // "DD MM YYYY HH:MM:SS"
11}

exercise_overview Item Structure:

typescript
1{
2  exercise_title: string,        // Exercise name
3  exercise: string,              // Same as exercise_title (older name)
4  exercise_id: string,           // Unique exercise ID
5  time_spent: number,            // Time on exercise (seconds)
6  perfect_hold_position: number, // Time in correct position (timer-based)
7  repeats: number,               // Reps completed
8  total_required_reps: number,   // Target reps (0 when none)
9  total_required_time: number,   // Target time in seconds (0 when none)
10  calories: number,              // Calories (2 decimal places)
11  mistakes: Array<{              // Detailed mistake breakdown
12    mistake: string,
13    count: number
14  }>,
15  mistake_count: number,         // Total mistakes for exercise
16  accuracy_reps?: number[],      // Per-rep accuracy scores. Only with
17                                 // includeRealtimeAccuracy: true
18  average_accuracy?: number      // Average accuracy 0-100. Only with
19                                 // includeRealtimeAccuracy: true
20}