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.
| Event | Description |
| exercise_completed | Individual exercise completed: sent when the user leaves each exercise (not rests). In the Gym Log, per set (see Workout Events) |
| exercise_overview | All exercises summary (array), sent on the results screen |
| exercise_auto_skipped | The SDK skipped a stalled exercise on its own (see below) |
| exercise_setup | How 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:
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.
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:
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}