Search

Filter

Docs 44
Sorry, no results
found for "Health Service" on the website

Learn Code Lab

codelab

Track Deadlift Exercise on Galaxy Watch

track deadlift exercise on galaxy watch objective create a native app for galaxy watch, operating on wear os powered by samsung, using health services to track deadlift exercise this app measures repetition count, calories burned, and time spent during the exercise overview health services provides a simple and unified way for accessing a wide range of health and wellness related data with health services api, you will no longer need to develop your own algorithms processing sensors data in order to compute metrics like heart rate, steps counts, distance, calories burned, and other more these are now accessible through health services embedded on wearables operating on wear os powered by samsung see health platform descriptions for detailed information set up your environment you will need the following galaxy watch4 or newer android studio latest version recommended java se development kit jdk 11 or later sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! health track deadlift sample code 132 83 kb turn on developer mode and adjust its settings on your watch, go to settings > about watch > software and tap on software version 5 times upon successful activation of developer mode, a toast message will display as on the image below afterwards, developer options will be visible under settings tap developer options and enable the following options adb debugging debug over wi-fi turn off automatic wi-fi connect your galaxy watch to wi-fi go to settings > connection > wi-fi and make sure that wi-fi is enabled from the list of available wi-fi networks, choose and connect to the same one as your pc when successfully connected, tap a wi-fi network name, swipe down, and note the ip address you will need this to connect your watch over adb from your pc connect your galaxy watch to android studio in android studio, go to terminal and type adb connect <ip address as mentioned in previous step> when prompted, tap always allow from this computer to allow debugging upon successful connection, you will see the following message in android studio’s terminal connected to <ip address of your watch> now, you can run the app directly on your watch start your project after downloading the sample code containing the project files, open your android studio and click open to open an existing project locate the downloaded android project deadlift from the directory and click ok check dependency and app manifest in the dependencies section of gradle scripts > build gradle module app file, see the appropriate dependency for health services dependencies { implementation 'androidx health health-services-client 1 0 0-beta03' // } notesince the library might update from time to time, it is recommended to choose the version suggested by android studio in androidmanifest xml file, note the following <queries> element <queries> <package android name="com google android wearable healthservices" /> </queries> section with requests for necessary permissions <uses-permission android name="android permission body_sensors" /> <uses-permission android name="android permission activity_recognition" /> check capabilities to check what can be measured during an exercise, you need to check its capabilities go to app > java > com samsung sdc21 deadlift open the deadliftutil java file and navigate to the checkcapabilities method an inner class c definition implements the methods of the futurecallback interface within this definition, define the onsuccess method to retrieve the exercise type capabilities public void onsuccess exercisecapabilities result { objects requirenonnull result ; log i tag, "got exercise capabilities" ; /*********************************************************************************** * [practice 1] define the onsuccess method * * - hint uncomment lines below and replace todo 1 * call getexercisetypecapabilities method of result object, * passing already initialized t as an argument **********************************************************************************/ final exercisetype t = exercisetype deadlift; // final exercisetypecapabilities capabilities = "todo 1" // final exerciseconfig builder builder = exerciseconfig builder t ; // builder setdatatypes capabilities getsupporteddatatypes ; // exerciseconfigbuilder = builder; } next, implement the findcapabilitesfuture method to get a callback with exercisecapabilities getcapabilitiesasync returns the exercisecapabilities of the exerciseclient for the device static listenablefuture<exercisecapabilities> findcapabilitiesfuture exerciseclient client { /******************************************************************************************* * [practice 1] create a listenablefuture object that will get a callback with * with exercise capabilities choose the correct method from exerciseclient * * - hint uncomment line and replace null with todo 2 * for checking capabilities use getcapabilitiesasync method ******************************************************************************************/ return null; //"todo 2"; } start the exercise inside the startexercise method, there is a call to the futures addcallback method this method adds a callback function that executes when the asynchronous operation of starting the exercise completes set an update callback for the exercise client within the onsuccess method of the callback function public void onsuccess void result { log i tag, "successfully started" ; /*************************************************************************** * [practice 2] set an update callback * * - hint uncomment lines below and fill todos * 1 make appropriate call of setupdatecallback method * and pass exerciseupdatelistener object as an argument * 2 change ismeasurementrunning flag value to true **************************************************************************/ // exerciseclient setupdatecallback "todo 3 1 " ; log i tag, "successfully set update listener" ; // "todo 3 2 " } in the deadlift java file, call the startexercise method in onbuttonclickhelper public void onbuttonclickhelper { /******************************************************************************************* * [practice 2] start the exercise using a method from deadliftutil java * * - hint uncomment line below and fill todo 4 * call startexercise method on util object * ****************************************************************************************/ // "todo 4" } get the results go to the deadliftutil java file, and in the getnewrepsvalue method, call the getlatestmetrics method from the exerciseupdate class to get the data collected during the exercise store the data in the resultlist, where the last element holds the most up-to-date value of all your repetitions public long getnewrepsvalue exerciseupdate update, deltadatatype<long, intervaldatapoint<long>> datatype { /******************************************************************************************* * [practice 3] get the data collected during exercise * * - hint uncomment lines below and fill todo 5 * call getlatestmetrics method of exerciseupdate object * then, get the data of appropriate type * for this, you can use dedicated method getdata , passing datatype as an argument * ****************************************************************************************/ // final list<intervaldatapoint<long>> resultlist = "todo 5" // if !resultlist isempty { // final int lastindex = resultlist size - 1; // return resultlist get lastindex getvalue ; // } return no_new_value; } run unit tests for your convenience, you will find an additional unit tests package this will let you verify your code changes even without using a physical watch see instruction below on how to run unit tests right click on com samsung sdc21 deadlift test > deadliftunittest and execute run 'deadliftunittest' command if you completed all the tasks correctly, you will see all the unit tests passed successfully run the app after building the apk, you can run the application on a connected device to measure actual deadlift parameters right after the app is started, it will request for the user permission allow the app to receive data of the activity afterwards, the application main screen will be shown before doing deadlifts, press the start button to track your exercise when done, tap on the stop button you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a deadlift exercise tracker app by yourself! if you're having trouble, you may download this file health track deadlift complete code 132 42 kb learn more by going to health platform

https://developer.samsung.com/codelab/health/deadlift-tracker.html

Develop Health

doc

Introduction

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

https://developer.samsung.com/health/android/data/guide/intro.html

Develop Health

api

HealthConnectionErrorResult

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

https://developer.samsung.com/health/android/data/api-reference/com/samsung/android/sdk/healthdata/HealthConnectionErrorResult.html

Develop Health

doc

Release Note

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

https://developer.samsung.com/health/android/release-note.html

Develop Health

doc

Overview

notefor 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 notethere 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 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 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 notewe 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 10 api level 29 or above it is available on all samsung smartphones and also non-samsung android smartphones the sdk provides apis to check whether the device supports the sdk see faq for more information

https://developer.samsung.com/health/android/overview.html

Develop Health

doc

Overview

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

https://developer.samsung.com/health/stack/overview.html

Learn Code Lab

codelab

Measure Blood Oxygen Level on Galaxy Watch

measure blood oxygen level on galaxy watch objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung health sensor sdk to trigger and obtain blood oxygen level spo2 measurement results overview samsung health sensor sdk provides means of accessing and tracking health information contained in the health data storage its tracking service gives raw and processed sensor data such as accelerometer and body composition data sent by the samsung bioactive sensor the latest bioactive sensor of galaxy watch runs powerful health sensors such as photoplethysmogram ppg , electrocardiogram ecg , bioelectrical impedance analysis bia , sweat loss, and spo2 see samsung health sensor sdk descriptions for detailed information set up your environment you will need the following galaxy watch4 or newer android studio latest version recommended java se development kit jdk 11 or later sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! measuring blood oxygen level sample code 146 3 kb connect your galaxy watch to wi-fi go to settings > connection > wi-fi and make sure that wi-fi is enabled from the list of available wi-fi networks, choose and connect to the same one as your pc turn on developer mode and adjust its settings on your watch, go to settings > about watch > software and tap on software version 5 times upon successful activation of developer mode, a toast message will display as on the image below afterwards, developer options will be visible under settings tap developer options and enable the following options adb debugging in developer options find wireless debugging turn on wireless debugging check always allow on this network and tap allow go back to developer options and click turn off automatic wi-fi notethere may be differences in settings depending on your one ui version connect your galaxy watch to android studio go to settings > developer options > wireless debugging and choose pair new device take note of the wi-fi pairing code, ip address & port in android studio, go to terminal and type adb pair <ip address> <port> <wi-fi pairing code> when prompted, tap always allow from this computer to allow debugging after successfully pairing, type adb connect <ip address of your watch> <port> upon successful connection, you will see the following message in android studio’s terminal connected to <ip address of your watch> now, you can run the app directly on your watch turn on developer mode for health platform on your watch go to settings > apps > health platform quickly tap health platform title for 10 times this enables developer mode and displays [dev mode] below the title to stop using developer mode, quickly tap health platform title for 10 times to disable it start your project in android studio, click open to open existing project locate the downloaded android project from the directory and click ok check capabilities for the device to track data with the samsung health sensor sdk, it must support a given tracker type – blood oxygen level to check this, get the list of available tracker types and verify that the tracker is on the list in the connectionmanager java file, navigate to the isspo2available function, use a provided healthtrackingservice object to create a healthtrackercapability instance, send it to the checkavailabletrackers function, and assign its result to the availabletrackers list gettrackingcapability returns a healthtrackercapability instance in the healthtrackingservice object healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype public healthtrackercapability gettrackingcapability provide a healthtrackercapability instance to get a supporting health tracker type list /****************************************************************************************** * [practice 1] check capabilities to confirm spo2 availability * * ---------------------------------------------------------------------------------------- * * hint replace todo 1 with java code * get healthtrackercapability object from healthtrackingservice * send the object to checkavailabletrackers ******************************************************************************************/ public boolean isspo2available healthtrackingservice healthtrackingservice { if healthtrackingservice == null return false; list<healthtrackertype> availabletrackers = null; //"todo 1" if availabletrackers == null return false; else return availabletrackers contains healthtrackertype spo2_on_demand ; } check connection error resolution using samsung health sensor sdk api, resolve any error when connecting to health tracking service in the connectionmanager java file, navigate to the processtrackerexception function, and check if the provided healthtrackerexception object has a resolution assign the result to hasresolution variable hasresolution function in the healthtrackerexception object checks if the api can fix the error healthtrackerexceptionhealthtrackerexception contains error codes and checks the error's resolution if there is a resolution, solving the error is available by calling resolve activity boolean hasresolution checks whether the given error has a resolution /******************************************************************************************* * [practice 2] resolve healthtrackerexception error * * ----------------------------------------------------------------------------------------- * * hint replace todo 2 with java code * call hasresolution on healthtrackerexception object ******************************************************************************************/ public void processtrackerexception healthtrackerexception e { boolean hasresolution = false; //"todo 2" if hasresolution e resolve callingactivity ; if e geterrorcode == healthtrackerexception old_platform_version || e geterrorcode == healthtrackerexception package_not_installed observerupdater getobserverupdater notifyconnectionobservers r string novalidhealthplatform ; else observerupdater getobserverupdater notifyconnectionobservers r string connectionerror ; log e tag, "could not connect to health tracking service " + e getmessage ; } initialize spo2 tracker before the measurement starts, initialize the spo2 tracker by obtaining the proper health tracker object in the spo2listener java file, navigate to the init function using the provided healthtrackingservice object, create an instance of the spo2 tracker and assign it to the spo2tracker object gethealthtracker with healthtrackertype spo2_on_demand as an argument will create a healthtracker instance healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype healthtracker gethealthtracker healthtrackertype healthtrackertype provides a healthtracker instance for the given healthtrackertype /******************************************************************************************* * [practice 3] initialize spo2 tracker * * ---------------------------------------------------------------------------------------- * * hint replace todo 3 with java code * initialize spo2tracker with proper samsung health sensor sdk functionality * call gethealthtracker on healthtrackingservice object * use healthtrackertype spo2_on_demand as an argument ******************************************************************************************/ void init healthtrackingservice healthtrackingservice { //"todo 3" } perform measurement for the client app to start obtaining the data through the sdk, it has to set a listener method on the healthtracker the application setups the listener when the user taps on the measure button each time there is new data, the listener callback receives it after the measurement is completed, the listener has to be disconnected due to battery drain, on-demand measurement should not last more than 30 seconds the measurement is cancelled if the final value is not delivered in time note that the sensor needs a few seconds to warm up and provide correct values, which adds to the overall measurement time the blood oxygen level values come in the ondatareceived callback of trackereventlistener in spo2listener java file, you can see the code for reading the value private final healthtracker trackereventlistener spo2listener = new healthtracker trackereventlistener { @override public void ondatareceived @nonnull list<datapoint> list { for datapoint data list { updatespo2 data ; } } }; private void updatespo2 datapoint data { int status = data getvalue valuekey spo2set status ; int spo2value = 0; if status == measurement_completed spo2value = data getvalue valuekey spo2set spo2 ; observerupdater getobserverupdater notifytrackerobservers status, spo2value ; } run unit tests for your convenience, you can find an additional unit tests package this lets you verify your code changes even without using a physical watch see instructions below on how to run unit tests right click on com samsung health spo2tracking test and execute run 'tests in 'com samsung health spo2tracking'' command if you completed all the tasks correctly, you can see that all the unit tests passed successfully run the app after building the apk, you can run the application on a connected device to measure blood oxygen level right after the app is started, it requests for user permission allow the app to receive data from the body sensors afterwards, it shows the application's main screen to get the blood oxygen level, tap on the measure button to stop the measurement, tap on the stop button you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a health app that measures blood oxygen level by yourself! if you're having trouble, you may download this file measuring blood oxygen level complete code 146 2 kb to learn more about samsung health, visit developer samsung com/health

https://developer.samsung.com/codelab/health/blood-oxygen.html

Develop Health

api

HealthDataStore

overview package class tree deprecated index com samsung android sdk healthdata class healthdatastore java lang object com samsung android sdk healthdata healthdatastore public class healthdatastore extends object this class provides connection to the health data store app manifest from android 11, add the following element in your app's manifest otherwise, a connection with samsung health fails <manifest > <queries> <package android name="com sec android app shealth" /> </queries> </manifest> data store connection health data in the health data store can be accessed after getting connection with the health data store healthdatastore requests to connect or disconnect with the health data store and its result can be checked with healthdatastore connectionlistener an example below shows how to request connection to the health data store and check the result public class mainactivity extends activity { // the state of connection private healthdatastore mstore; private static final string app_tag = "myapp"; @override protected void oncreate bundle savedinstancestate { super oncreate savedinstancestate ; setcontentview r layout activity_main ; connect ; } @override public boolean oncreateoptionsmenu menu menu { // inflate the menu; this adds items to the action bar if it is present getmenuinflater inflate r menu main, menu ; return true; } @override public boolean onoptionsitemselected menuitem item { // handle action bar item clicks here the action bar will // automatically handle clicks on the home/up button, so long // as you specify a parent activity in androidmanifest xml int id = item getitemid ; if id == r id action_settings { return true; } return super onoptionsitemselected item ; } public healthdatastore connect { // connect to the health data store mstore = new healthdatastore this, mcntlistener ; try { mstore connectservice ; } catch exception e { log d app_tag, "connection fails " ; e printstacktrace ; } return mstore; } private final healthdatastore connectionlistener mcntlistener = new healthdatastore connectionlistener { @override public void onconnected { log d app_tag, "health data service is connected " ; } @override public void onconnectionfailed healthconnectionerrorresult error { if error hasresolution { // resolve an error } else { log d app_tag, "health data service is not available " ; } } @override public void ondisconnected { log d app_tag, "health data service is disconnected " ; } }; } since 1 0 0 nested class summary nested classes modifier and type class and description static interface healthdatastore connectionlistener this interface provides the callback when the client is connected or disconnected with the health data store constructor summary constructors constructor and description healthdatastore context context, healthdatastore connectionlistener listener constructs and initializes an instance of healthdatastore with a context and listener method summary all methods instance methods concrete methods modifier and type method and description void connectservice connects your application to the health data store void connectservice long timeout connects your application to the health data store for the given connection timeout void disconnectservice disconnects your application from the health data store constructor detail healthdatastore public healthdatastore context context, healthdatastore connectionlistener listener constructs and initializes an instance of healthdatastore with a context and listener parameters context - the context of application listener - the listener that is implemented to receive the result of the connection or disconnection request throws illegalargumentexception - if the given context or listener is null since 1 0 0 method detail connectservice public void connectservice connects your application to the health data store it tries connection for one minute in default if you want to set a connection timeout differently, use connectservice long the connection result can be checked in the following handlers healthdatastore connectionlistener onconnected is invoked if it succeeds healthdatastore connectionlistener onconnectionfailed healthconnectionerrorresult is invoked if it fails throws illegalstateexception - if the instance is not constructed with a valid context instance since 1 0 0 connectservice public void connectservice long timeout connects your application to the health data store for the given connection timeout the connection result can be checked in the following handlers healthdatastore connectionlistener onconnected is invoked if it succeeds healthdatastore connectionlistener onconnectionfailed healthconnectionerrorresult is invoked if it fails parameters timeout - the timeout value in milliseconds for connection to health data store if connection doesn't succeed in timeout, healthdatastore connectionlistener onconnectionfailed healthconnectionerrorresult is invoked throws illegalstateexception - if the instance is not constructed with a valid context instance since 1 0 0 disconnectservice public void disconnectservice disconnects your application from the health data store note that healthdatastore connectionlistener ondisconnected is not invoked after calling this method since 1 0 0

https://developer.samsung.com/health/android/data/api-reference/com/samsung/android/sdk/healthdata/HealthDataStore.html

Develop Health

doc

Hello Health Data

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

https://developer.samsung.com/health/android/data/guide/hello-health-data.html

Develop Health

doc

FAQs

missing google-services json file in the source code for firebase integration the app uses firebase to provide a 3rd party login to users the google-services json file must be included in the source code a reference to integrate it can be found here need guidance on backend installation for the app the app fetches project information such as surveys and activity tasks from the backend for testing, it's recommended to follow the backend installation guide instead of integrating your own backend system detailed instructions can be found here error encountered while trying to build the modules related to healthstack sample the error seems to arise from a missing client for the package name 'healthstack sample' ensure that the correct configurations are available and that the associated files for this client are not missing possibility of using the graphics and ui from the samsung health app in the new build no specific answer provided in the email chain, would need further follow-up how to capture and export accelerometry continuously, not just during the activity task? the app regularly sends over health data logged by health connect at intervals that can be set by the user for sensor data related to each activity task, it's collected & synced when the activity is conducted specific activity tasks and their associated sensor types were provided which data types from health connect can be utilized? the app can utilize all data types supported by health connect by modifying the list of healthdatarequired, you can adjust the app to collect additional data types recorded by health connect however, to have data input, that data needs to exist in health connect resolution to /gradlew clean failing for app-sdk? this appears to be an issue with the system failing to communicate with the gradle plugin repository ensure that your system is online, and if you're using a proxy environment, check proxy settings if a proxy is in use, the issue might be an ssl handshake failure check ssl settings and proxy configurations

https://developer.samsung.com/health/stack/faq.html