programming guide samsung health sdk for android helps samsung health's partners to share health data safely and to create useful health applications. samsung health has a health data store where its data can be shared with other partner apps after the user's consent. it supports android devices with marshmallow 6.0 including non-samsung devices. refer to the following table terms for samsung health sdk for android. term description health data framework it provides useful features to handle the user's health data. it is included in samsung health and its interface is provided with samsung health sdk for android. an app that uses the sdk works with samsung health. samsung health an application that helps monitor the user's activities and helps the users to have a healthier life through monitoring walking steps, exercise, heart rate, and etc. it can be downloaded from the app market like google play or galaxy apps. the term is italicized to be easily distinguished. health data framework the health data framework of samsung health sdk for android has the following features: health data store handling the connection to samsung health inserting, reading, updating, or deleting health data storing data based on unified units. see api reference's descriptions for each data type health data type platform-defined and custom data type privacy granting permission based on the user's consent to read or write the specific data type architecture the sdk's health data framework is designed to provide safe access of its data and to have a seamless health service to the user. the following figure shows the health data framework's architecture. health data framework the health data framework is included in samsung health. applications can access the user's data that are stored in samsung health through the sdk. it keeps the user's health data safely. health data from various source devices having pedometer, accelerator, or heart rate sensors are inserted to the health data framework with the unified data unit. the data can be read by the sdk. updating or deleting data is available if the app inserted the data. the figure above shows the class and interface relationships in health data. detailed descriptions for each class and interface are in the api reference. healthdatastore it handles the connection to the data storage of the device. it receives its connection result with healthdatastore.connectionlistener. most requests require the connection to the health data store. healthdataresolver the health data framework provides classes and interfaces to insert, read, update, or delete the data. healthdataresolver is a central class to handle the health data. it sends a data request with related request interfaces. the query result can be received immediately with healthdataholder.baseresult, healthdataresolver.readresult or healthdataresolver.aggregateresult. or it can be received asynchronously with healthresultholder.resultlistener. see health data store for more information. application developers can use platform-defined data types that samsung health sdk for android provides. see health data type for more information. especially healthconstants.common, the base interface of predefined data types, contains the following mandatory properties for health data. unique id of health data created and updated time of health data application package name device that provides health data the health data can be accessed with the user's consent. the following figure shows the relationship between classes and interfaces related to healthpermissionmanager. it requests permissions to the user with healthpermissionmanager.permissionkey to read or write for the specific health data type. the permission result can be received synchronous or asynchronously. see privacy for more information. the sdk's health data library provides the following package: com.samsung.android.sdk.healthdata main interfaces and classes in the library are described in the following table. see the api reference for details. interface / class description healthconnectionerrorresult this class handles errors for connection failure to the health data store. healthconstants this class defines constants of health data and contains interfaces for various kinds such as the step count or exercise. healthdata this class is an object for a health data type, e.g. the blood pressure or weight. quantitative and qualitative values can be defined for the specific health data type based on its data structure definition. it is used to manage health data with healthdataresolver. healthdataobserver this class defines an observer to handle health data changes. healthdataresolver this class accesses health data to insert, read, update, and delete with the filter and aggregate functions. healthdatastore this class handles the connection to the data store in the device. healthdataunit this class provides unified units for the health data store. healthdatautil this class provides useful utility apis. healthdevice this class contains detailed device information that provides health data. healthdevicemanager this class manages devices related health data. healthpermissionmanager this class requests permission to read or write health data for the specific health data type. healthresultholder this interface represents the result of invoking method. healthuserprofile this class provides the user information.

overview package class tree deprecated index com.samsung.android.sdk.healthdata class healthconnectionerrorresult java.lang.object com.samsung.android.sdk.healthdata.healthconnectionerrorresult public final class healthconnectionerrorresult extends object this class handles errors raised by connection failure to the health data store. considerations for connection failure a partner app works with samsung health. the partner app can meet the following error cases when it connects to samsung health. connection error description platform_not_installed samsung health is not installed. old_version_platform installed samsung health's version is old. platform_disabled samsung health is disabled. user_agreement_needed the user didn't agree to samsung health's terms & conditions and privacy policies. user_password_needed samsung health is locked by the user password. handling connection exceptions samsung health sdk for android helps you to handle all available error cases with healthconnectionerror when your application connects to the health data store. healthconnectionerror is retrieved in healthdatastore.connectionlistener's event handler and all samsung health's partner applications need to check the health data store's connection error mandatorily. the following example shows how to handle the connection error. public class mainactivity extends activity { private healthdatastore mstore; private healthconnectionerrorresult mconnerror; private static mainactivity minstance = null; @override public void oncreate(bundle savedinstancestate) { // ... mstore = new healthdatastore(this, mconnectionlistener); mstore.connectservice(); } @override public void ondestroy() { mstore.disconnectservice(); // ... } private final healthdatastore.connectionlistener mconnectionlistener = new healthdatastore.connectionlistener() { @override public void onconnected() { // connected } @override public void onconnectionfailed(healthconnectionerrorresult error) { // connection fails showconnectionfailuredialog(error); } @override public void ondisconnected() { // connection is disconnected } }; private void showconnectionfailuredialog(healthconnectionerrorresult error) { alertdialog.builder alert = new alertdialog.builder(this); mconnerror = error; if (mconnerror.hasresolution()) { switch(error.geterrorcode()) { case healthconnectionerrorresult.platform_not_installed: message = "please install samsung health"; break; case healthconnectionerrorresult.old_version_platform: message = "please upgrade samsung health"; break; case healthconnectionerrorresult.platform_disabled: message = "please enable samsung health"; break; case healthconnectionerrorresult.user_agreement_needed: message = "please agree to samsung health policy"; break; default: message = "please make samsung health available"; break; } } else { // in case that the device doesn't support samsung health, // hasresolution() returns false also. alert.setmessage(r.string.msg_conn_not_available); } alert.setpositivebutton(r.string.ok, (dialog, id) -> { if (error.hasresolution()) { error.resolve(mainactivity.this); } }); if (error.hasresolution()) { alert.setnegativebutton("cancel", null); } alert.show(); } } since: 1.0.0 see also: healthdatastore.connectionlistener field summary fields modifier and type field and description static int connection_failure the connection is not established in the health data framework. static int old_version_platform the version of the health data framework is outdated to cooperate with sdk. static int old_version_sdk the sdk's data library version is outdated to cooperate with the samsung health's health data framework. static int platform_disabled the health data framework is disabled. static int platform_not_installed samsung health is not installed. static int platform_signature_failure it fails to check the signature of the health data framework. static int timeout the connection time exceeded the limit. static int unknown unknown error. static int user_agreement_needed the user did not agree to terms and conditions, and privacy policy of samsung health yet. static int user_password_needed the user cancels the password input explicitly on the password pop-up window. method summary all methods instance methods concrete methods modifier and type method and description int geterrorcode() gets the error code of connection failure. boolean hasresolution() checks whether the given error has a resolution. void resolve(activity activity) resolves an error with an activity which is able to get the user's feedback for possible error cases. field detail unknown public static final int unknown unknown error. its constant value is 0. since: 1.0.0 see also: constant field values connection_failure public static final int connection_failure the connection is not established in the health data framework. its constant value is 1. since: 1.0.0 see also: constant field values platform_not_installed public static final int platform_not_installed samsung health is not installed. to resolve it: if your app runs on android 11, check your app manifest whether the "<queries>" element is added. see the app manifest guide. call resolve(android.app.activity). it leads the user to install samsung health on an app seller site. its constant value is 2. since: 1.0.0 see also: resolve(android.app.activity), constant field values old_version_sdk public static final int old_version_sdk the sdk's data library version is outdated to cooperate with the samsung health's health data framework. to resolve it: apply the latest data library to your app. if your app uses the latest data library, create an activity to update to install your latest app. its constant value is 3. since: 1.0.0 see also: constant field values old_version_platform public static final int old_version_platform the version of the health data framework is outdated to cooperate with sdk. to resolve it, call resolve(android.app.activity). it leads the user to install the latest samsung health on an app seller site. its constant value is 4. since: 1.0.0 see also: resolve(android.app.activity), constant field values timeout public static final int timeout the connection time exceeded the limit. its constant value is 5. since: 1.0.0 see also: constant field values platform_disabled public static final int platform_disabled the health data framework is disabled. to resolve it, call resolve(android.app.activity). it leads the user to activate samsung health through the phone's settings. its constant value is 6. since: 1.0.0 see also: resolve(android.app.activity), constant field values user_password_needed public static final int user_password_needed the user cancels the password input explicitly on the password pop-up window. some devices can request a password to protect the user's data. the password for the health data access can be registered in samsung health by the user. then the user can enter the password through the password pop-up window. if the predetermined time passed without the valid password input, timeout occurs. its constant value is 7. since: 1.0.0 see also: constant field values platform_signature_failure public static final int platform_signature_failure it fails to check the signature of the health data framework. its constant value is 8. since: 1.0.0 see also: constant field values user_agreement_needed public static final int user_agreement_needed the user did not agree to terms and conditions, and privacy policy of samsung health yet. the health data framework is not activated before agreement. to resolve it, call reslove. it leads the user to the samsung health's service agreement page. its constant value is 9. since: 1.0.0 see also: resolve(android.app.activity), constant field values method detail geterrorcode public int geterrorcode() gets the error code of connection failure. usually it is called in healthdatastore.connectionlistener.onconnectionfailed(healthconnectionerrorresult). it's required to resolve the error depending on its returned error code. returns: the error code since: 1.0.0 hasresolution public boolean hasresolution() checks whether the given error has a resolution. whether the device supports samsung health the sdk supports marshmallow and above android devices including non-samsung devices. and it works with samsung health. there is no connection issue on most devices but it is not available occasionally depending on the device's specification. this api lets you know whether the device supports samsung health. the returned false involves that the device is not available for samsung health. precondition: check the network connection. permission: android.permission.internet returns: true if the platform provides a resolution for the error. call resolve(activity). false in the following cases: if the device doesn't support samsung health if there is no resolution for the error since: 1.0.0 resolve public void resolve(activity activity) resolves an error with an activity which is able to get the user's feedback for possible error cases. it handles the following errors and operations. show a proper message for each error case in your application before call this method. error operation platform_not_installed linked to the application installation page old_version_platform linked to the application installation page platform_disabled linked to settings of the device to turn on samsung health user_agreement_needed linked to the starting screen of samsung health to get the user's agreement precondition: check the network connection. permission: android.permission.internet parameters: activity - an activity which resolves the error with the user's feedback. usually it's the main activity of your application. throws: illegalargumentexception - if the specified input is null or invalid since: 1.0.0

samsung health sdk for device samsung health provides a feature that allows users to discover compatible health devices. many health devices are bluetooth enabled and this is the primary method of interfacing with samsung health. the samsung health device sdk defines bluetooth low energy (ble) compatible guidelines and samsung health specifications based on bluetooth generic attributes (gatt), including service structure, to connect with samsung health. ble compatible guidelines include the data communication flows defined in ble standard specs that samsung health requires. through a wide variety of compatible health devices, users can sync data related to blood glucose levels, blood pressure, heart rate, and weight with samsung health. additionally, samsung health provides data flows and specifications for forthcoming supported services including pedometers and exercise and sleep monitors, which are not covered in standard ble specs. these standards are set forth in a familiar structure to standard ble standard specs, allowing device venders to easily adapt to the specifications. samsung health provides an easy interface to connect ble health devices as well as manage health data from these health devices. users will be able to measure and record their health history and enhance their experience by taking advantage of the many services provided through samsung health. upon approval, partners can use the “compatible with samsung health” seal on their devices or packaging. partner devices program samsung health supports various health and fitness accessories and equipment with support for connectivity protocols including ant and ble. connecting your ble device with samsung health sdk for device requires a partnership. note : we are currently going through an update to better support our partners. for that reason, we will not be accepting any applications for the partner devices program at this time.

release note introduction release date: nov 3, 2020 release contents content description libraries libraries to sync health data with samsung health sample sample app codes with simplehealth, stepdiary, and foodnote tool dataviewer to test a created app documents api reference, programming guide change history jan 14, 2021 service package removal from samsung health v6.15, the service package doesn't work. the data library is not changed. nov 3, 2020 data 1.5.0 [changes] data library the data library is provided with 'aar' from 1.5.0. compatible samsung health version samsung health 6.12 or above works with the data package 1.5.0. data types "com.samsung.shealth.step_daily_trend" is defined with a new interface. use healthconstants.stepdailytrend instead of it. the new interface doesn't affect to existing apps that use "com.samsung.shealth.step_daily_trend". vo2_max is added to healthconstants.exercise. data viewer tool removing electrocardiogram and healthdocument from a data type list. [deprecation] healthconstants.electrocardiogram is deprecated. august 7, 2020 [changes] developer mode from samsung health 6.11, the developer mode needs a dev access key. see developer mode guide. data viewer tool dataviewer is updated with reading data only. stepdiary sample app it is provided with kotlin. june 22, 2020 service package - deprecated the service package is deprecated. do not use this feature any more. nov 28, 2019 service 1.4.0 [android 10 support] in samsung health 6.8, trackermanager.startactivity() is updated for android 10 to work well even samsung health is on the background. [deprecation] the following trackers are deprecated in trackermanager.trackerid. spo2 thermo_hygrometer uv apr 11, 2019 data 1.4.0 [important notice] data 1.4.0 library includes important changes. all partner app must use this version until july 2019. otherwise, your app will do not work with samsung health properly. it supports security enhancements in android 8.0. applications that target android 9 or higher cannot share data with other applications using socket. it works with samsung health 6.2 or above. healthconnectionerrorresult.old_version_platform must be handled to install the latest samsung health. update your app by applying all changes below to make a seamless service. [new] healthconstants.nutrition a nutrition data type is added. replace healthconstants.foodinfo & healthconstants.foodintake to healthconstants.nutrition. they will be removed in the next release. [deprecation & behavior changes] healthdataservice is deprecated. call just healthdatastore.connectservice() without after calling healthdataservice.initialize(). remove sdk-v1.0.0.jar. healthuserprofile’s some apis are deprecated and have a behavior change. getuserid() is not valid anymore. its behavior is changed to return an empty string for privacy policy enhancement. it will be removed in the next release. getimage() is not valid anymore. its behavior is changed to return null for privacy policy enhancement. it will be removed in the next release. healthdataresolver's inserting and updating data apis have a behavior change: `healthdataresolver.insert()` <br> `healthdataresolver.update()` <br> `healthdataresolver.insertwithpermission()` - `illegalargumentexception` is returned only if the request contains invalid instance type. - check the result with `getstatus()` of `healthresultholder.baseresult`. a data validation error is received as `status_invalid_input_data` in `healthresultholder.resultlistener.onresult()`. the data validation includes missing mandatory fields, wrong field type, out of the data value range and oversized blob. - see its [example](https://img-developer.samsung.com/onlinedocs/health/android/data/com/samsung/android/sdk/healthdata/healthdataresolver.insertrequest.html). [sample & tool update] sample apps foodnote is updated as replacing healthconstants. healthconstants.foodinfo and healthconstants.foodintake to healthconstants.nutrition. stepdiary's typo is fixed. dataviewer a data type list is updated with healthconstants.nutrition. healthconstants.foodinfo and healthconstants.foodintake is dropped out. sep 13, 2018 service 1.3.1 trackermanager.destination reward destination is deprecated. it goes to an error page from samsung health 6.0. trackertile setting date and content color in a tracker tile is not available from samsung health 6.0. setdate() is deprecated. setcontentcolor() is deprecated. tracker design guide is updated. may 25, 2018 data 1.3.0 daily step count trend ("com.samsung.shealth.step_daily_trend") "1" and "2" source type values that indicate wearable and activity trackers are deprecated. see deprecated info here. the data library is same. jan 11, 2018 data 1.3.0 healthconstants.foodinfo deprecated as he data library is same. do not use it any more. it will be removed. healthconstants.foodintake food_info_id is deprecated. oct 26, 2017 service 1.3.0 trackermanager.trackerid added. the existing fields for samsung health's trackers are deprecated. use the new class fields. jumping to a tracker's specific destination like trends is available. trackermanager.destination added. a new startactivity() api that has a destination param is added to trackermanager. sample app is updated to sampleservice. for more detailed information, refer to here. oct 17, 2017 the sdk name became "samsung health android sdk". aug 24, 2017 dataviewer tool is updated. a minor defect is patched. jul 27, 2017 data 1.3.0 new data types supported data types are added including floors climbed and health document. instant permission instant permission apis to handle health document are added. some properties are added: healthconstants.common: custom healthconstants.exercise: additional, max_rpm healthconstants.heartrate: min, max, binning_data healthconstants.weight: body_fat_mass, fat_free, fat_free_mass, skeletal_muscle_mass, total_body_water healthdata apis to handle inputstream are added. setlocaltimerange() is added to handle the local time zone change easily. healthdataresolver.aggregaterequest.builder healthdataresolver.readrequest.builder iterator() and close() are added to healthdataresolver.aggregateresult. more health data units are added. healthdatautil class is added. a new sample app stepdiary is added. the dataviewer tool is updated. more supported data types are added. the user interfaces are improved. for more detailed information, refer to here. apr 27, 2017 some terms are changed: "s health" app name is rebranded to "samsung health". "samsung health sdk" is used for the sdk’s name instead of "samsung digital health sdk". only the library names are changed according to the sdk naming. you don’t need to update your app. sample apps are updated by the changed terms. related documents are updated by the changed terms. jun 23, 2016 service 1.2.0 apis for the feature availability check are added in the shealth class. feature_tracker_launch feature_tracker_tile isfeatureenabled(int...) shealth.isfeatureenabled(int) was the default implementation and didn't work. it is updated to check the feature availability. to launch the s health’s specific tracker with trackerinfo and trackermanager, s health 4.8 or above is needed. feb 25, 2016 data 1.2.1 a new meal type, meal_type_before_sleep is added to healthconstants.bloodglucose. mean_rpm is added to healthconstants.exercise. in 1.2.0, healthconnectionerrorresult.unknown had been retrieved when s health prior to 4.6 is installed on the device. in this release, a bug for the wrong error value is fixed to give healthconnectionerrorresult.old_version_platform. you can solve the error situation by calling healthconnectionerrorresult.resolve(). the following apis are deprecated: healthresultholder.cancel() healthresultholder.baseresult.status_canceled nov 26, 2015 data 1.2.0 healthdevapp is removed. use dataviewer to test your application. "com.samsung.android.health.platform_type" in manifest to use healthdevapp is not required. to make a clear operation after the permission ui is popped up, the existing permissionmanager.requestpermissions() is deprecated. use new api with the activity parameter instead of it. connectservice() with the timeout parameter is added to healthdatastore. healthconstants.sleepstage to present detailed sleep data is added. body fat, skeletal muscle, muscle mass, and basal metabolic rate properties are added to healthconstants.weight. the minimum heart rate property is added to healthconstants.exercise. the user name and user’s picture image can be retrieved through healthuserprofile. for more detailed information, refer to here. service 1.1.0 s health simulator is removed from the sdk tool because s health’s available devices had been expanded. shealth.initialize() doesn’t throw ssdkunsupportedexception and securityexception. com.samsung.android.providers.context.permission.write_use_app_feature_survey permission is not required. the title of tile design guidelines is changed to tracker design guidelines. jun 18, 2015 data 1.1.0 sample application projects are updated to import them on android studio. healthconnectionerrorresult the device that supports s health 4.x can be checked with hasresolution(). hasresolution() and resolve() require the android.permission.internet permission. healthconstants.bloodglucose meal_type before_meal and meal_type general are added. meal_type_after_bedtime is deprecated. "treadmill" and "elliptical trainer" are added to the predefined type of healthconstants.exercise. putnull() to set a value of data property as null is added to healthdata. available ranges or operations of some apis are changed. for more detailed information, refer to here. mar 31, 2015 data 1.0.0 healthconnectionerrorresult.resolve()'s operation is changed without a dialog. some constants for unit are added and descriptions of healthconstants interfaces are changed. if the handler parameter of the healthdataobserver’s constructor is null, the looper of the current thread will be used for the callback. a permissible range of medical data for countries is expanded. for more detailed information, refer to here. service 1.0.0 guide for trackereventlistener is supplemented. check your application after referring to the api reference and programming guide. description of tile design guideline for tracker is supplemented. the icon size of tracker_tile_type_1 is changed to 60. known issues none features health data store handles the service connection. inserts, reads, updates and deletes health data. health data type predefined data types such as counting steps or nutrition. data permission checks and requests permissions to handle health data.

overview samsung health stack is an open-source technology stack offering end-to-end solutions for collecting and analyzing data from wearable devices in android and wear os environments. with applications ranging from medical research to clinician services and beyond, this tech stack provides the tools and infrastructure necessary to expedite the development and deployment of health-based studies. the framework includes: samsung health stack app sdk: a software development kit for building android and wear os apps capable of collecting data from wearable devices. web portal: a customizable interface for creating surveys, managing team members, tracking participants, and analyzing data. backend services: api endpoints to access and interact with a robust data engine. the galaxy watch 5 has been extensively tested for compatibility with this tech stack. other devices may work but have not been officially tested. you can start by installing the components of the tech stack. here are the links to the installation guides: installing the backend system installing the app sdk installing the web portal samsung health stack app sdk the app sdk simplifies the creation of mobile apps that collect data from participants. it provides building blocks for participant onboarding and consent, survey presentation, participant task creation, visual reporting, and data management. for further details, please check sdk documentation web portal the web portal is a dashboard for interactive data visualization and study management. it offers a platform for managing research team members, creating and deploying app content such as participant surveys, tracking study participant activity, and analyzing participant data. please note, as of now, chrome is the only browser supported for accessing the web portal. backend services the backend services provide a set of api endpoints for data storage, retrieval, and analysis. this allows your application to interact with the data engine, performing operations as needed. for more details, visit the rest api documentation. how does it all fit all together? contributing as an open-source project, samsung health stack welcomes contributions from the developer community. if you'd like to contribute, check out contributing to the open source project. samsung health stack strives to make the process of creating and managing health studies more efficient and accessible. through its comprehensive suite of tools and services, it serves as a robust foundation for health-based projects.

samsung health sdk for device samsung health sdk for device includes bluetooth low energy (ble) compatible guidelines and samsung health specifications based on bluetooth generic attributes (gatt), including service structure, to connect with samsung health. what can be done with samsung health sdk for device? connect various ble compatible health devices to samsung health, enabling data synchronization and expansion into upcoming supported services, offering a straightforward guide for device integration. view overview connect compatible health devices samsung health provides users with the ability to connect to a wide range of ble devices, including those capable of syncing data like blood glucose, blood pressure, heart rate, and weight, with prospective expansion to devices such as pedometers, exercise sensors, and sleep monitors, all to offer users comprehensive health data management. featured partners technical support submit ticket submit a technical support ticket for any questions you may have regarding the samsung health sdks. samsung account sign-in is required.

hello health data the following sections give you fundamentals for developing the samsung health's partner app. check first the development environment for samsung health's partner apps. importing library add the following library to the “libs” folder in your created application project. samsung-health-data-a.b.c.aar health data store connection add a <queries> element in your app manifest. <manifest . . . > <queries> <package android:name="com.sec.android.app.shealth" /> </queries> </manifest> connect to the health data store with healthdatastore. public class mainactivity extends activity { public static final string app_tag = "simplehealth"; private static mainactivity minstance = null; private healthdatastore mstore; private healthconnectionerrorresult mconnerror; private set<permissionkey> mkeyset; @override public void oncreate(bundle savedinstancestate) { // ... minstance = this; mkeyset = new hashset<permissionkey>(); mkeyset.add(new permissionkey(healthconstants.stepcount.health_data_type, permissiontype.read)); // create a healthdatastore instance and set its listener mstore = new healthdatastore(this, mconnectionlistener); // request the connection to the health data store mstore.connectservice(); } you can end the health data store connection when the activity is destroyed. @override public void ondestroy() { mstore.disconnectservice(); super.ondestroy(); } the connection result is sent to healthdatastore.connectionlistener. if it succeeds, acquiring data permission or querying data will be available. private final healthdatastore.connectionlistener mconnectionlistener = new healthdatastore.connectionlistener() { @override public void onconnected() { log.d(app_tag, "health data service is connected."); healthpermissionmanager pmsmanager = new healthpermissionmanager(mstore); try { // check whether the permissions that this application needs are acquired // request the permission for reading step counts if it is not acquired // get the current step count and display it if data permission is required // ... } catch (exception e) { log.e(app_tag, e.getclass().getname() + " - " + e.getmessage()); log.e(app_tag, "permission setting fails."); } } @override public void onconnectionfailed(healthconnectionerrorresult error) { log.d(app_tag, "health data service is not available."); showconnectionfailuredialog(error); } @override public void ondisconnected() { log.d(app_tag, "health data service is disconnected."); } }; the connection to the health data store can fail and you can check its error result through onconnectionfailed(). if there is an error, an application checks whether the health framework provides a solution with hasresolution() and calls resolve(). if the health framework provides its solution, resolve() makes an application move to one of the following page without a dialog message: app market's samsung health page to install or update it device's settings page to make samsung health available samsung health user's agreement page an application needs to show a proper message for each error case and call resolve(). private void showconnectionfailuredialog(healthconnectionerrorresult error) { alertdialog.builder alert = new alertdialog.builder(this); mconnerror = error; string message = "connection with samsung health is not available"; if (mconnerror.hasresolution()) { switch(error.geterrorcode()) { case healthconnectionerrorresult.platform_not_installed: message = "please install samsung health"; break; case healthconnectionerrorresult.old_version_platform: message = "please upgrade samsung health"; break; case healthconnectionerrorresult.platform_disabled: message = "please enable samsung health"; break; case healthconnectionerrorresult.user_agreement_needed: message = "please agree with samsung health policy"; break; default: message = "please make samsung health available"; break; } } alert.setmessage(message); alert.setpositivebutton("ok", new dialoginterface.onclicklistener() { @override public void onclick(dialoginterface dialog, int id) { if (mconnerror.hasresolution()) { mconnerror.resolve(minstance); } } }); if (error.hasresolution()) { alert.setnegativebutton("cancel", null); } alert.show(); } see the health data store for more information. permission request the meta-data element for the required data permission value in manifest works with the permission request api. if you want to request data permission for reading the step count, write its value in your application project's manifest as the following example. see privacy check flow in privacy. <application <meta-data android:name="com.samsung.android.health.permission.read" android:value="com.samsung.health.step_count" /> </application> create a permission key set and add a permission key for reading the step count. public class mainactivity extends activity { private set<permissionkey> mkeyset; @override public void oncreate(bundle savedinstancestate) { // ... mkeyset = new hashset<permissionkey>(); mkeyset.add(new permissionkey(healthconstants.stepcount.health_data_type, permissiontype.read)); // connect to health data store } and call healthpermissionmanager.requestpermissions() with its listener. private final healthdatastore.connectionlistener mconnectionlistener = new healthdatastore.connectionlistener() { @override public void onconnected() { log.d(app_tag, "health data service is connected."); healthpermissionmanager pmsmanager = new healthpermissionmanager(mstore); try { // check whether the permissions that this application needs are acquired map<permissionkey, boolean> resultmap = pmsmanager.ispermissionacquired(mkeyset); if (resultmap.containsvalue(boolean.false)) { // request the permission for reading step counts if it is not acquired pmsmanager.requestpermissions(mkeyset, mainactivity.this).setresultlistener(mpermissionlistener); } else { // get the current step count and display it // ... } } catch (exception e) { log.e(app_tag, e.getclass().getname() + " - " + e.getmessage()); log.e(app_tag, "permission setting fails."); } } // ... }; if requestpermissions() is called successfully, the permission ui is popped up to the user. the user's permission information is saved by selecting "done" after the user allows each data permission. and it is received through healthresultholder.resultlistener. private final healthresultholder.resultlistener<permissionresult> mpermissionlistener = new healthresultholder.resultlistener<permissionresult>() { @override public void onresult(permissionresult result) { log.d(app_tag, "permission callback is received."); map<permissionkey, boolean> resultmap = result.getresultmap(); if (resultmap.containsvalue(boolean.false)) { // requesting permission fails } else { // get the current step count and display it } } }; } see the health permission manager for more information.

samsung health stack open-source tech stack providing end-to-end solutions for collecting and analyzing research and clinical data. what can be done with samsung health stack? samsung health stack is an open-source toolset that provides end-to-end solutions for various medical research and clinician service use cases on android and wear os devices. it includes the app sdk, web portal, and a system to support backend services through api endpoints. view overview build, configure, and scale research studies samsung health stack caters to various application scenarios, including basic health-tracking apps and more intricate health and wellness solutions. samsung research toolkit prioritizes the end-user experience, enabling developers to design intuitive, user-friendly, and visually appealing health and wellness applications. by utilizing the pre-built modules of the app sdk, developers can save time and resources while customizing user interfaces to align perfectly with their brand's visual identity. participant app sdk the app sdk provides developers with highly customizable building blocks to create apps that collect participant data, such as onboarding, consent flow, surveys and tasks, and data visualization. learn more research study portal the web portal provides a ui portal customized to researchers' needs. it includes features for managing team members, creating and deploying app content, tracking consenting participants' activity, and analyzing data. learn more featured partners frequently asked questions go to faq find the most frequently asked questions about samsung health stack. technical support submit ticket submit a technical support ticket for any questions you may have regarding the samsung health sdks. samsung account sign-in is required.

note : for android 11 (targetsdkversion 30), please add a <queries> element for the samsung health app in your app manifest. see hello health data for more details. note : there is a known issue that causes the health data permission to be removed after updating samsung health to version 6.19. if your app is affected by this, please guide the user to allow the permissions on your app again and update the samsung health app to the latest version. the issue has been solved in version 6.19.5. samsung health sdk for android samsung health sdk for android enables sharing health data between samsung health running on android phones and partner apps. it also enables partner apps to use samsung health's tracker feature through app creation with the sdk. samsung health's partner apps can provide their users with additional services with samsung health sdk for android. the sdk provides secure access to samsung health data with applicable data types. data sharing, however, is enabled only after the user's explicit consent. the user can select detailed data sharing settings including which partner app will access the user's data, and which data type will be read or written. furthermore, a partner app can launch a samsung health's tracker and define its own tracker tile. samsung health sdk for android provides the health data features. health data health data has the following features: health data store samsung health sdk for android keeps users' health data secured. the health data store handles the service connection. it facilitates reading samsung health's data or writing the partner's health data to samsung health. health data type it provides useful data types. each data type is designed to contain a given health data type's information. it is used to access the data in health data store. permissions and user controls the user's health data are sensitive information. handling data with the sdk is only available with the user's explicit consent. health data provides a unified user interface and gives the user control of the data sharing settings easily for each data type. partner apps program partner app program is an exclusive service for samsung health that allows users to discover engaging health and fitness applications. note : we are currently going through an update to better support our partners. for that reason, we will not be accepting any applications for the partner apps program at this time. sdk download after having a partnership with samsung health, download samsung health sdk for android and create your app. samsung health sdk for android | data (v1.5.0) nov 3, 2020 (1.62mb) connection design guide samsung health's partner apps connect to samsung health with samsung health sdk for android. unified interfaces in partner apps seamlessly connect with samsung health to provide uninterrupted user experience to the users. for the best result, please see connection design guide. notification of samsung health connection the launch screen of a partner app, event pop-up, or information space is a good approach to notify users of connecting with samsung health. a partner app needs to inform users with as concrete description and information as possible. menu for connecting to samsung health a partner app should provide a menu with a convenient interface for the user to change the data sync setting with samsung health. samsung health name & icon samsung health's name and its icon should be used properly in a partner app. restrictions samsung health android sdk requires samsung health installation. the latest sdk works with samsung health 6.12 or above. see the sdk and samsung health’s compatible versions here. samsung health runs on devices with android 8.0 oreo (api level 26) or above. it is available on all samsung smartphones and also non-samsung android smartphones. an app’s targetsdkversion that uses samsung health sdk for android should be 26 or above. the sdk provides apis to check whether the device supports the sdk. see faq for more information.

samsung health sdks leverage our health platform to develop powerful health applications for your galaxy watch or smartphone. samsung privileged health sdk samsung privileged health sdk samsung health stack samsung health stack samsung health sdk for device samsung health sdk for device accelerate innovation and research in health and wellness with samsung's new health sdks samsung's health sdks enable a broad ecosystem of partners to accelerate innovation and solution development in health and wellness. as galaxy watch sensors and capabilities improve, you can, with user consent, integrate health data from galaxy watch and smartphones into your existing applications and platforms, as well as create innovative and powerful new products that enhance users' well-being through health insights. for developing health-sensing apps using advanced sensors samsung privileged health sdk is a software platform that enables the medical community and digital health solution providers to harness the power of galaxy watch’s advanced sensors; providing both raw sensor signal data and processed data with our differentiated features. learn more request partnership for medical and clinical research studies samsung health stack encompasses open-source tools, applications, and services to ease running, managing, and analyzing medical research studies and clinician services that involve wearable devices in the android and wearos environment. learn more for connecting with compatible bluetooth low energy (ble) devices samsung health device sdk defines ble compatible guidelines and samsung health specifications based on bluetooth generic attributes (gatt), including service structure, to connect with samsung health. learn more for synchronizing data through health connect api samsung and google have collaboratively built a unified health platform that provides a simple and secure way to exchange health data between android apps. samsung health synchronizes its data with health connect, including steps, exercise, heart rate, and sleep. learn more learn how to use the samsung health sdks learn about using the samsung health sdks to implement useful features with our sample apps on code lab. go to code lab get technical support submit a technical support ticket for any questions you may have regarding the samsung health sdks. samsung account sign-in is required. go to technical support publications read our latest publications on samsung r&d health discover samsung digital healthcare technology solutions, including hospital technology, healthcare data security for mobile devices, and more. go to publications news and blogs press release samsung developers conference, digital health, together for tomorrow samsung electronics announces sdc23 bringing developers together for tomorrow at sdc23, samsung will highlight platform innovation including smartthings, bixby, knox and tizen. this focus will illustrate ways samsung’s various business areas and devices are expanding seamless customer experiences. in addition, the company will share its cooperation plan and open innovation strategies with developers and partners to build next-generation connected experiences for millions around the world. press release galaxy unpacked'23, galaxy wearable, digital health samsung galaxy watch6 and galaxy watch6 classic: inspiring your best self, day and night with the new galaxy watch6 and galaxy watch6 classic, we are delivering on our commitment to democratize advanced health monitoring tools, now offering easier access right from the wrist,” said tm roh, president and head of mobile experience at samsung electronics. “from sleep and fitness coaching to nutritional insights, samsung is providing new and convenient ways to help users gain understanding and take action for better health and wellness, every day and every night. press release ihrn, watch os, galaxy wearable samsung brings irregular heart rhythm notification to galaxy watch in 13 markets samsung electronics today announced that the irregular heart rhythm notification (ihrn) feature1 on the samsung health monitor app2 will soon be available in 13 markets starting this summer. combined with the app’s blood pressure3 and electrocardiogram (ecg)4 monitoring, the ihrn feature detects heart rhythms suggestive of atrial fibrillation (afib), helping galaxy watch users understand their heart health more comprehensively.” looking for a developer community? meet other developers, ask questions, and find the answers you are looking for go to developer forum