{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"h2","attributes":{"id":"overview"},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sahha requires device data such as steps, sleep, heart rate, and other health signals in order to analyse health. This guide shows you how to configure and manage device sensors, request the right permissions, check collection status, and recover from incomplete setup."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Sahha SDK acts as a bridge between your app and the device's health data sources. It simplifies permission handling, background collection, and the process of connecting Apple Health and Health Connect data to Sahha."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page focuses on the sensor and permission part of the integration. Before requesting health access, make sure you have already completed project setup, SDK configuration, and user authentication."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"before-you-request-permissions"},"children":["Before you request permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only call ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," after the following are complete:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The SDK has been configured"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The correct user profile has been authenticated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your app has explained what access is being requested and why"]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"project-prerequisites"},"children":["Project prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure the platform setup work is already complete before you start requesting sensors:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iOS:"]}," HealthKit capability, HealthKit Background Delivery, Background Modes, and usage descriptions must be configured in Xcode."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Android:"]}," Matching ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"uses-permission"},"children":[]}," entries must be declared in ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"AndroidManifest.xml"},"children":[]},", and devices running Android 9 through Android 13 need the Health Connect app installed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Android native steps and sleep:"]}," if your app relies on native steps or sleep synchronisation, include ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"WRITE_STEPS"},"children":[]}," and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"WRITE_SLEEP"},"children":[]}," as well as the read permissions."]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Complete setup first","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If project capabilities, manifest permissions, or usage descriptions are missing, ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," may not behave as expected and data collection may fail."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the platform setup guides before continuing:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"/docs/connect/sdk/installation/ios#set-up-xcode-project"},"children":["iOS Platform Setup"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"/docs/connect/sdk/installation/android#set-up-android-project"},"children":["Android Platform Setup"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"sensor-settings"},"children":["Sensor Settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must specify which sensors the Sahha SDK should use. We recommend asking the user for permission to access only the sensors that your app actually needs. Requesting fewer, more relevant permissions usually improves opt-in rates and helps with App Store and Play Store review."]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Choose which sensors to request user permission for","type":"warning"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify an array of sensors to request permission for - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ONLY THOSE SENSORS will be requested."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you wish to add more sensors in future, append the new sensors to the array and follow the guide for prompting the user if sensors are not enabled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If you set the Sensor Settings value to an empty array ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"[]"},"children":[]},", you will receive an ERROR."]}]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"sahha-sensor"},"children":["SahhaSensor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SahhaSensor"},"children":[]}," has a unique identifier which can be used with multiple SDK methods. A complete list is available below."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check the official documentation for the matching Android and iOS sensor to see platform-specific details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Some sensors are not available on all platforms."]}]},{"$$mdtype":"Tag","name":"Table","attributes":{},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","scope":"col"},"children":["SahhaSensor"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","scope":"col"},"children":["Requires Wearable"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","scope":"col"},"children":["Android Sensor"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","scope":"col"},"children":["iOS Sensor"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["gender"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkcharacteristictypeidentifier/1615283-biologicalsex"},"children":["biologicalSex"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["date_of_birth"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkcharacteristictypeidentifier/1615780-dateofbirth"},"children":["dateOfBirth"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["sleep"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/SleepSessionRecord"},"children":["SleepSessionRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkcategorytypeidentifier/1615425-sleepanalysis"},"children":["sleepAnalysis"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["steps"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/StepsRecord"},"children":["StepsRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615548-stepcount"},"children":["stepCount"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["floors_climbed"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/FloorsClimbedRecord"},"children":["FloorsClimbedRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615458-flightsclimbed"},"children":["flightsClimbed"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["heart_rate"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/HeartRateRecord"},"children":["HeartRateRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615138-heartrate"},"children":["heartRate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["resting_heart_rate"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/RestingHeartRateRecord"},"children":["RestingHeartRateRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/2867756-restingheartrate"},"children":["restingHeartRate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["walking_heart_rate_average"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/2874170-walkingheartrateaverage"},"children":["walkingHeartRateAverage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["heart_rate_variability_rmssd"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/HeartRateVariabilityRmssdRecord"},"children":["HeartRateVariabilityRmssdRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["heart_rate_variability_sdnn"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/2881127-heartratevariabilitysdnn"},"children":["heartRateVariabilitySDNN"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["blood_pressure_systolic"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BloodPressureRecord"},"children":["BloodPressureRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615552-bloodpressuresystolic"},"children":["bloodPressureSystolic"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["blood_pressure_diastolic"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BloodPressureRecord"},"children":["BloodPressureRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615233-bloodpressurediastolic"},"children":["bloodPressureDiastolic"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["blood_glucose"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BloodGlucoseRecord"},"children":["BloodGlucoseRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615455-bloodglucose"},"children":["bloodGlucose"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["vo2_max"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/Vo2MaxRecord"},"children":["Vo2MaxRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/2867757-vo2max"},"children":["vo2Max"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["oxygen_saturation"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/OxygenSaturationRecord"},"children":["OxygenSaturationRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615377-oxygensaturation"},"children":["oxygenSaturation"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["respiratory_rate"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/RespiratoryRateRecord"},"children":["RespiratoryRateRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615094-respiratoryrate"},"children":["respiratoryRate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["active_energy_burned"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/ActiveCaloriesBurnedRecord"},"children":["ActiveCaloriesBurnedRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615771-activeenergyburned"},"children":["activeEnergyBurned"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["basal_energy_burned"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615512-basalenergyburned"},"children":["basalEnergyBurned"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["total_energy_burned"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/TotalCaloriesBurnedRecord"},"children":["TotalCaloriesBurnedRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["basal_metabolic_rate"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BasalMetabolicRateRecord"},"children":["BasalMetabolicRateRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["time_in_daylight"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/4168154-timeindaylight/"},"children":["timeInDaylight"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["body_temperature"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BodyTemperatureRecord"},"children":["BodyTemperatureRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615490-bodytemperature"},"children":["bodyTemperature"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["basal_body_temperature"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BasalBodyTemperatureRecord"},"children":["BasalBodyTemperatureRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615763-basalbodytemperature"},"children":["basalBodyTemperature"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["sleeping_wrist_temperature"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/3951065-applesleepingwristtemperature"},"children":["appleSleepingWristTemperature"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["height"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/HeightRecord"},"children":["HeightRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615039-height"},"children":["height"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["weight"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/WeightRecord"},"children":["WeightRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615693-bodymass"},"children":["bodyMass"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["lean_body_mass"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/LeanBodyMassRecord"},"children":["LeanBodyMassRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615664-leanbodymass"},"children":["leanBodyMass"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["body_mass_index"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615698-bodymassindex"},"children":["bodyMassIndex"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["body_fat"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BodyFatRecord"},"children":["BodyFatRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615666-bodyfatpercentage"},"children":["bodyFatPercentage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["body_water_mass"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BodyWaterMassRecord"},"children":["BodyWaterMassRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["bone_mass"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/BoneMassRecord"},"children":["BoneMassRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["waist_circumference"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/2867758-waistcircumference"},"children":["waistCircumference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["stand_time"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/3174858-applestandtime"},"children":["appleStandTime"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["move_time"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/3131035-applemovetime"},"children":["appleMoveTime"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["exercise_time"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615696-appleexercisetime"},"children":["appleExerciseTime"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["activity_summary"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkactivitysummary"},"children":["activitySummary"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["device_lock"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/android/devicelock/package-summary"},"children":["devicelock"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Sensor Not Available"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["exercise"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/androidx/health/connect/client/records/ExerciseSessionRecord"},"children":["ExerciseSessionRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkworkout"},"children":["workout"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["energy_consumed"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.android.com/reference/kotlin/androidx/health/connect/client/records/NutritionRecord"},"children":["NutritionRecord"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/dietaryenergyconsumed"},"children":["dietaryEnergyConsumed"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"labels":["iOS","Android","Flutter","React Native","Ionic Capacitor"]},"children":[{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"iOS"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"swift","content":"public enum SahhaSensor: String, CaseIterable {\n case gender\n case date_of_birth\n case sleep\n case steps\n case floors_climbed\n case heart_rate\n case resting_heart_rate\n case walking_heart_rate_average\n case heart_rate_variability_sdnn\n case heart_rate_variability_rmssd\n case blood_pressure_systolic\n case blood_pressure_diastolic\n case blood_glucose\n case vo2_max\n case oxygen_saturation\n case respiratory_rate\n case active_energy_burned\n case basal_energy_burned\n case total_energy_burned\n case basal_metabolic_rate\n case time_in_daylight\n case body_temperature\n case basal_body_temperature\n case sleeping_wrist_temperature\n case height\n case weight\n case lean_body_mass\n case body_mass_index\n case body_fat\n case body_water_mass\n case bone_mass\n case waist_circumference\n case stand_time\n case move_time\n case exercise_time\n case activity_summary\n case device_lock\n case exercise\n case energy_consumed\n}\n"},"children":["public enum SahhaSensor: String, CaseIterable {\n case gender\n case date_of_birth\n case sleep\n case steps\n case floors_climbed\n case heart_rate\n case resting_heart_rate\n case walking_heart_rate_average\n case heart_rate_variability_sdnn\n case heart_rate_variability_rmssd\n case blood_pressure_systolic\n case blood_pressure_diastolic\n case blood_glucose\n case vo2_max\n case oxygen_saturation\n case respiratory_rate\n case active_energy_burned\n case basal_energy_burned\n case total_energy_burned\n case basal_metabolic_rate\n case time_in_daylight\n case body_temperature\n case basal_body_temperature\n case sleeping_wrist_temperature\n case height\n case weight\n case lean_body_mass\n case body_mass_index\n case body_fat\n case body_water_mass\n case bone_mass\n case waist_circumference\n case stand_time\n case move_time\n case exercise_time\n case activity_summary\n case device_lock\n case exercise\n case energy_consumed\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Android"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"kotlin","content":"enum class SahhaSensor {\n gender,\n date_of_birth,\n sleep,\n steps,\n floors_climbed,\n heart_rate,\n resting_heart_rate,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n walking_heart_rate_average,\n\n @Deprecated(\n message = \"$IOS_ONLY. Please use heart_rate_variability_rmssd for Android instead\",\n replaceWith = ReplaceWith(\"heart_rate_variability_rmssd\"),\n level = DeprecationLevel.WARNING\n )\n heart_rate_variability_sdnn,\n heart_rate_variability_rmssd,\n blood_pressure_systolic,\n blood_pressure_diastolic,\n blood_glucose,\n vo2_max,\n oxygen_saturation,\n respiratory_rate,\n active_energy_burned,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n basal_energy_burned,\n total_energy_burned,\n basal_metabolic_rate,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n time_in_daylight,\n body_temperature,\n basal_body_temperature,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n sleeping_wrist_temperature,\n height,\n weight,\n lean_body_mass,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n body_mass_index,\n body_fat,\n body_water_mass,\n bone_mass,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n waist_circumference,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n stand_time,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n move_time,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n exercise_time,\n activity_summary,\n device_lock,\n exercise,\n energy_consumed\n}\n"},"children":["enum class SahhaSensor {\n gender,\n date_of_birth,\n sleep,\n steps,\n floors_climbed,\n heart_rate,\n resting_heart_rate,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n walking_heart_rate_average,\n\n @Deprecated(\n message = \"$IOS_ONLY. Please use heart_rate_variability_rmssd for Android instead\",\n replaceWith = ReplaceWith(\"heart_rate_variability_rmssd\"),\n level = DeprecationLevel.WARNING\n )\n heart_rate_variability_sdnn,\n heart_rate_variability_rmssd,\n blood_pressure_systolic,\n blood_pressure_diastolic,\n blood_glucose,\n vo2_max,\n oxygen_saturation,\n respiratory_rate,\n active_energy_burned,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n basal_energy_burned,\n total_energy_burned,\n basal_metabolic_rate,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n time_in_daylight,\n body_temperature,\n basal_body_temperature,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n sleeping_wrist_temperature,\n height,\n weight,\n lean_body_mass,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n body_mass_index,\n body_fat,\n body_water_mass,\n bone_mass,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n waist_circumference,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n stand_time,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n move_time,\n\n @Deprecated(\n message = IOS_ONLY,\n level = DeprecationLevel.WARNING\n )\n exercise_time,\n activity_summary,\n device_lock,\n exercise,\n energy_consumed\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Flutter"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"dart","content":"enum SahhaSensor {\n gender,\n date_of_birth,\n sleep,\n steps,\n floors_climbed,\n heart_rate,\n resting_heart_rate,\n walking_heart_rate_average,\n heart_rate_variability_sdnn,\n heart_rate_variability_rmssd,\n blood_pressure_systolic,\n blood_pressure_diastolic,\n blood_glucose,\n vo2_max,\n oxygen_saturation,\n respiratory_rate,\n active_energy_burned,\n basal_energy_burned,\n total_energy_burned,\n basal_metabolic_rate,\n time_in_daylight,\n body_temperature,\n basal_body_temperature,\n sleeping_wrist_temperature,\n height,\n weight,\n lean_body_mass,\n body_mass_index,\n body_fat,\n body_water_mass,\n bone_mass,\n waist_circumference,\n stand_time,\n move_time,\n exercise_time,\n activity_summary,\n device_lock,\n exercise,\n energy_consumed,\n}\n"},"children":["enum SahhaSensor {\n gender,\n date_of_birth,\n sleep,\n steps,\n floors_climbed,\n heart_rate,\n resting_heart_rate,\n walking_heart_rate_average,\n heart_rate_variability_sdnn,\n heart_rate_variability_rmssd,\n blood_pressure_systolic,\n blood_pressure_diastolic,\n blood_glucose,\n vo2_max,\n oxygen_saturation,\n respiratory_rate,\n active_energy_burned,\n basal_energy_burned,\n total_energy_burned,\n basal_metabolic_rate,\n time_in_daylight,\n body_temperature,\n basal_body_temperature,\n sleeping_wrist_temperature,\n height,\n weight,\n lean_body_mass,\n body_mass_index,\n body_fat,\n body_water_mass,\n bone_mass,\n waist_circumference,\n stand_time,\n move_time,\n exercise_time,\n activity_summary,\n device_lock,\n exercise,\n energy_consumed,\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"React Native"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"export enum SahhaSensor {\n gender = 'gender',\n date_of_birth = 'date_of_birth',\n sleep = 'sleep',\n steps = 'steps',\n floors_climbed = 'floors_climbed',\n heart_rate = 'heart_rate',\n resting_heart_rate = 'resting_heart_rate',\n walking_heart_rate_average = 'walking_heart_rate_average',\n heart_rate_variability_sdnn = 'heart_rate_variability_sdnn',\n heart_rate_variability_rmssd = 'heart_rate_variability_rmssd',\n blood_pressure_systolic = 'blood_pressure_systolic',\n blood_pressure_diastolic = 'blood_pressure_diastolic',\n blood_glucose = 'blood_glucose',\n vo2_max = 'vo2_max',\n oxygen_saturation = 'oxygen_saturation',\n respiratory_rate = 'respiratory_rate',\n active_energy_burned = 'active_energy_burned',\n basal_energy_burned = 'basal_energy_burned',\n total_energy_burned = 'total_energy_burned',\n basal_metabolic_rate = 'basal_metabolic_rate',\n time_in_daylight = 'time_in_daylight',\n body_temperature = 'body_temperature',\n basal_body_temperature = 'basal_body_temperature',\n sleeping_wrist_temperature = 'sleeping_wrist_temperature',\n height = 'height',\n weight = 'weight',\n lean_body_mass = 'lean_body_mass',\n body_mass_index = 'body_mass_index',\n body_fat = 'body_fat',\n body_water_mass = 'body_water_mass',\n bone_mass = 'bone_mass',\n waist_circumference = 'waist_circumference',\n stand_time = 'stand_time',\n move_time = 'move_time',\n exercise_time = 'exercise_time',\n activity_summary = 'activity_summary',\n device_lock = 'device_lock',\n exercise = 'exercise',\n energy_consumed = 'energy_consumed',\n}\n"},"children":["export enum SahhaSensor {\n gender = 'gender',\n date_of_birth = 'date_of_birth',\n sleep = 'sleep',\n steps = 'steps',\n floors_climbed = 'floors_climbed',\n heart_rate = 'heart_rate',\n resting_heart_rate = 'resting_heart_rate',\n walking_heart_rate_average = 'walking_heart_rate_average',\n heart_rate_variability_sdnn = 'heart_rate_variability_sdnn',\n heart_rate_variability_rmssd = 'heart_rate_variability_rmssd',\n blood_pressure_systolic = 'blood_pressure_systolic',\n blood_pressure_diastolic = 'blood_pressure_diastolic',\n blood_glucose = 'blood_glucose',\n vo2_max = 'vo2_max',\n oxygen_saturation = 'oxygen_saturation',\n respiratory_rate = 'respiratory_rate',\n active_energy_burned = 'active_energy_burned',\n basal_energy_burned = 'basal_energy_burned',\n total_energy_burned = 'total_energy_burned',\n basal_metabolic_rate = 'basal_metabolic_rate',\n time_in_daylight = 'time_in_daylight',\n body_temperature = 'body_temperature',\n basal_body_temperature = 'basal_body_temperature',\n sleeping_wrist_temperature = 'sleeping_wrist_temperature',\n height = 'height',\n weight = 'weight',\n lean_body_mass = 'lean_body_mass',\n body_mass_index = 'body_mass_index',\n body_fat = 'body_fat',\n body_water_mass = 'body_water_mass',\n bone_mass = 'bone_mass',\n waist_circumference = 'waist_circumference',\n stand_time = 'stand_time',\n move_time = 'move_time',\n exercise_time = 'exercise_time',\n activity_summary = 'activity_summary',\n device_lock = 'device_lock',\n exercise = 'exercise',\n energy_consumed = 'energy_consumed',\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Ionic Capacitor"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"enum SahhaSensor {\n gender = 'gender',\n date_of_birth = 'date_of_birth',\n sleep = 'sleep',\n steps = 'steps',\n floors_climbed = 'floors_climbed',\n heart_rate = 'heart_rate',\n resting_heart_rate = 'resting_heart_rate',\n walking_heart_rate_average = 'walking_heart_rate_average',\n heart_rate_variability_sdnn = 'heart_rate_variability_sdnn',\n heart_rate_variability_rmssd = 'heart_rate_variability_rmssd',\n blood_pressure_systolic = 'blood_pressure_systolic',\n blood_pressure_diastolic = 'blood_pressure_diastolic',\n blood_glucose = 'blood_glucose',\n vo2_max = 'vo2_max',\n oxygen_saturation = 'oxygen_saturation',\n respiratory_rate = 'respiratory_rate',\n active_energy_burned = 'active_energy_burned',\n basal_energy_burned = 'basal_energy_burned',\n total_energy_burned = 'total_energy_burned',\n basal_metabolic_rate = 'basal_metabolic_rate',\n time_in_daylight = 'time_in_daylight',\n body_temperature = 'body_temperature',\n basal_body_temperature = 'basal_body_temperature',\n sleeping_wrist_temperature = 'sleeping_wrist_temperature',\n height = 'height',\n weight = 'weight',\n lean_body_mass = 'lean_body_mass',\n body_mass_index = 'body_mass_index',\n body_fat = 'body_fat',\n body_water_mass = 'body_water_mass',\n bone_mass = 'bone_mass',\n waist_circumference = 'waist_circumference',\n stand_time = 'stand_time',\n move_time = 'move_time',\n exercise_time = 'exercise_time',\n activity_summary = 'activity_summary',\n device_lock = 'device_lock',\n exercise = 'exercise',\n energy_consumed = 'energy_consumed',\n}\n"},"children":["enum SahhaSensor {\n gender = 'gender',\n date_of_birth = 'date_of_birth',\n sleep = 'sleep',\n steps = 'steps',\n floors_climbed = 'floors_climbed',\n heart_rate = 'heart_rate',\n resting_heart_rate = 'resting_heart_rate',\n walking_heart_rate_average = 'walking_heart_rate_average',\n heart_rate_variability_sdnn = 'heart_rate_variability_sdnn',\n heart_rate_variability_rmssd = 'heart_rate_variability_rmssd',\n blood_pressure_systolic = 'blood_pressure_systolic',\n blood_pressure_diastolic = 'blood_pressure_diastolic',\n blood_glucose = 'blood_glucose',\n vo2_max = 'vo2_max',\n oxygen_saturation = 'oxygen_saturation',\n respiratory_rate = 'respiratory_rate',\n active_energy_burned = 'active_energy_burned',\n basal_energy_burned = 'basal_energy_burned',\n total_energy_burned = 'total_energy_burned',\n basal_metabolic_rate = 'basal_metabolic_rate',\n time_in_daylight = 'time_in_daylight',\n body_temperature = 'body_temperature',\n basal_body_temperature = 'basal_body_temperature',\n sleeping_wrist_temperature = 'sleeping_wrist_temperature',\n height = 'height',\n weight = 'weight',\n lean_body_mass = 'lean_body_mass',\n body_mass_index = 'body_mass_index',\n body_fat = 'body_fat',\n body_water_mass = 'body_water_mass',\n bone_mass = 'bone_mass',\n waist_circumference = 'waist_circumference',\n stand_time = 'stand_time',\n move_time = 'move_time',\n exercise_time = 'exercise_time',\n activity_summary = 'activity_summary',\n device_lock = 'device_lock',\n exercise = 'exercise',\n energy_consumed = 'energy_consumed',\n}\n"]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"android-uses-permission-important-info"},"children":["(Android) Uses Permission - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT INFO"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Specifying sensors for Android","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For every sensor you specify in ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," or ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]},", you need matching ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"uses-permission"},"children":[]}," values in your ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"AndroidManifest.xml"},"children":[]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"/docs/connect/sdk/installation/android#set-up-android-project"},"children":["View the Android Platform Setup guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the values do not match, you are likely to receive build errors and risk your app being rejected on the Google Play Store."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Also note:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SahhaSensor.device_lock"},"children":[]}," does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," require any ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"AndroidManifest.xml"},"children":[]}," permission declarations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you rely on native steps and sleep synchronisation, include ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"WRITE_STEPS"},"children":[]}," and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"WRITE_SLEEP"},"children":[]}," in addition to the read permissions."]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-android-manifest-for-and"},"children":["Example: Android manifest for ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"steps"},"children":[]}," and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"sleep"},"children":[]}]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"xml","content":"\n \n \n \n\n \n \n \n\n \n ...\n \n\n"},"children":["\n \n \n \n\n \n \n \n\n \n ...\n \n\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"explain-sensor-access-before-calling"},"children":["Explain sensor access before calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"configure()"},"children":[]}," and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"authenticate()"},"children":[]}," are complete, show a dedicated screen explaining:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which sensors are being requested"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Why they are needed for your use case"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How enabling them improves the app experience"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This gives users the right context before the system permission prompts appear and usually leads to a better opt-in rate than showing the native permission UI without explanation."]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-enable-sensors-screen"},"children":["Example: enable sensors screen"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownImage","attributes":{"src":"/images/sensor-ux/enable-sensors.png","alt":"Enable sensors screen"},"children":[]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-copy-for-your-permission-explainer-screen"},"children":["Example copy for your permission explainer screen"]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"text","content":"Title\nEnable health data collection\n\nBody\nWe use your steps, sleep, and heart rate data to personalise your daily\nhealth insights and show more accurate trends over time.\n\nWhy we ask\n- Steps help us understand movement patterns\n- Sleep helps us calculate recovery and routine\n- Heart rate adds extra context for effort and readiness\n\nPrimary CTA\nEnable Health Data\n\nSecondary CTA\nNot now\n"},"children":["Title\nEnable health data collection\n\nBody\nWe use your steps, sleep, and heart rate data to personalise your daily\nhealth insights and show more accurate trends over time.\n\nWhy we ask\n- Steps help us understand movement patterns\n- Sleep helps us calculate recovery and routine\n- Heart rate adds extra context for effort and readiness\n\nPrimary CTA\nEnable Health Data\n\nSecondary CTA\nNot now\n"]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Only request what you can clearly justify"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apple and Google are strict about sensitive permission use. Only request the sensors that directly support the features your app provides, and explain that value in plain language before calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"about-the-device-sensor-status"},"children":["About the device sensor status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sensors can have multiple possible statuses that indicate whether they are enabled, unavailable, or still pending."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," is the best way to determine whether collection is fully active. In a healthy onboarding flow, you should use it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["after the user finishes the permission prompt"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["on later app launches"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["after app updates that introduce new required sensors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["whenever you need to decide whether to show onboarding again or display a recovery banner"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A sensor set should only be treated as fully ready when ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," returns ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]},"."," ","In practice, that is the state where the required permissions are in place and the SDK collectors are running."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"labels":["iOS","Android","Flutter","React Native","Ionic Capacitor"]},"children":[{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"iOS"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"swift","content":"public enum SensorStatus: Int {\n case pending = 0 // Sensors pending (before prompting user for permission)\n case unavailable = 1 // Sensors not supported by user's device\n case disabled = 2 // Sensors disabled (after prompting user for permission)\n case enabled = 3 // Sensors enabled (after prompting user for permission)\n}\n"},"children":["public enum SensorStatus: Int {\n case pending = 0 // Sensors pending (before prompting user for permission)\n case unavailable = 1 // Sensors not supported by user's device\n case disabled = 2 // Sensors disabled (after prompting user for permission)\n case enabled = 3 // Sensors enabled (after prompting user for permission)\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Android"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"kotlin","content":"enum class SahhaSensorStatus {\n pending, // Sensors pending user permission\n unavailable, // Sensors not supported by the user's device\n disabled, // Sensors disabled by the user\n enabled // Sensors enabled by the user\n}\n"},"children":["enum class SahhaSensorStatus {\n pending, // Sensors pending user permission\n unavailable, // Sensors not supported by the user's device\n disabled, // Sensors disabled by the user\n enabled // Sensors enabled by the user\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Flutter"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"dart","content":"enum SahhaSensorStatus {\n pending, // Sensors pending user permission\n unavailable, // Sensors not supported by the user's device\n disabled, // Sensors disabled by the user\n enabled, // Sensors enabled by the user\n}\n"},"children":["enum SahhaSensorStatus {\n pending, // Sensors pending user permission\n unavailable, // Sensors not supported by the user's device\n disabled, // Sensors disabled by the user\n enabled, // Sensors enabled by the user\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"React Native"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"enum SahhaSensorStatus {\n pending = 0, // Sensors pending user permission\n unavailable = 1, // Sensors not supported by the user's device\n disabled = 2, // Sensors disabled by the user\n enabled = 3, // Sensors enabled by the user\n}\n"},"children":["enum SahhaSensorStatus {\n pending = 0, // Sensors pending user permission\n unavailable = 1, // Sensors not supported by the user's device\n disabled = 2, // Sensors disabled by the user\n enabled = 3, // Sensors enabled by the user\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Ionic Capacitor"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"enum SahhaSensorStatus {\n pending = 0, // Sensor data is pending user permission\n unavailable = 1, // Sensor data is not supported by the user's device\n disabled = 2, // Sensor data has been disabled by the user\n enabled = 3, // Sensor data has been enabled by the user\n}\n"},"children":["enum SahhaSensorStatus {\n pending = 0, // Sensor data is pending user permission\n unavailable = 1, // Sensor data is not supported by the user's device\n disabled = 2, // Sensor data has been disabled by the user\n enabled = 3, // Sensor data has been enabled by the user\n}\n"]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"i-os-permission-privacy-important-info"},"children":["(iOS) Permission Privacy - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT INFO"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Apple limits the ability to detect the true sensor status to protect user privacy","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apple documentation:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"To help protect the user’s privacy, your app doesn’t know whether the user granted or denied permission to read data from HealthKit. If the user denied permission, attempts to query data from HealthKit return only samples that your app successfully saved to the HealthKit store."},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This means that if a sensor is available, the only possible ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SensorStatus"},"children":[]}," values on iOS are usually:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"pending"},"children":[]}," if you have not already prompted the user for permission"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]}," if you have already prompted the user for permission"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"disabled"},"children":[]}," status is not triggered even if the user declines permission."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"disabled"},"children":[]}," status is only included in the iOS SDK to keep parity with the Android SDK."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"getting-the-device-sensor-status"},"children":["Getting the device sensor status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check the current status of a sensor set by calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]},". This method is asynchronous and returns the updated ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SahhaSensorStatus"},"children":[]}," in its callback."]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Configure the SDK before you get sensor status","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On app launch, ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SensorStatus"},"children":[]}," will always be ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"pending"},"children":[]}," until the SDK has been configured. You must call ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"configure()"},"children":[]}," before you can trust the result of ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We suggest calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," after configuration is complete. In most production onboarding flows, you should also make sure the user is authenticated before using the result to decide the next step."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"labels":["iOS","Android","Flutter","React Native","Ionic Capacitor"]},"children":[{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"iOS"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"swift","content":"// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus([SahhaSensor.steps, SahhaSensor.sleep]) { error, sensorStatus in\n if let error = error {\n print(error)\n } else if sensorStatus == .pending {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if sensorStatus == .enabled {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}\n"},"children":["// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus([SahhaSensor.steps, SahhaSensor.sleep]) { error, sensorStatus in\n if let error = error {\n print(error)\n } else if sensorStatus == .pending {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if sensorStatus == .enabled {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Android"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"kotlin","content":"// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus(\n this@MainActivity,\n setOf(SahhaSensor.steps, SahhaSensor.sleep)\n) { error, status ->\n if (error != null) {\n println(error)\n } else if (status == SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (status == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}\n"},"children":["// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus(\n this@MainActivity,\n setOf(SahhaSensor.steps, SahhaSensor.sleep)\n) { error, status ->\n if (error != null) {\n println(error)\n } else if (status == SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (status == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Flutter"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"dart","content":"// Get status of `steps` and `sleep` sensors\nSahhaFlutter.getSensorStatus(\n sensors: [SahhaSensor.steps, SahhaSensor.sleep],\n).then((value) {\n debugPrint('Sensor status: ${value.name}');\n setState(() {\n sensorStatus = value;\n });\n\n if (sensorStatus == SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (sensorStatus == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}).catchError((error, stackTrace) {\n debugPrint(error.toString());\n});\n"},"children":["// Get status of `steps` and `sleep` sensors\nSahhaFlutter.getSensorStatus(\n sensors: [SahhaSensor.steps, SahhaSensor.sleep],\n).then((value) {\n debugPrint('Sensor status: ${value.name}');\n setState(() {\n sensorStatus = value;\n });\n\n if (sensorStatus == SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (sensorStatus == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n}).catchError((error, stackTrace) {\n debugPrint(error.toString());\n});\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"React Native"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus(\n [SahhaSensor.steps, SahhaSensor.sleep],\n (error: string, value: SahhaSensorStatus) => {\n if (error) {\n console.error(`Error: ${error}`);\n } else {\n console.log(`Sensor Status: ${value}`);\n setSensorStatus(value);\n\n if (value === SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (value === SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n }\n);\n"},"children":["// Get status of `steps` and `sleep` sensors\nSahha.getSensorStatus(\n [SahhaSensor.steps, SahhaSensor.sleep],\n (error: string, value: SahhaSensorStatus) => {\n if (error) {\n console.error(`Error: ${error}`);\n } else {\n console.log(`Sensor Status: ${value}`);\n setSensorStatus(value);\n\n if (value === SahhaSensorStatus.pending) {\n // Sensors are NOT enabled and ready - show your custom UI before asking for user permission\n } else if (value === SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n }\n);\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Ionic Capacitor"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"javascript","content":"// Choose which sensors you want to check for your project\nconst sensors = [\n SahhaSensor.sleep,\n SahhaSensor.steps,\n SahhaSensor.floors_climbed,\n SahhaSensor.active_energy_burned,\n SahhaSensor.heart_rate,\n];\n\nSahha.getSensorStatus({ sensors }).then(\n function (response) {\n console.log(response.status);\n },\n function (error) {\n console.log(error);\n }\n);\n"},"children":["// Choose which sensors you want to check for your project\nconst sensors = [\n SahhaSensor.sleep,\n SahhaSensor.steps,\n SahhaSensor.floors_climbed,\n SahhaSensor.active_energy_burned,\n SahhaSensor.heart_rate,\n];\n\nSahha.getSensorStatus({ sensors }).then(\n function (response) {\n console.log(response.status);\n },\n function (error) {\n console.log(error);\n }\n);\n"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"enabling-device-sensors"},"children":["Enabling device sensors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before the SDK can start collecting data, you need to enable sensors by calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]},". This method is asynchronous and returns the updated ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"SahhaSensorStatus"},"children":[]}," in its callback."]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"use-a-button-important-info"},"children":["Use a button - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT INFO"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"ALWAYS use a button to enable sensors","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DO NOT"]}," call ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," inside app init code or inside ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"useEffect"},"children":[]}," / auto-run lifecycle code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," displays system UI for the user. If you call it on init, your user may be shown a permission popup immediately on every app launch."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This is poor user experience and may cause your app to be rejected by Apple or Google."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Always use ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," from a user action such as a button press on your signup screen, onboarding flow, or health-permission screen."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"labels":["iOS","Android","Flutter","React Native","Ionic Capacitor"]},"children":[{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"iOS"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"swift","content":"// ALWAYS use a button to enable sensors\nButton {\n\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors([SahhaSensor.steps, SahhaSensor.sleep]) { error, sensorStatus in\n if let error = error {\n print(error)\n } else if sensorStatus == .enabled {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n\n} label: {\n HStack {\n Spacer()\n Text(\"Enable Sensors\")\n Spacer()\n }\n}\n"},"children":["// ALWAYS use a button to enable sensors\nButton {\n\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors([SahhaSensor.steps, SahhaSensor.sleep]) { error, sensorStatus in\n if let error = error {\n print(error)\n } else if sensorStatus == .enabled {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n\n} label: {\n HStack {\n Spacer()\n Text(\"Enable Sensors\")\n Spacer()\n }\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Android"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"kotlin","content":"// ALWAYS use a button to enable sensors\nButton(onClick = {\n\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors(\n this@MainActivity,\n setOf(SahhaSensor.steps, SahhaSensor.sleep)\n ) { error, status ->\n if (error != null) {\n println(error)\n } else if (status == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n\n}) {\n Text(\"Enable Sensors\")\n}\n"},"children":["// ALWAYS use a button to enable sensors\nButton(onClick = {\n\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors(\n this@MainActivity,\n setOf(SahhaSensor.steps, SahhaSensor.sleep)\n ) { error, status ->\n if (error != null) {\n println(error)\n } else if (status == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n\n}) {\n Text(\"Enable Sensors\")\n}\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Flutter"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"dart","content":"// ALWAYS use a button to enable sensors\nElevatedButton(\n style: ElevatedButton.styleFrom(\n minimumSize: const Size.fromHeight(40),\n padding: const EdgeInsets.symmetric(horizontal: 40, vertical: 20),\n textStyle: const TextStyle(fontSize: 16),\n ),\n onPressed: () {\n // Enable `steps` and `sleep` sensors\n SahhaFlutter.enableSensors(\n sensors: [SahhaSensor.steps, SahhaSensor.sleep],\n ).then((value) {\n debugPrint('Sensor status: ${value.name}');\n setState(() {\n sensorStatus = value;\n });\n\n if (sensorStatus == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }).catchError((error, stackTrace) {\n debugPrint(error.toString());\n });\n },\n child: const Text('ENABLE SENSORS'),\n)\n"},"children":["// ALWAYS use a button to enable sensors\nElevatedButton(\n style: ElevatedButton.styleFrom(\n minimumSize: const Size.fromHeight(40),\n padding: const EdgeInsets.symmetric(horizontal: 40, vertical: 20),\n textStyle: const TextStyle(fontSize: 16),\n ),\n onPressed: () {\n // Enable `steps` and `sleep` sensors\n SahhaFlutter.enableSensors(\n sensors: [SahhaSensor.steps, SahhaSensor.sleep],\n ).then((value) {\n debugPrint('Sensor status: ${value.name}');\n setState(() {\n sensorStatus = value;\n });\n\n if (sensorStatus == SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }).catchError((error, stackTrace) {\n debugPrint(error.toString());\n });\n },\n child: const Text('ENABLE SENSORS'),\n)\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"React Native"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"// ALWAYS use a button to enable sensors\n {\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors(\n [SahhaSensor.steps, SahhaSensor.sleep],\n (error: string, value: SahhaSensorStatus) => {\n if (error) {\n console.error(`Error: ${error}`);\n } else {\n console.log(`Sensor Status: ${value}`);\n if (value === SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n }\n );\n }}\n/>\n"},"children":["// ALWAYS use a button to enable sensors\n {\n // Enable `steps` and `sleep` sensors\n Sahha.enableSensors(\n [SahhaSensor.steps, SahhaSensor.sleep],\n (error: string, value: SahhaSensorStatus) => {\n if (error) {\n console.error(`Error: ${error}`);\n } else {\n console.log(`Sensor Status: ${value}`);\n if (value === SahhaSensorStatus.enabled) {\n // Sensors are enabled and ready\n } else {\n // Sensors are disabled or unavailable\n }\n }\n }\n );\n }}\n/>\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Ionic Capacitor"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"html","content":"

\n \n

\n"},"children":["

\n \n

\n"]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"javascript","content":"// ALWAYS use a button to enable sensors\nwindow.enableSensors = () => {\n // Choose which sensors you want to enable for your project\n const sensors = [\n SahhaSensor.sleep,\n SahhaSensor.steps,\n SahhaSensor.floors_climbed,\n SahhaSensor.active_energy_burned,\n SahhaSensor.heart_rate,\n ];\n\n // Enable the sensors\n Sahha.enableSensors({ sensors }).then(\n function (response) {\n console.log(response.status);\n },\n function (error) {\n console.log(error);\n }\n );\n};\n"},"children":["// ALWAYS use a button to enable sensors\nwindow.enableSensors = () => {\n // Choose which sensors you want to enable for your project\n const sensors = [\n SahhaSensor.sleep,\n SahhaSensor.steps,\n SahhaSensor.floors_climbed,\n SahhaSensor.active_energy_burned,\n SahhaSensor.heart_rate,\n ];\n\n // Enable the sensors\n Sahha.enableSensors({ sensors }).then(\n function (response) {\n console.log(response.status);\n },\n function (error) {\n console.log(error);\n }\n );\n};\n"]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"i-os-sleep-sensor-important-info"},"children":["(iOS) Sleep Sensor - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT INFO"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Set up Sleep before using the sleep sensor","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the Sahha SDK to collect data from the ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"sleep"},"children":[]}," sensor, Sleep functionality must already be enabled by your user ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["before"]}," calling ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the HealthKit permission flow has not been shown yet and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," is still ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"pending"},"children":[]},", this is a good time to show custom UI that helps the user set up Sleep in the Health app before you request access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read more in Apple's setup guide:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"InlineLink","attributes":{"href":"https://support.apple.com/en-us/HT211685"},"children":["Sleep for iOS"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"prompt-the-user-if-sensors-are-not-enabled"},"children":["Prompt the user if sensors are not enabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users do not always enable every permission during onboarding. Also, later app releases may introduce new sensors that require extra access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," return ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]},", show an in-app banner or prompt that helps the user return to sensor setup."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A persistent in-app prompt is often the easiest way to recover from:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incomplete onboarding"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Previously denied permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Newly added sensors after an app update"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform-specific edge cases where expected data is still missing"]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-enable-sensors-banner"},"children":["Example: enable sensors banner"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownImage","attributes":{"src":"/images/sensor-ux/sensor-banner.png","alt":"Enable sensors banner"},"children":[]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-banner-copy"},"children":["Example banner copy"]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"text","content":"Title\nFinish enabling health access\n\nBody\nWe still need access to Steps and Sleep so we can keep your health insights up to date.\n\nPrimary action\nReview permissions\n\nSecondary action\nNot now\n"},"children":["Title\nFinish enabling health access\n\nBody\nWe still need access to Steps and Sleep so we can keep your health insights up to date.\n\nPrimary action\nReview permissions\n\nSecondary action\nNot now\n"]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-decision-logic-for-a-recovery-banner"},"children":["Example decision logic for a recovery banner"]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"text","content":"status = getSensorStatus(requiredSensors)\n\nif status != enabled:\n showBanner(\n title: \"Finish enabling health access\",\n action: \"Review permissions\"\n )\nelse:\n hideBanner()\n"},"children":["status = getSensorStatus(requiredSensors)\n\nif status != enabled:\n showBanner(\n title: \"Finish enabling health access\",\n action: \"Review permissions\"\n )\nelse:\n hideBanner()\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"offer-a-manual-permissions-recovery-flow"},"children":["Offer a manual permissions recovery flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to go the extra mile, provide a fallback flow that helps users manually verify and re-enable permissions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is especially helpful in two situations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the user is still having trouble enabling sensors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["on iOS, where the system may restrict your ability to know the exact read-permission state after the first permission flow"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In these cases, ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," may say ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]}," even though expected data is no longer arriving."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A practical recovery flow looks like this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," for the sensors your app depends on."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the status is ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]}," but expected data is still missing, make a lightweight verification request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If that request still returns no expected result, show a recovery banner or help screen."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Give the user a button that calls ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"openAppSettings()"},"children":[]},"."]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"example-verify-expected-data-after-permissions-look-enabled"},"children":["Example: verify expected data after permissions look enabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the method that matches the part of the product you are validating:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getStats()"},"children":[]}," if you want to verify raw sensor-driven daily stats such as steps or sleep"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getBiomarkers()"},"children":[]}," if your product depends on Sahha-generated biomarkers"]}]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"text","content":"status = getSensorStatus(requiredSensors)\n\nif status == enabled:\n stats = getStats(steps or sleep for a period you expect data to exist)\n\n if stats are missing:\n showManualPermissionRecoveryHelp()\n"},"children":["status = getSensorStatus(requiredSensors)\n\nif status == enabled:\n stats = getStats(steps or sleep for a period you expect data to exist)\n\n if stats are missing:\n showManualPermissionRecoveryHelp()\n"]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"guide-users-to-settings"},"children":["Guide users to settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your help screen can guide users to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open your app in system settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review Apple Health or Health Connect access for your app"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Re-enable the specific sensors your app requires"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the app and retry data collection"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"open-app-settings"},"children":["Open App Settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a user disables a sensor, or you need them to manually re-check their permissions, send them to settings with ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"openAppSettings()"},"children":[]},"."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"labels":["iOS","Android","Flutter","React Native","Ionic Capacitor"]},"children":[{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"iOS"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"swift","content":"Sahha.openAppSettings()\n"},"children":["Sahha.openAppSettings()\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Android"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"kotlin","content":"Sahha.openAppSettings(this@MainActivity)\n"},"children":["Sahha.openAppSettings(this@MainActivity)\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Flutter"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"dart","content":"SahhaFlutter.openAppSettings()\n"},"children":["SahhaFlutter.openAppSettings()\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"React Native"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"typescript","content":"Sahha.openAppSettings();\n"},"children":["Sahha.openAppSettings();\n"]}]},{"$$mdtype":"Tag","name":"Tab","attributes":{"label":"Ionic Capacitor"},"children":[{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"javascript","content":"Sahha.openAppSettings();\n"},"children":["Sahha.openAppSettings();\n"]}]}]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"i-os-permission-changes-important-info"},"children":["(iOS) Permission Changes - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT INFO"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"title":"Your app will terminate if iOS permissions change while it is backgrounded","type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the user enables or disables a Health permission from device settings while your app is in the background, iOS will force your app to terminate. This is intentional system behaviour and the app will need to be relaunched."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"platform-caveats-that-affect-real-world-data-collection"},"children":["Platform caveats that affect real-world data collection"]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"android-health-connect-availability"},"children":["Android: Health Connect availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Health Connect is available on Android 9 (API 28) and above. On Android 9 through Android 13, the user must install the Health Connect app. On Android 14 and above, Health Connect is built in."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a user cannot complete the permission flow on Android, check that Health Connect is available and installed before troubleshooting anything else."]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"historical-readback-limits"},"children":["Historical readback limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both Apple Health and Health Connect can only provide a limited amount of historical data before the first successful permission grant. If the app is later uninstalled and reinstalled, that read window resets from the new permission date."]},{"$$mdtype":"Tag","name":"h4","attributes":{"id":"example"},"children":["Example"]},{"$$mdtype":"Tag","name":"Fence","attributes":{"language":"text","content":"A user first grants permission on March 30, 2023.\nThe earliest readable data may be February 28, 2023 onward.\n\nThe user deletes the app on May 10, 2023.\nThey reinstall it and grant permission again on May 15, 2023.\nThe earliest readable data may now be April 15, 2023 onward.\n"},"children":["A user first grants permission on March 30, 2023.\nThe earliest readable data may be February 28, 2023 onward.\n\nThe user deletes the app on May 10, 2023.\nThey reinstall it and grant permission again on May 15, 2023.\nThe earliest readable data may now be April 15, 2023 onward.\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is important when validating onboarding because a fresh install may not immediately show older historical data you expected to see."]},{"$$mdtype":"Tag","name":"h3","attributes":{"id":"i-os-locked-device-restriction"},"children":["iOS: locked-device restriction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apple Health restricts reading data while the device is locked. Data recorded while the device is locked can become available after the user unlocks the phone again."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are testing overnight or background collection, remember that data availability may not update until after unlock."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"h2","attributes":{"id":"why-this-flow-matters"},"children":["Why this flow matters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This flow helps ensure the SDK is set up correctly and actually delivering data."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"configure()"},"children":[]}," connects the SDK to the correct environment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"authenticate()"},"children":[]}," associates the SDK with the correct user"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enableSensors()"},"children":[]}," requests the required health permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Code","attributes":{"content":"getSensorStatus()"},"children":[]}," confirms whether collection is ready"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If status is not ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"enabled"},"children":[]},", banners help repair incomplete permission states"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If status looks enabled but expected data is still missing, offer a manual recovery flow and ",{"$$mdtype":"Tag","name":"Code","attributes":{"content":"openAppSettings()"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When these pieces are implemented together, you get a much more reliable onboarding experience and a better chance of continuous data collection."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This order helps ensure the SDK is connected to the correct environment, associated with the correct user profile, and ready to start collecting the sensor data your product needs."]}]}

Health Data Permissions

App Store Submission

Scientific References