Search

Filter

All 100
Sorry, no results
found for "Health" on the website

Develop Health

doc

Privacy

privacy privacy is a key for handling health data samsung health sdk for android enables your application to access health data based on the user's consent permission manager the sdk's supported data types except health document need to gain permission through permissionmanager an application needs to declare proper permissions for handling required health data types and to consider secureexception when the application didn't gain a user consent the user can withdraw consent at any time see permissionmanager for permission declaration and request samsung health add the partner app's permission info under samsung health > settings > data permissions > [partner app] after a success of healthpermissionmanager requestpermission in the partner app on the other hand, the partner app needs to make a permission setting menu separately in the menu, the app calls healthpermissionmanager requestpermission with required permissions the samsung health's health data framework pops up the permission ui a permission result event is retreived after the user's agreement or denial on the permission popup the app should provide an interface that the user may change data permission at any time the user consent is limited to the device even if multiple devices use the same samsung account, the application has to acquire the user consent on each device independently instant permission a very sensitive data type like a health document requires gaining instant permission instant permission is created for one-time data access an app that handles a health document has to call the instant permission api whenever it needs to access data related apis are healthdataresolver insertwithpermission healthdataresolver readwithpermission healthdataresolver deletewithpermission

https://developer.samsung.com/health/android/data/guide/privacy.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

Developer Mode

developer mode a partner app can connect with samsung health if its package name and signature sha256 are same with the registered info in samsung health the registered app signature is from the partner app's release key but in many cases, developers use a different app signing key to test or debug the app to make it easy, samsung health provides a developer mode the developer mode is not activated by default activating the developer mode requires an access key from samsung health 6 11 the access key is shared by samsung health team after a partnership approval how to activate the developer mode you can activate it with the following steps select the action overflow of samsung health on the top-left select the settings icon in the action list's top-right select about samsung health tap the version line region quickly 10 times or more the exact region to tap is illustrated with the blue box in the figure below if it succeeds, a developer mode button displays select the developer mode button and enter the developer mode page enter your app package name and access code that samsung health team shared and select the add button the access code is case-sensitive if it succeeds, your app package name will be listed up below it means the developer mode is activated for your app back to about samsung health with the back button on the top-left and select the info icon on the top-right now you can test your app with samsung health if your app package name is not added well please check the entered app package name and access code carefully they should be matched exactly a failure can be from entering a different app package name unmatched case for an access key how long will be maintained the added app's developer mode in the developer mode page is valid until uninstalling samsung health and it doesn't work for another app that has a different app package name if samsung health is reinstalled, enter your app package name and its access code if you remove your app from the developer mode page by selecting the "-" icon, the developer mode will be deactivated for your app

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

Develop Health

api

HealthDataResolver.InsertRequest

overview package class tree deprecated index com samsung android sdk healthdata interface healthdataresolver insertrequest enclosing class healthdataresolver public static interface healthdataresolver insertrequest this interface is able to make a request to insert health data for the specific health data type request for inserting data healthdataresolver insert helps that your application saves a new measured data to samsung health the following information is mandatory to build an insertrequest instance mandatory information description data type set the data type with insertrequest builder setdatatype source device the device id that provides health data set it with healthdata setsourcedevice data's mandatory properties set mandatory properties of the health data type by referring to data type definition you can make a request instance with insertrequest builder build inserting data example you can save health data to samsung health with healthdataresolver insert after setting detailed property values of the created healthdata instance the health data framework registers the current device where your application is installed if the source device is the current device, its id can be checked as shown below // the state of connection private final healthdatastore mstore; public static final string app_tag = "myapp"; private void insertglucose long start, long offset, float value { // set the source device as the current device healthdevice mydevice = new healthdevicemanager mstore getlocaldevice ; healthdata data = new healthdata ; data setsourcedevice mydevice getuuid ; and the data instance's properties including mandatory ones needs to be set // set properties including mandatory ones data putlong healthconstants bloodglucose start_time, start ; data putlong healthconstants bloodglucose time_offset, offset ; data putint healthconstants bloodglucose measurement_type, healthconstants bloodglucose measurement_type_whole_blood ; the measured data value needs to be set after checking defined data unit each property in api reference lets you know it in this case, see healthconstants bloodglucose glucose data putfloat healthconstants bloodglucose glucose, value ; an insertrequest instance is created by insertrequest builder build with setting the data type it's ready to add data to samsung health if the data is added to the insertrequest healthdataresolver insertrequest insrequest = new healthdataresolver insertrequest builder setdatatype healthconstants bloodglucose health_data_type build ; // add health data insrequest addhealthdata data ; healthdataresolver resolver = new healthdataresolver mstore, null ; try { resolver insert insrequest setresultlistener mistresult ; } catch exception e { log d app_tag, "resolver insert fails " ; } } healthdataresolver insert com samsung android sdk healthdata healthdataresolver insertrequest sends a request to samsung health a data validation exception is received in healthresultholder baseresult it gives a request's result state and a number of inserted data private final healthresultholder resultlistener<healthresultholder baseresult> mistresult = new healthresultholder resultlistener<healthresultholder baseresult> { @override public void onresult healthresultholder baseresult result { if result getstatus != status_successful { // check the error } else { // check the count of inserted data log d app_tag, "count of inserted data " + result getcount ; } } }; since 1 0 0 nested class summary nested classes modifier and type interface and description static class healthdataresolver insertrequest builder this class is a builder to configure healthdataresolver insertrequest method summary all methods instance methods abstract methods modifier and type method and description void addhealthdata healthdata object adds health data to insert void addhealthdata list<healthdata> objectlist adds a health data list to insert method detail addhealthdata void addhealthdata healthdata object adds health data to insert parameters object - the health data instance the source device of object should be valid throws illegalargumentexception - if source device is not set or data is null since 1 0 0 addhealthdata void addhealthdata list<healthdata> objectlist adds a health data list to insert parameters objectlist - the list of health data objects the source device for each health data has to be defined in advance throws illegalargumentexception - if source device is not set or data list is null since 1 0 0

https://developer.samsung.com/health/android/data/api-reference/com/samsung/android/sdk/healthdata/HealthDataResolver.InsertRequest.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.ConnectionListener

overview package class tree deprecated index com samsung android sdk healthdata interface healthdatastore connectionlistener enclosing class healthdatastore public static interface healthdatastore connectionlistener this interface provides the callback when the client is connected or disconnected with the health data store since 1 0 0 method summary all methods instance methods abstract methods modifier and type method and description void onconnected called when a connection to the health data store has been established void onconnectionfailed healthconnectionerrorresult error called when a connection to the health data store has failed void ondisconnected called when a connection to the health data store has been lost method detail onconnected void onconnected called when a connection to the health data store has been established it is invoked after creating a healthdatastore instance since 1 0 0 onconnectionfailed void onconnectionfailed healthconnectionerrorresult error called when a connection to the health data store has failed note that it is invoked after creating a healthdatastore instance since 1 0 0 ondisconnected void ondisconnected called when a connection to the health data store has been lost note that it is not invoked caused by healthdatastore disconnectservice it is only invoked if the health data service crashes since 1 0 0

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

Develop Health

api

HealthDataResolver.UpdateRequest.Builder

overview package class tree deprecated index com samsung android sdk healthdata class healthdataresolver updaterequest builder java lang object com samsung android sdk healthdata healthdataresolver updaterequest builder enclosing interface healthdataresolver updaterequest public static class healthdataresolver updaterequest builder extends object this class is a builder to configure healthdataresolver updaterequest only inserted health data by your application can be updated the following example shows how to update calrories of existing health data public class healthdataresolverexample { private healthdataresolver updaterequest buildupdaterequest { healthdevice mydevice = new healthdevicemanager mstore getlocaldevice ; healthdata data = new healthdata ; data setsourcedevice mydevice getuuid ; data putfloat healthconstants nutrition calorie, 100 ; healthdataresolver filter filter = healthdataresolver filter eq healthconstants nutrition calorie, 10000 ; // build a request to update nutrition data which its calories is 10000 to 100 healthdataresolver updaterequest request = new healthdataresolver updaterequest builder setdatatype healthconstants nutrition health_data_type setfilter filter sethealthdata data build ; return request; } } since 1 0 0 constructor summary constructors constructor and description builder helps to construct a healthdataresolver updaterequest object method summary all methods instance methods concrete methods modifier and type method and description healthdataresolver updaterequest build builds a new healthdataresolver updaterequest object healthdataresolver updaterequest builder setdatatype string type sets a health data type to update healthdataresolver updaterequest builder setfilter healthdataresolver filter filter sets a filter for health data to update healthdataresolver updaterequest builder sethealthdata healthdata object sets a health data object to update healthdataresolver updaterequest builder setlocaltimerange string timeproperty, string offsetproperty, long begin, long end sets the local time range not to miss data from the query's result when there exist data with a different time_offset in the saved health data healthdataresolver updaterequest builder setsourcedevices list<string> uuidlist sets a uuid list of source devices for health data to be updated constructor detail builder public builder helps to construct a healthdataresolver updaterequest object since 1 0 0 method detail setdatatype public healthdataresolver updaterequest builder setdatatype string type sets a health data type to update it has to be specified before calling build parameters type - health_data_type of the data type returns the object that applies the health data type since 1 0 0 sethealthdata public healthdataresolver updaterequest builder sethealthdata healthdata object sets a health data object to update it has to be specified before calling build parameters object - the health data object to update the source device of object should be valid returns the object that applies health data to update since 1 0 0 setfilter public healthdataresolver updaterequest builder setfilter healthdataresolver filter filter sets a filter for health data to update parameters filter - the filter object to update returns the object that applies the filter since 1 0 0 setsourcedevices public healthdataresolver updaterequest builder setsourcedevices list<string> uuidlist sets a uuid list of source devices for health data to be updated parameters uuidlist - the uuid list for source devices returns the object that applies source devices since 1 0 0 setlocaltimerange public healthdataresolver updaterequest builder setlocaltimerange string timeproperty, string offsetproperty, long begin, long end sets the local time range not to miss data from the query's result when there exist data with a different time_offset in the saved health data the data that has a different time_offset with other data's time_offset can be saved when the daylight time is applied or the user moves to another region by like a travel building a complete query to aggregate all data including the different time_offset is not easy use this api to build an aggregate request as possible parameters timeproperty - the time property name that needs to add a filter offsetproperty - the time offset property begin - the beginning time with gmt+0 milliseconds e g if you would like to update data from 00 00 00 on october 26th, 2021 in your region, set the value with 1635206400000 see sample codes its minimum value is long min_value end - the end time with gmt+0 milliseconds e g if you would like to update data until 00 00 00 on october 26th, 2021 in your region, set the value with 1635206400000 see sample codes its maximum value is long max_value returns the object that applies the local time range since 1 5 0 build public healthdataresolver updaterequest build builds a new healthdataresolver updaterequest object check if following information is specified data type health data to update returns the healthdataresolver updaterequest object throws illegalstateexception - if data type, or health data object is not specified since 1 0 0 see also setdatatype string , sethealthdata healthdata

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

Develop Health

api

HealthDataResolver.ReadRequest.Builder

overview package class tree deprecated index com samsung android sdk healthdata class healthdataresolver readrequest builder java lang object com samsung android sdk healthdata healthdataresolver readrequest builder enclosing interface healthdataresolver readrequest public static class healthdataresolver readrequest builder extends object this class is a builder to configure healthdataresolver readrequest private healthdataresolver readrequest buildreadrequest long starttime, long endtime { healthdataresolver filter filter = healthdataresolver filter greaterthan healthconstants nutrition calorie, 200 ; healthdataresolver readrequest request = new healthdataresolver readrequest builder setdatatype healthconstants nutrition health_data_type setlocaltimerange healthconstants nutrition start_time, healthconstants nutrition time_offset, starttime, endtime setfilter filter build ; return request; } since 1 0 0 constructor summary constructors constructor and description builder helps to construct a healthdataresolver readrequest object method summary all methods instance methods concrete methods modifier and type method and description healthdataresolver readrequest build builds a new healthdataresolver readrequest object healthdataresolver readrequest builder setdatatype string type sets a health data type for the request to read healthdataresolver readrequest builder setfilter healthdataresolver filter filter sets a filter for the request to read healthdataresolver readrequest builder setlocaltimerange string timeproperty, string offsetproperty, long begin, long end sets the local time range not to miss data from the query's result when there exist data with a different time_offset in the saved health data healthdataresolver readrequest builder setpackagename string packagename sets the package name that provides health data to read healthdataresolver readrequest builder setproperties string[] properties sets a property array for the health data result to read healthdataresolver readrequest builder setpropertyalias string property, string alias sets an alias for the given property healthdataresolver readrequest builder setresultcount int offset, int count sets the count range of result data with a given offset and count healthdataresolver readrequest builder setsort string property, healthdataresolver sortorder sortorder sets the sort order for a given property or alias healthdataresolver readrequest builder setsourcedevices list<string> uuidlist sets a uuid list for source devices to read health data healthdataresolver readrequest builder settimeafter long time sets the time range to retrieve result data which is inserted or updated to the health data store after the given time constructor detail builder public builder helps to construct a healthdataresolver readrequest object since 1 0 0 method detail setdatatype public healthdataresolver readrequest builder setdatatype string type sets a health data type for the request to read it has to be specified before calling build parameters type - health_data_type of the data type returns the object that applies the health data type since 1 0 0 setfilter public healthdataresolver readrequest builder setfilter healthdataresolver filter filter sets a filter for the request to read parameters filter - the filter object returns the object that applies the filter since 1 0 0 setsourcedevices public healthdataresolver readrequest builder setsourcedevices list<string> uuidlist sets a uuid list for source devices to read health data parameters uuidlist - the uuid list for source devices returns the object that applies source devices since 1 0 0 setproperties public healthdataresolver readrequest builder setproperties string[] properties sets a property array for the health data result to read if it is not specified, the health data result shows all properties of the data type parameters properties - properties that want to gain in the result returns the object that applies properties since 1 0 0 setpropertyalias public healthdataresolver readrequest builder setpropertyalias string property, string alias sets an alias for the given property parameters property - the property to be shown with the alias alias - the alias for the property returns the object that applies the alias for the property since 1 0 0 setpackagename public healthdataresolver readrequest builder setpackagename string packagename sets the package name that provides health data to read accessory data's package name samsung health collects the linked accessory's data also like galaxy watch the accessory's data including galaxy watch is inserted to samsung health with the samsung health's package name, com sec android app shealth if you want to read only the specific accessory's data, make a division the device id parameters packagename - the package name that provides health data returns the object that applies the package name since 1 0 0 setsort public healthdataresolver readrequest builder setsort string property, healthdataresolver sortorder sortorder sets the sort order for a given property or alias parameters property - the property or alias to be shown with the sort order sortorder - the sort order returns the object that applies the sort order since 1 0 0 setresultcount public healthdataresolver readrequest builder setresultcount int offset, int count sets the count range of result data with a given offset and count if this method is not called, all result will be obtained from the result if you want to get only 10 data from the 3rd position in the result, set offset as 2 and count as 10 parameters offset - the start position in the whole result, which equals to or is greater than 0 count - the limited count of result, which is greater than 0 returns the object that applies the range of the result since 1 0 0 settimeafter public healthdataresolver readrequest builder settimeafter long time sets the time range to retrieve result data which is inserted or updated to the health data store after the given time it's different to set the time range based on the data's created or updated time to read data if then, use healthdataresolver filter greaterthan java lang string, t moreover it is useful to check the health data store's change after your app reads the health data store's data at the last time if the data's source device is same with the current device, time means the inserted time that data is created on the current device if the data's source device is different, time indicates the synchronized time that data on other devices is synchronized to samsung health of the current device parameters time - the time range to retrieve result data which is inserted or updated to the health data store after the specific time in milliseconds its value is started from january, 1, 1970 00 00 00 utc returns the object that applies the range of the result since 1 0 0 setlocaltimerange public healthdataresolver readrequest builder setlocaltimerange string timeproperty, string offsetproperty, long begin, long end sets the local time range not to miss data from the query's result when there exist data with a different time_offset in the saved health data the data that has a different time_offset with other data's time_offset can be saved when the daylight time is applied or the user moves to another region by like a travel building a complete query to read all data including the different time_offset is not easy use this api to build a read request as possible parameters timeproperty - the time property name that needs to add a filter offsetproperty - the time offset property begin - the beginning time with gmt+0 milliseconds e g if you would like to get data from 00 00 00 on october 26th, 2021 in your region, set the value with 1635206400000 see sample codes its minimum value is long min_value end - the end time with gmt+0 milliseconds e g if you would like to get data until 00 00 00 on october 26th, 2021 in your region, set the value with 1635206400000 see sample codes its maximum value is long max_value returns the object that applies the local time range since 1 3 0 build public healthdataresolver readrequest build builds a new healthdataresolver readrequest object check if following information is specified data type returns the healthdataresolver readrequest object throws illegalstateexception - if enough information is not specified since 1 0 0 see also setdatatype string

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

Learn Code Lab

codelab

Transfer heart rate data from Galaxy Watch to a mobile device

transfer heart rate data from galaxy watch to a mobile device objective create a health app for galaxy watch, operating on wear os powered by samsung, to measure heart rate and inter-beat interval ibi , send data to a paired android phone, and create an android application for receiving data sent from a paired galaxy watch overview with this code lab, you can measure various health data using samsung health sensor sdk and send it to a paired android mobile device for further processing samsung health sensor sdk tracks various health data, but it cannot save or send collected results meanwhile, wearable data layer allows you to synchronize data from your galaxy watch to an android mobile device using a paired mobile device allows the data to be more organized by taking advantage of a bigger screen and better performance see samsung health sensor sdk descriptions for detailed information set up your environment you will need the following galaxy watch4 or newer android mobile device android studio latest version recommended java se development kit jdk 17 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! heart rate data transfer sample code 213 7 kb connect your galaxy watch to wi-fi go to settings > connection > wi-fi and make sure that the 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 the 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 to use the app, you need to enable developer mode in the 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 set up your android device click on the following links to setup your android device enable developer options run apps on a hardware device connect the galaxy watch with you samsung mobile phone start your project in android studio, click open to open an existing project locate the downloaded android project hrdatatransfer-code-lab from the directory and click ok you should see both devices and applications available in android studio as in the screenshots below initiate heart rate tracking noteyou may refer to this blog post for more detailed analysis of the heart rate tracking using samsung health sensor sdk first, you need to connect to the healthtrackingservice to do that create connectionlistener, create healthtrackingservice object by invoking healthtrackingservice connectionlistener, context invoke healthtrackingservice connectservice when connected to the health tracking service, check the tracking capability the available trackers may vary depending on samsung health sensor sdk, health platform versions or watch hardware version use the gettrackingcapability function of the healthtrackingservice object obtain heart rate tracker object using the function healthtrackingservice gethealthtracker healthtrackertype heart_rate_continuous define event listener healthtracker trackereventlistener, where the heart rate values will be collected start tracking the tracker starts collecting heart rate data when healthtracker seteventlistener updatelistener is invoked, using the event listener collect heart data from the watch the updatelistener collects datapoint instances from the watch, which contains a collection of valuekey objects those objects contain heart rate, ibi values, and ibi statuses there's always one value for heart rate while the number of ibi values vary from 0-4 both ibi value and ibi status lists have the same size go to wear > java > data > com samsung health hrdatatransfer > data under ibidataparsing kt, provide the implementation for the function below /******************************************************************************* * [practice 1] get list of valid inter-beat interval values from a datapoint * - return arraylist<int> of valid ibi values validibilist * - if no ibi value is valid, return an empty arraylist * * var ibivalues is a list representing ibivalues up to 4 * var ibistatuses is a list of their statuses has the same size as ibivalues ------------------------------------------------------------------------------- * - hints * use local function isibivalid status, value to check validity of ibi * ****************************************************************************/ fun getvalidibilist datapoint datapoint arraylist<int> { val ibivalues = datapoint getvalue valuekey heartrateset ibi_list val ibistatuses = datapoint getvalue valuekey heartrateset ibi_status_list val validibilist = arraylist<int> //todo 1 return validibilist } check data sending capabilities for the watch once the heart rate tracker can collect data, set up the wearable data layer so it can send data to a paired android mobile device wearable data layer api provides data synchronization between wear os and android devices noteto know more about wearable data layer api, go here to determine if a remote mobile device is available, the wearable data layer api uses concept of capabilities not to be confused with samsung health sensor sdk’s tracking capabilities, providing information about available tracker types using the wearable data layer's capabilityclient, you can get information about nodes remote devices being able to consume messages from the watch go to wear > java > com samsung health hrdatatransfer > data in capabilityrepositoryimpl kt, and fill in the function below the purpose of this part is to filter all capabilities represented by allcapabilities argument by capability argument and return the set of nodes set<node> having this capability later on, we need those nodes to send the message to them /************************************************************************************** * [practice 2] check capabilities for reachable remote nodes devices * - return a set of node objects out of all capabilities represented by 2nd function * argument, having the capability represented by 1st function argument * - return empty set if no node has the capability -------------------------------------------------------------------------------------- * - hints * you might want to use filtervalues function on the given allcapabilities map * ***********************************************************************************/ override suspend fun getnodesforcapability capability string, allcapabilities map<node, set<string>> set<node> { //todo 2 } encode message for the watch before sending the results of the heart rate and ibi to the paired mobile device, you need to encode the message into a string for sending data to the paired mobile device we are using wearable data layer api’s messageclient object and its function sendmessage string nodeid, string path, byte[] message go to wear > java > com samsung health hrdatatransfer > domain in sendmessageusecase kt, fill in the function below and use json format to encode the list of results arraylist<trackeddata> into a string /*********************************************************************** * [practice 3] - encode heart rate & inter-beat interval into string * - encode function argument trackeddata into json format * - return the encoded string ----------------------------------------------------------------------- * - hint * use json encodetostring function **********************************************************************/ fun encodemessage trackeddata arraylist<trackeddata> string { //todo 3 } notetrackeddata is an object, containing data received from heart rate tracker’s single datapoint object @serializable data class trackeddata var hr int, var ibi arraylist<int> = arraylist 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 or mobile device see the instruction below on how to run unit tests right click on com samsung health hrdatatransfer test , and execute run 'tests in 'com samsung health hrdatatransfer" command if you have completed all the tasks correctly, you will see all the unit tests pass successfully run the app after building the apks, you can run the applications on your watch to measure heart rate and ibi values, and on your mobile device to collect the data from your watch once the app starts, allow the app to receive data from the body sensors afterwards, it shows the application's main screen to get the heart rate and ibi values, tap the start button tap the send button to send the data to your mobile device notethe watch keeps last ~40 values of heart rate and ibi you’re done! congratulations! you have successfully achieved the goal of this code lab now, you can create a health app on a watch to measure heart rate and ibi, and develop a mobile app that receives that health data! if you face any trouble, you may download this file heart rate data transfer complete code 213 9 kb to learn more about samsung health, visit developer samsung com/health

https://developer.samsung.com/codelab/health/heart-rate-data-transfer.html

Develop Health

api

HealthPermissionManager

overview package class tree deprecated index com samsung android sdk healthdata class healthpermissionmanager java lang object com samsung android sdk healthdata healthpermissionmanager public class healthpermissionmanager extends object this class requests permission to read or write health data for the specific health data type note, healthconstants healthdocument can be accessed with the instant permission see acquring instant data permission requesting permission an application can access health data only if the user consents permission for data access can be requested by each data type and the permission type read or write public class mainactivity extends activity { // the state of connection private healthdatastore mstore; set<permissionkey> mkeys = new hashset<permissionkey> ; private static final string app_tag = "myapp"; public void requestpermission { // acquire permission healthpermissionmanager pmsmanager = new healthpermissionmanager mstore ; mkeys add new permissionkey exercise health_data_type, permissiontype read ; mkeys add new permissionkey exercise health_data_type, permissiontype write ; mkeys add new permissionkey stepdailytrend health_data_type, permissiontype read ; try { pmsmanager requestpermissions mkeys, mainactivity this setresultlistener mpermissionlistener ; } catch exception e { log d app_tag, "requestpermissions fails" ; } } if requestpermissions succeeds, the permission ui is popped up on the device the user can check and allow each data type's permission with scrolling down if the user allows permission items on the permission ui and select "done", its result is sent to permissionresult and you can check whether the user allows the data access or not private final healthresultholder resultlistener<permissionresult> mpermissionlistener = new healthresultholder resultlistener<permissionresult> { @override public void onresult permissionresult result { map<permissionkey, boolean> resultmap = result getresultmap ; if resultmap values contains boolean false { log d app_tag, "all required permissions are not granted " ; } else { log d app_tag, "all required permissions are granted " ; //access health data } } }; } specifying permission in manifest not only calling permission related apis, but specifying permission in the manifest file is required the declared permission items in the application's manifest are shown on "samsung health > settings > data permissions > [yourapp]" manifest below contains two data permissions to read and one data permission to write health data use the semicolon ; to declare multiple data types <manifest > <application > <meta-data android name="com samsung android health permission read" android value="com samsung health exercise;com samsung shealth step_daily_trend"/> <meta-data android name="com samsung android health permission write" android value="com samsung health exercise"/> </application> </manifest> the constant value of the required data type can be checked as shown below find its health_data_type in api reference e g if the data type is healthconstants exercise, you'll meet the following description use the constant value, "com samsung health exercise", for a permission declaration in your app's manifest file guidelines for permission request acquiring permission from the user is essential to access health data but too frequent requests of permission can annoy the user here are guidelines that help you to find a solution for the permission request permission needs to be requested in the following cases when your application connects to samsung health at the first time if there is a menu that connects to samsung health in your application and the user selects it and avoid requesting permission in the following cases when your application goes on the background frequent requests of permission until the user grants an occasional nudge is fine see the privacy section of programming guide for more information since 1 0 0 nested class summary nested classes modifier and type class and description static class healthpermissionmanager permissionkey this class represents the permission key which consists of a health data type and a permission type static class healthpermissionmanager permissionresult this class represents the result of requestpermissions set, activity static class healthpermissionmanager permissiontype this enum defines the permission type to read or write health data constructor summary constructors constructor and description healthpermissionmanager healthdatastore store constructs and initializes an instance of healthpermissionmanager method summary all methods instance methods concrete methods deprecated methods modifier and type method and description map<healthpermissionmanager permissionkey,boolean> ispermissionacquired set<healthpermissionmanager permissionkey> permissionkeys checks whether the specified permissions are acquired healthresultholder<healthpermissionmanager permissionresult> requestpermissions set<healthpermissionmanager permissionkey> permissionkeys deprecated use requestpermissions set, activity instead of it healthresultholder<healthpermissionmanager permissionresult> requestpermissions set<healthpermissionmanager permissionkey> permissionkeys, activity activity requests permissions through the permission ui on the given activity constructor detail healthpermissionmanager public healthpermissionmanager healthdatastore store constructs and initializes an instance of healthpermissionmanager parameters store - the successful connection to the health data store since 1 0 0 method detail requestpermissions public healthresultholder<healthpermissionmanager permissionresult> requestpermissions set<healthpermissionmanager permissionkey> permissionkeys deprecated use requestpermissions set, activity instead of it requests permissions through the permission ui if it is called, the permission ui is shown to the user avoid calling this method frequently refer to its guidelines parameters permissionkeys - the set of required permission keys returns the permission result that resolves to the requested permission keys throws illegalargumentexception - if the permissionkeys is invalid illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 requestpermissions public healthresultholder<healthpermissionmanager permissionresult> requestpermissions set<healthpermissionmanager permissionkey> permissionkeys, activity activity requests permissions through the permission ui on the given activity if it is called, the permission ui is shown to the user avoid calling this method frequently refer to its guidelines parameters permissionkeys - the set of required permission keys activity - the activity that pop up the permission ui returns the permission result that resolves to the requested permission keys throws illegalargumentexception - if the permissionkeys is invalid illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 2 0 ispermissionacquired public map<healthpermissionmanager permissionkey,boolean> ispermissionacquired set<healthpermissionmanager permissionkey> permissionkeys checks whether the specified permissions are acquired parameters permissionkeys - the set of permission keys to check acquisition returns the result map representing whether the specified permissions are acquired the permission state for the specific permission key can be retrieved by map get object as the following example public class healthpermissionmanagerexample { // the state of connection private healthdatastore mstore; private static final string app_tag = "myapp"; private void checkpermissions { healthpermissionmanager pmsmanager = new healthpermissionmanager mstore ; set<healthpermissionmanager permissionkey> keys = new hashset<healthpermissionmanager permissionkey> ; healthpermissionmanager permissionkey key1 = new healthpermissionmanager permissionkey healthconstants bloodglucose health_data_type, healthpermissionmanager permissiontype read ; keys add key1 ; healthpermissionmanager permissionkey key2 = new healthpermissionmanager permissionkey healthconstants bloodpressure health_data_type, healthpermissionmanager permissiontype read ; keys add key2 ; try { map resultmap = pmsmanager ispermissionacquired keys ; if resultmap get key1 == boolean true { log d app_tag, "you can read the blood glucose data type " ; } else { log d app_tag, "there is no permission to read the blood glucose data type " ; } if resultmap get key2 == boolean true { log d app_tag, "you can read the blood pressure data type " ; } else { log d app_tag, "there is no permission to read the blood pressure data type " ; } } catch exception e { log d app_tag, "check the connection " ; } } } throws illegalargumentexception - if the permissionkeys is invalid illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0

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