KinesteX

Error & Status Events

Events for errors, warnings, and playback fallbacks.


EventData FieldsDescription
error_occurredseverity: string, data: stringError or warning, text in data
error_occurredseverity: string, message: stringError or warning, text in message
warningdata: string, or message: stringA separate notice event, see Application Lifecycle
ios_video_fallback_activatedreason, videoUrl, readyState, userAgentiOS 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.


severityTextWhen
criticalCannot verify: ... or Verification failed. Please check internet connection and try again (in data)Verification of your launch payload failed
criticalUser ID is missing: ... (in data)Launch without a valid userId
criticalError accessing camera / Camera access denied (in data)The camera could not be opened, or permission was denied
warningError processing frame (in data)The pose engine failed on a frame
criticalFailed to fetch N model(s): ... (in message)Some motion models failed to download
criticalcurrentExercise 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
warninglog: no active workout, load_models: no exercises provided, get_exercise_setup: no exercises provided (in message)A command with nothing to act on
warningget_exercise_setup: <ids> not in exercises; add them with load_models first (in message)get_exercise_setup for ids the camera never loaded
warningpause_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
criticalFailed to process custom workout: ... or a validation message (in message)Custom Workout data could not be loaded or is invalid
warningFailed to download workout videos, check network connection (in message)Custom Workout video download blocked
warningPhrase "..." failed to fetch (in message)A rest-speech phrase failed to download
criticalMissing required user profile data: ... (in data)Plan onboarding without weight, age or gender
criticalFailed to save trainer profile: ... (in data)The AI Trainer profile could not be saved

ios_video_fallback_activated Payload:

typescript
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.