Error & Status Events
Events for errors, warnings, and playback fallbacks.
| Event | Data Fields | Description |
| error_occurred | severity: string, data: string | Error or warning, text in data |
| error_occurred | severity: string, message: string | Error or warning, text in message |
| warning | data: string, or message: string | A separate notice event, see Application Lifecycle |
| ios_video_fallback_activated | reason, videoUrl, readyState, userAgent | iOS dropped to image-based playback after the full recovery ladder (silent retry → tap-to-play prompt → image mode) failed. The exercise still runs in a degraded-but-functional mode. Workout flows and Gym Log |
error_occurred severity. Every error_occurred from KinesteX has a severity. "critical" means something the user needs failed, for example verification, camera access, loading exercise models, or saving the trainer profile. It does not always end the session: after a partial load_models failure, the models that did load still work. "warning" is a smaller problem the session works around, for example an audio phrase that failed to download, or a log or load_models request with nothing to act on. Read the text from data or message, whichever is present. (React Native also creates an error_occurred of its own when the WebView fails to load, with message and errorCode and no severity.)
Common texts. Match on severity, not on exact texts; they are listed so you can recognise them in logs.
| severity | Text | When |
| critical | Cannot verify: ... or Verification failed. Please check internet connection and try again (in data) | Verification of your launch payload failed |
| critical | User ID is missing: ... (in data) | Launch without a valid userId |
| critical | Error accessing camera / Camera access denied (in data) | The camera could not be opened, or permission was denied |
| warning | Error processing frame (in data) | The pose engine failed on a frame |
| critical | Failed to fetch N model(s): ... (in message) | Some motion models failed to download |
| critical | currentExercise is not loaded / currentExercise is not included in exercises list (in message) | Camera component: the current exercise's model failed, or the id is not in exercises |
| warning | log: no active workout, load_models: no exercises provided, get_exercise_setup: no exercises provided (in message) | A command with nothing to act on |
| warning | get_exercise_setup: <ids> not in exercises; add them with load_models first (in message) | get_exercise_setup for ids the camera never loaded |
| warning | pause_camera: only supported in the camera component (or resume_camera: ...) (in message) | Camera command sent to another integration |
| warning | <reset_progress, reset_all_progress or reset_check_frame>: camera is not active, reset_progress: no active exercise (in message) | Camera reset command with no camera page open, after Stop Camera, or with no current exercise |
| critical | Failed to process custom workout: ... or a validation message (in message) | Custom Workout data could not be loaded or is invalid |
| warning | Failed to download workout videos, check network connection (in message) | Custom Workout video download blocked |
| warning | Phrase "..." failed to fetch (in message) | A rest-speech phrase failed to download |
| critical | Missing required user profile data: ... (in data) | Plan onboarding without weight, age or gender |
| critical | Failed to save trainer profile: ... (in data) | The AI Trainer profile could not be saved |
ios_video_fallback_activated Payload:
1{
2 type: "ios_video_fallback_activated",
3 reason: string, // which recovery stage failed (see below)
4 videoUrl: string, // URL of the affected video
5 readyState: number | null, // HTMLMediaElement readyState; null when no video element was available
6 userAgent: string // Device user agent string
7}reason is one of:
"stuck_after_tap": user tapped the prompt but the video still had no media data"tap_prompt_timeout": the tap-to-play prompt was ignored (~5s) and auto-advanced to image mode"tap_play_element_missing": the video element was gone when the user tapped"tap_play_rejected_<ErrorName>": the gesture-driven play was rejected, e.g."tap_play_rejected_NotAllowedError"
(The former single value "video_stuck_at_metadata" is no longer emitted. Treat any occurrence of this event as "iOS entered image mode" and branch on the reason prefixes only if needed. Handle readyState as nullable.)
Use this event for analytics or to surface a notice in your UI when iOS playback degrades. Only listen for it if you need visibility into iOS playback issues; no integrator action is required.