Search

Filter

  • Content Type
Health 100
Sorry, no results
found for "Health" on the website

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 152 8 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 displays as on the image below afterwards, developer options is going to 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 can 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 swipe down from the top of the screen to open the quick panel, then tap the settings icon scroll down and tap apps select health platform quckly tap health platform for about 10 times developer mode is enabled when [dev mode] appears below health platform noteyou can disable developer mode by quickly tapping the health platform until [dev mode] disappears 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 creates 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 oxygen saturation sensor 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 152 6 kb to learn more about samsung health, visit developer samsung com/health

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

Develop Health

api

HealthDataResolver.InsertRequest

overviewpackageclasstreedeprecatedindex 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

Develop Health

api

HealthDataStore

samsung health data sdk/com samsung android sdk health data/healthdatastore healthdatastore interface healthdatastorehealthdatastore is a proxy that provides a way to access the data stored in the samsung health app an app can access the data through the operations provided by healthdatastore, such as reading, aggregating, inserting, updating and deleting data use the healthdataservice getstore method to retrieve an instance from healthdatastore the below examples show how apps can retrieve appropriate permissions and read data in two styles of programming all requests are processed immediately after moving to a dedicated thread pool, so the caller can invoke the method on any thread however, of the various manners of waiting for the result of asynccompletablefuture or asyncsinglefuture, do not use the sync manner on the main thread synchronous request the below sample code uses suspend functions, showing how to retrieve a step count for a defined time period be careful not to use the synchronous request on the main thread @throws interruptedexception class suspend fun showsteps date localdate, context context { val store = healthdataservice getstore context val requiredpermissions mutableset<permission> = hashset listof permission of datatypes steps, accesstype read // this checks if the app has the user's permission for the target data types if areallpermissionsobtained store, requiredpermissions { val stepsresponse = getaggregateresult store, date stepsresponse datalist foreach { val steps = it value // this processes the value } } } @throws interruptedexception class private suspend fun areallpermissionsobtained store healthdatastore, permissions set<permission> boolean { try { // an api call to check the granted permissions val initialresult set<permission> = store getgrantedpermissions permissions if !initialresult containsall permissions { val requiredpermissions = permissions tomutableset apply { removeall initialresult } // an api call for a permission request val obtainedresult = store requestpermissions requiredpermissions, this context if obtainedresult containsall requiredpermissions { return true } } else { return true } } catch error healthdataexception { if error is resolvableplatformexception && error hasresolution { log i tag, error tostring error resolve this context // an exception to indicate that the samsung health app is not ready to serve the specified operation } else if error is authorizationexception { log i tag, error tostring // an exception to indicate that the app is not authorized to perform the specified operation } else if error is invalidrequestexception { log i tag, error tostring // an exception to indicate that the app requests the specified operation with invalid conditions } else if error is platforminternalexception { log i tag, error tostring // an exception to indicate that the samsung health app experienced an internal error // that cannot be resolved by the app } } return false } private suspend fun getaggregateresult store healthdatastore, date localdate dataresponse<aggregateddata<long>> { val stepsrequest aggregaterequest<long> = datatype stepstype total requestbuilder setlocaltimefilterwithgroup localtimefilter of date atstartofday , date plusdays 1 atstartofday , localtimegroup of localtimegroupunit minutely, 30 build // an api call for an aggregate request return store aggregatedata stepsrequest }content copied to clipboard asynchronous request this manner returns `asynccompletablefuture` or `asyncsinglefuture` the actual requests are processed immediately after moving to a dedicated thread pool, so the method can be invoked on any thread to get a query result, processing `futures` using sync manner on the main thread is not recommended @throws interruptedexception class fun showsteps date localdate, context activity { log i tag, "showsteps async" this context = context val store = healthdataservice getstore context val requiredpermissions mutableset<permission> = hashset listof permission of datatypes steps, accesstype read // this checks the user's permissions for the target data types runonallpermissionsobtained store, requiredpermissions { val stepsresponse = getaggregateresult store, date stepsresponse datalist foreach { val steps = it value // this processes the value log i tag, "step count $steps" } } } private fun runonallpermissionsobtained store healthdatastore, permissions set<permission>, runnable runnable { // an asynchronous api call to check if the correct permissions are granted store getgrantedpermissionsasync permissions setcallback looper getmainlooper , consumer { initialresult set<permission> -> if !initialresult containsall permissions { val requiredpermissions = permissions tomutableset apply { removeall initialresult } // an asynchronous api call for a permission request store requestpermissionsasync permissions, context setcallback looper getmainlooper , consumer { obtainedresult -> if !obtainedresult containsall requiredpermissions { return@consumer } runnable run } { error -> if error is resolvableplatformexception && error hasresolution { error resolve context } } } else { runnable run ; } } { error -> if error is resolvableplatformexception && error hasresolution { error resolve context // an exception to indicate that the samsung health app is not ready to serve the specified operation } else if error is authorizationexception { // an exception to indicate that the app is not authorized to perform given operation } else if error is invalidrequestexception { // an exception to indicate that the app requests the given operation with invalid conditions } else if error is platforminternalexception { // an exception to indicate that the samsung health app experienced an internal error // that cannot be resolved by the app } } } private fun getaggregateresult store healthdatastore, date localdate dataresponse<aggregateddata<long>> { val stepsrequest = datatype stepstype total requestbuilder setlocaltimefilterwithgroup localtimefilter of date atstartofday , date plusdays 1 atstartofday , localtimegroup of localtimegroupunit minutely, 30 build // an asynchronous api call for an aggregate request return store aggregatedataasync stepsrequest get }content copied to clipboardsince1 0 0 membersmembers & extensions functions aggregate link copied to clipboard suspend fun <t any, s aggregaterequest builder<t>> healthdatastore aggregate aggregateoperation aggregateoperation<t, s>, builder suspend s -> s? = null dataresponse<aggregateddata<t>>aggregates a set of data in the samsung health app with simplified code it enables you to request an aggregate operation for a specific data type with building an aggregaterequest easily to aggregate data asynchronously, use healthdatastore aggregatedataasync aggregatedata link copied to clipboard abstract suspend fun <t any> aggregatedata request aggregaterequest<t> dataresponse<aggregateddata<t>>aggregates a set of the samsung health app's data according to the specified request aggregatedataasync link copied to clipboard abstract fun <t any> aggregatedataasync request aggregaterequest<t> asyncsinglefuture<dataresponse<aggregateddata<t>>>aggregates a set of samsung health data according to the specified request delete link copied to clipboard suspend fun <t datapoint> healthdatastore delete type datatype writeable<t>, builder suspend deletedatarequest basicbuilder -> deletedatarequest basicbuilder deletes a set of data from the samsung health app with simplified code it enables you to delete health data with a specific data type and building a deletedatarequest easily to delete data asynchronously, use healthdatastore deletedataasync deletedata link copied to clipboard abstract suspend fun deletedata request deletedatarequest delete a set of data in the request into the samsung health app deletedataasync link copied to clipboard abstract fun deletedataasync request deletedatarequest asynccompletablefuturedelete a set of data in the request into the samsung health getdevicemanager link copied to clipboard abstract fun getdevicemanager devicemanagerretrieves the devicemanager object for information about the devices that provide the health data stored in the samsung health getgrantedpermissions link copied to clipboard abstract suspend fun getgrantedpermissions permissions set<permission> set<permission>returns the specified set of granted permissions getgrantedpermissionsasync link copied to clipboard abstract fun getgrantedpermissionsasync permissions set<permission> asyncsinglefuture<set<permission>>returns the specified set of granted permissions insert link copied to clipboard suspend fun <t datapoint> healthdatastore insert type datatype writeable<t>, builder suspend insertdatarequest basicbuilder<t> -> insertdatarequest basicbuilder<t> inserts a set of data into the samsung health app with simplified code it enables you to insert health data with a specific data type and building an insertdatarequest easily to insert data asynchronously, use healthdatastore insertdataasync insertdata link copied to clipboard abstract suspend fun <t datapoint> insertdata request insertdatarequest<t> inserts a set of data in the request into the samsung health app insertdataasync link copied to clipboard abstract fun <t datapoint> insertdataasync request insertdatarequest<t> asynccompletablefutureinserts a set of data in the request into the samsung health read link copied to clipboard suspend fun <t datapoint, s readdatarequest builder<t>> healthdatastore read type datatype readable<t, s>, builder suspend s -> s? = null dataresponse<t>reads a set of data in the samsung health app with simplified code it enables you to read health data with a specific data type and building a readdatarequest for that data type easily to read data asynchronously, use healthdatastore readdataasync readassociateddata link copied to clipboard abstract suspend fun readassociateddata request associatedreadrequest dataresponse<associateddatapoints>reads a set of associated data for a certain target data according to the given request readassociateddataasync link copied to clipboard abstract fun readassociateddataasync request associatedreadrequest asyncsinglefuture<dataresponse<associateddatapoints>>reads asynchronously a set of associated data for a certain target data according to the given request readchange link copied to clipboard suspend fun <t datapoint> healthdatastore readchange type datatype changereadable<t>, builder suspend changeddatarequest basicbuilder<t> -> changeddatarequest basicbuilder<t> dataresponse<change<t>>reads a set of changed data in the samsung health app with simplified code it enables you to read changed health data with a specific data type and building a changeddatarequest for that data type easily to read changed data asynchronously, use healthdatastore readchangesasync readchanges link copied to clipboard abstract suspend fun <t datapoint> readchanges request changeddatarequest<t> dataresponse<change<t>>reads a set of changes made in the samsung health app's data according to the specified request readchangesasync link copied to clipboard abstract fun <t datapoint> readchangesasync request changeddatarequest<t> asyncsinglefuture<dataresponse<change<t>>>reads a set of changes made in the samsung health data according to the specified request readdata link copied to clipboard abstract suspend fun <t datapoint> readdata request readdatarequest<t> dataresponse<t>reads a set of the samsung health app's data according to the specified request readdataasync link copied to clipboard abstract fun <t datapoint> readdataasync request readdatarequest<t> asyncsinglefuture<dataresponse<t>>reads a set of the samsung health app's data according to the specified request requestpermissions link copied to clipboard abstract suspend fun requestpermissions permissions set<permission>, activity activity set<permission>requests a data permission popup to be displayed for the user to grant a specified set of permissions requestpermissionsasync link copied to clipboard abstract fun requestpermissionsasync permissions set<permission>, activity activity asyncsinglefuture<set<permission>>requests a data permission popup to be displayed for the user to grant a specified set of permissions update link copied to clipboard suspend fun <t datapoint> healthdatastore update type datatype writeable<t>, builder suspend updatedatarequest basicbuilder<t> -> updatedatarequest basicbuilder<t> updates a set of data in the samsung health app with simplified code it enables you to update health data with a specific data type and building a updatedatarequest easily to update data asynchronously, use healthdatastore updatedataasync updatedata link copied to clipboard abstract suspend fun <t datapoint> updatedata request updatedatarequest<t> updates a set of data, represented by the request into the samsung health app's database updatedataasync link copied to clipboard abstract fun <t datapoint> updatedataasync request updatedatarequest<t> asynccompletablefutureupdates a set of data in the request into the samsung health

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data/-health-data-store/index.html

Develop Health

doc

Process

app creation process creating a wear os app is available with the samsung health sensor sdk a galaxy watch is also needed to develop and run the app find target device information more here sdk download download the samsung health sensor sdk and check the sdk content samsung health sensor sdk v1 4 1 70 8 kb enabling the developer mode you can check the sdk operation by turning on the health platform's developer mode notethe health platform's developer mode is intended solely for app development purposes it should not be used for your app users if you want to run your app without utilizing the developer mode, please submit the partner request developing your app create you app with importing the sdk library if you encounter any issue using the sdk, please submit your query on the developer support partner request to distribute your app please submit partner request before your app distribution your app's information including the app package name and signature sha-256 can be registered in the samsung health's system after an approval otherwise, the app using the samsung health sensor sdk works only with the developer mode turned on our partnership is an exclusive service for the samsung health sensor sdk that allows users to discover engaging health and fitness apps

https://developer.samsung.com/health/sensor/process.html

Develop Health

api

Overview

samsung health data sdk/com samsung android sdk health data helper package-level declarations typesfunctions types datautilhelper link copied to clipboard object datautilhelpercontains helper methods sdkversion link copied to clipboard object sdkversionindicates the version code and version name of the sdk functions aggregate link copied to clipboard suspend fun <t any, s aggregaterequest builder<t>> healthdatastore aggregate aggregateoperation aggregateoperation<t, s>, builder suspend s -> s? = null dataresponse<aggregateddata<t>>aggregates a set of data in the samsung health app with simplified code it enables you to request an aggregate operation for a specific data type with building an aggregaterequest easily to aggregate data asynchronously, use healthdatastore aggregatedataasync delete link copied to clipboard suspend fun <t datapoint> healthdatastore delete type datatype writeable<t>, builder suspend deletedatarequest basicbuilder -> deletedatarequest basicbuilder deletes a set of data from the samsung health app with simplified code it enables you to delete health data with a specific data type and building a deletedatarequest easily to delete data asynchronously, use healthdatastore deletedataasync insert link copied to clipboard suspend fun <t datapoint> healthdatastore insert type datatype writeable<t>, builder suspend insertdatarequest basicbuilder<t> -> insertdatarequest basicbuilder<t> inserts a set of data into the samsung health app with simplified code it enables you to insert health data with a specific data type and building an insertdatarequest easily to insert data asynchronously, use healthdatastore insertdataasync read link copied to clipboard suspend fun <t datapoint, s readdatarequest builder<t>> healthdatastore read type datatype readable<t, s>, builder suspend s -> s? = null dataresponse<t>reads a set of data in the samsung health app with simplified code it enables you to read health data with a specific data type and building a readdatarequest for that data type easily to read data asynchronously, use healthdatastore readdataasync readchange link copied to clipboard suspend fun <t datapoint> healthdatastore readchange type datatype changereadable<t>, builder suspend changeddatarequest basicbuilder<t> -> changeddatarequest basicbuilder<t> dataresponse<change<t>>reads a set of changed data in the samsung health app with simplified code it enables you to read changed health data with a specific data type and building a changeddatarequest for that data type easily to read changed data asynchronously, use healthdatastore readchangesasync update link copied to clipboard suspend fun <t datapoint> healthdatastore update type datatype writeable<t>, builder suspend updatedatarequest basicbuilder<t> -> updatedatarequest basicbuilder<t> updates a set of data in the samsung health app with simplified code it enables you to update health data with a specific data type and building a updatedatarequest easily to update data asynchronously, use healthdatastore updatedataasync

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data.helper/index.html

Develop Health

api

DeviceManager

samsung health data sdk/com samsung android sdk health data/devicemanager devicemanager interface devicemanagerit retrieves information about the devices that provide the health data stored in the samsung health app for instance, when a user measures their heart rate using the samsung health app on their galaxy watch paired with an android phone, the data is automatically transferred from the watch to the phone and stored in the phone's samsung health app, with the watch listed as the source device for the data you can later filter the data by various parameters, such as device id, device type, and device manufacturer for example, to list all watches that provided the data stored in the samsung health app, you can use the following code val devicemanager = healthdatastore getdevicemanager val devices = devicemanager getdevices devicegroup watch devices foreach { device -> val deviceid = device id val devicetype = device devicetype val devicemanufacturer = device manufacturer val devicemodel = device model val devicename = device name }content copied to clipboardsince1 0 0 members functions getdevice link copied to clipboard abstract suspend fun getdevice deviceid string device?retrieves the device object corresponding to the specified device id getdeviceasync link copied to clipboard abstract fun getdeviceasync deviceid string asyncsinglefuture<device?>retrieves the device object corresponding to the specified device id it works asynchronously using asyncsinglefuture getdevicebyseed link copied to clipboard abstract suspend fun getdevicebyseed seed string device?retrieves the device object corresponding to the specified seed getdevicebyseedasync link copied to clipboard abstract fun getdevicebyseedasync seed string asyncsinglefuture<device?>retrieves the device object corresponding to the specified seed it works asynchronously using asyncsinglefuture getdevices link copied to clipboard abstract suspend fun getdevices devicetype devicetype list<device>retrieves a list of devices that have provided the data stored in the samsung health app among the devices used, corresponding to specific devicetype getdevicesasync link copied to clipboard abstract fun getdevicesasync devicetype devicetype asyncsinglefuture<list<device>>retrieves a list of devices that have provided the data stored in the samsung health app among the devices used, corresponding to specific devicetype it works asynchronously using asyncsinglefuture getdevicesbymanufacturer link copied to clipboard abstract suspend fun getdevicesbymanufacturer manufacturer string list<device>retrieves a list of devices corresponding to the specific manufacturer that provide the data stored in the samsung health app getdevicesbymanufacturerasync link copied to clipboard abstract fun getdevicesbymanufacturerasync manufacturer string asyncsinglefuture<list<device>>retrieves a list of devices corresponding to the specific manufacturer that provide the data stored in the samsung health app it works asynchronously using asyncsinglefuture getdevicesbymodel link copied to clipboard abstract suspend fun getdevicesbymodel model string list<device>retrieves a list of devices corresponding to the specific device model that provide the data stored in the samsung health app getdevicesbymodelasync link copied to clipboard abstract fun getdevicesbymodelasync model string asyncsinglefuture<list<device>>retrieves a list of devices corresponding to the specific device model that provide the data stored in the samsung health app it works asynchronously using asyncsinglefuture getlocaldevice link copied to clipboard abstract suspend fun getlocaldevice deviceretrieves the device object that the samsung health app is running on getlocaldeviceasync link copied to clipboard abstract fun getlocaldeviceasync asyncsinglefuture<device>retrieves the device object that the samsung health app is running on it works asynchronously using asyncsinglefuture getowndevices link copied to clipboard abstract suspend fun getowndevices list<device>retrieves a list of devices registered by the app that calls it getowndevicesasync link copied to clipboard abstract fun getowndevicesasync asyncsinglefuture<list<device>>retrieves a list of devices registered by the app that calls it it works asynchronously using asyncsinglefuture registerdevice link copied to clipboard abstract suspend fun registerdevice request deviceregistrationrequest stringregisters a device as the source device that provided the health data registerdeviceasync link copied to clipboard abstract fun registerdeviceasync request deviceregistrationrequest asyncsinglefuture<string>registers a device as the source device that provided the health data it works asynchronously using asyncsinglefuture

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data/-device-manager/index.html

Develop Health

api

HealthDataResolver.UpdateRequest.Builder

overviewpackageclasstreedeprecatedindex 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 of the local time range in milliseconds its minimum value is long min_value end - the end time of the local time range in milliseconds 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

Overview

samsung health data sdk/com samsung android sdk health data request/insertdatarequest insertdatarequest class insertdatarequest<t datapoint> parcelableinsertrequestrepresents a request for inserting healthdatapoint which app creates to the samsung health app the fields vary for each data type they are listed in each data type as a form of field for example, com samsung android sdk health data request datatype nutritiontype has com samsung android sdk health data request datatype nutritiontype meal_type, com samsung android sdk health data request datatype nutritiontype calories, and so on mandatory fields should be included in all the input data points and values should be in the valid range specified in each field description this class can be instantiated by its builders obtained from getinsertrequestbuilder method that each data type provides, not directly by a constructor if there is no such a method, the data type does not support apps to write data because it is read-only since1 0 0 members types basicbuilder link copied to clipboard class basicbuilder<t datapoint>a basic builder to create an insertdatarequest instance properties datalist link copied to clipboard val datalist list<t>the list of health data to insert datatype link copied to clipboard val datatype datatypethe data type of this request

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data.request/-insert-data-request/index.html

Develop Health

api

delete()

samsung health data sdk/com samsung android sdk health data helper/delete delete suspend fun <t datapoint> healthdatastore delete type datatype writeable<t>, builder suspend deletedatarequest basicbuilder -> deletedatarequest basicbuilder deletes a set of data from the samsung health app with simplified code it enables you to delete health data with a specific data type and building a deletedatarequest easily to delete data asynchronously, use healthdatastore deletedataasync when deleting multiple data, the data deletion process handles each one sequentially if one data deletion fails, none of them are deleted only data provided by the app can be deleted for example, if the data is recorded by the samsung health app, only the samsung health app can delete it since1 0 0parameterstypea data type to be deleted buildera lambda function to build the deletedatarequest according to the data type

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data.helper/delete.html

Develop Health

api

HealthDataService

samsung health data sdk/com samsung android sdk health data/healthdataservice healthdataservice object healthdataservicethe entry point for connecting to the samsung health data store since1 0 0 members functions getstore link copied to clipboard @jvmstaticfun getstore context context healthdatastoregets a healthdatastore instance that binds to the samsung health fun getstore context context, coroutinescope coroutinescope? = coroutinescope dispatchers default + coroutinename "healthstore" healthdatastorecreates a healthdatastore instance that binds to the samsung health

https://developer.samsung.com/health/data/api-reference/-shd/com.samsung.android.sdk.health.data/-health-data-service/index.html

Didn’t find what you were looking for?

FAQ

Search frequently asked
questions
by keywords.

Join the Forum

Visit the Forum to ask
questions and exchange
ideas with other developers.

Get Support

Submit a 1:1 Support request
and receive a response
within 2 business days.

Preferences Submitted

You have successfully updated your cookie preferences.