Introducción

KinesiaMotion es el SDK que usa la app de Kinesia para medir el movimiento de un paciente con la cámara del iPhone. Recibe los puntos del cuerpo fotograma a fotograma y devuelve lo que una app de rehabilitación necesita: el ángulo actual, las repeticiones hechas, las que se hicieron con mala técnica y si el paciente está bien ubicado frente a la cámara.

Dos módulos

Módulo	Qué contiene	Depende de
KinesiaMotion	El motor: poses, mediciones, ejercicios, conteo de repeticiones, sesión. Swift puro, sin cámara ni UI.	Foundation, CoreGraphics, Observation
KinesiaMotionVision	VisionPoseProvider: poses en vivo desde la cámara con el detector de cuerpo de Vision.	KinesiaMotion, AVFoundation, Vision

La separación es intencional: el motor se puede probar en macOS con poses grabadas, y la fuente de poses se puede cambiar (otro detector, un archivo, un servidor) sin tocar nada más.

Lo que hace

• Mide en grados con cuatro tipos de medición: ángulo interno, flexión, ángulo contra la vertical e inclinación.
• Cuenta repeticiones con umbrales de histéresis, y mide sostenidos (mantener una posición durante N segundos).
• Revisa la técnica: cada ejercicio tiene reglas de forma; avisa en vivo y rechaza las repeticiones que las rompen.
• Revisa la ubicación: detecta si el paciente debe girarse, acercarse o alejarse.
• Mide la calidad: confianza del detector por repetición, velocidad máxima, tiempos de subida y bajada.
• Medición inicial (baseline): la mediana de las primeras N repeticiones limpias.

Lo que no hace

• No dibuja interfaz. Te da un MotionSnapshot observable y un flujo de eventos; la pantalla, la voz y la vibración son tuyas.
• No guarda datos. Tú decides dónde persistir las repeticiones (session.reps).
• No traduce. Las correcciones (FormFeedback, SetupIssue) son casos de un enum; tu app los convierte en texto y voz en el idioma del paciente.

Uso clínico

KinesiaMotion mide en 2D a partir de una sola cámara. Las mediciones sirven para seguir la evolución de un mismo paciente con la misma postura, no reemplazan una goniometría clínica.

Requisitos

• iOS 17 o superior (macOS 14 para el motor y las pruebas).
• Swift 6 con concurrencia estricta: todos los tipos públicos son Sendable.
• KinesiaMotionVision solo funciona en iOS (necesita cámara).