Monitor your users heart rate with this pluginRequires a heart rate device supported by Pulsoid and an API Key obtainable by them.This project is a comprehensive heart rate tracking and calibration system for Unity, designed to enable physiological and emotion-aware features in games and interactive applications. It integrates external heart rate monitors (such as Pulsoid, ANT+, or similar devices) to collect, analyze, and respond to live user biometric data. The system provides real-time heart rate data streaming, automated baseline calibration, historic data logging, and emotion state inference for adaptive feedback or bio-interactive game design.Typical use cases include:Adaptive gameplay mechanics (e.g., horror games that respond to player fear levels)Biofeedback-driven experiences and VR/AR/XR environmentsUser wellness and stress monitoring in serious games or training applicationsSystem ArchitecturePulsoidHeartRate.cs: Handles communication with the heart rate device/API. Retrieves, parses, and updates live heart rate data at configurable intervals.HeartRateHistory.cs: Manages rolling storage of historical heart rate samples, calculates baseline values, analyzes emotional states (fear levels), and detects sudden spikes (e.g., jump scares).HeartRateCalibrationController.cs: Coordinates and manages the heart rate calibration process by timing sample collection, validating sample quantity, and broadcasting calibration events to other systems.HeartRateHandler.cs: Central workflow manager. Subscribes to data and state events, notifies listeners, and handles UX/UI feedback for tracking sessions.PulsoidHeartRateData.cs: Data container class for serialization/deserialization of heart rate API responses.FeaturesLive Data Streaming: Fetches user heart rate from third-party services or devices and updates at regular intervals.Data Logging: Maintains a configurable in-memory log of recent readings for trend analysis and export to CSV.Baseline Calibration: Supports timed calibration sessions to determine user's resting/baseline rate, including minimum sample thresholds and event-driven feedback.Fear State Analysis: Classifies heart rate into discrete fear states (Calm, Low, Medium, High, Panic) based on configurable multipliers of baseline.Jump-Scare Detection: Identifies rapid spikes in heart rate over short time windows, suitable for triggering events in horror games.Event-Driven API: All major transitions broadcast via C# events for easy integration with custom UI, gameplay, or analytics.Data Export: Outputs historical session data, including timestamps and derived states, to standard CSV format for analysis.Integration NotesDependencies: Requires Unity, Pulsoid or compatible heart rate hardware/API, and optionally TMPro for UI extensions.Extensibility: Modular structure enables adaptation for other device APIs, custom analytics, or expansion to support additional biometric signals.
