create a daily step counter on galaxy watch objective create a native app for galaxy watch, operating on wear os powered by samsung, using health platform to read your daily steps. overview health platform provides a unified and straightforward way for accessing a wide range of health and wellness related data. with health platform api, you may easily read and write data stored in health platform on android and wear os powered by samsung. applications can have access to these secured data only with explicit user consent. additionally, users may disable access to the data at any point in time. see health platform descriptions for detailed information. set up your environment you will need the following: galaxy watch4 or newer android studio (latest version recommended) java se development kit (jdk) 11 or later sample code here is a sample code for you to start coding in this code lab. download it and start your learning experience! health step count sample code (119.87 kb) turn on developer mode and adjust its settings on your watch, go to settings > about watch > software and tap on software version 5 times. upon successful activation of developer mode, a toast message will display as on the image below. afterwards, developer options will be visible under settings. tap developer options and enable the following options: adb debugging debug over wi-fi turn off automatic wi-fi connect your galaxy watch to wi-fi go to settings > connection > wi-fi and make sure that wi-fi is enabled. from the list of available wi-fi networks, choose and connect to the same one as your pc. when successfully connected, tap a wi-fi network name, swipe down, and note the ip address. you will need this to connect your watch over adb from your pc. connect your galaxy watch to android studio in android studio, go to terminal and type: adb connect <ip address as mentioned in previous step> when prompted, tap always allow from this computer to allow debugging. upon successful connection, you will see the following message in android studio’s terminal: connected to <ip address of your watch> now, you can run the app directly on your watch. start your project after downloading the sample code containing the project files, in android studio click open to open existing project. locate the downloaded android project (stepcount) from the directory and click ok. check dependency and app manifest in the dependencies section of stepcount/app/build.gradle file, see the appropriate dependency for health platform. dependencies { implementation com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01' // ... } notelibrary might update from time to time. if necessary, choose the version suggested by android studio. request for data permissions before accessing any data through health platform, the client app must obtain necessary permissions from the user. in permissions.java, create a permission instance to trigger relevant permission screen and obtain required consent from end user. data type name: intervaldatatypes.steps read access: accesstype.read /******************************************************************************************* * [practice 1] build permission object grand permissions for read today's steps * - set interval data type of steps * - set read access type ------------------------------------------------------------------------------------------- * - (hint) uncomment lines below and fill todos with * (1) for interval data type: intervaldatatypes.steps * (2) for read access: accesstype.read ******************************************************************************************/ permission stepsreadpermission = permission.builder() //.setdatatype("todo 1 (1)") //.setaccesstype("todo 1 (2)") .build(); make a query to aggregate today’s steps create read request with all necessary information to read data through health platform api. the answer from the platform will be asynchronous with the result from which you can get all the data you are interested in. follow the steps below to get today's steps count: in stepsreader.java, create a readaggregateddatarequest with cumulativeaggregationspec instance: data type name: intervaldatatypes.steps /******************************************************************************************* * [practice 2] build read aggregated data request object for read today's steps * - set interval data type of steps ------------------------------------------------------------------------------------------- * - (hint) uncomment line below and fill todo 2 with * (1) for interval data type: intervaldatatypes.steps ******************************************************************************************/ readaggregateddatarequest readaggregateddatarequest = readaggregateddatarequest.builder() .settimespec( timespec.builder() .setstartlocaldatetime(localdatetime.now().with(localtime.midnight)) .build()) //.addcumulativeaggregationspec(cumulativeaggregationspec.builder("todo 2 (1)").build()) .build(); read cumulative steps count from cumulativedata: set variable steps value to 0l. it is the count of daily steps. get aggregatedvalue object using cumulativedata api. cumulativedataaggregateddata representing total of intervaldata over a period of time (e.g. total steps in a day). public aggregatedvalue gettotal () check the result. if it is not null, get aggregated value using aggregatedvalue api: aggregatedvaluevalue fields aggregated over a period of time. only numeric fields (longfield, doublefield) can be included in aggregation. public long getlongvalue () returns all longfields and their values that are already set. add value to the daily steps result counter. /******************************************************************************************* * [practice 3] read aggregated value from cumulative data and add them to the result * - get aggregatedvalue from cumulativedata object * - get steps count from aggregatedvalue object ------------------------------------------------------------------------------------------- * - (hint) uncomment lines below and replace todo 3 with parts of code * (1) get aggregatedvalue object 'obj' using cumulativedata.gettotal() * (2) get value using obj.getlongvalue() and add to the result ******************************************************************************************/ long steps = 0l; if(result != null) { list<cumulativedata> cumulativedatalist = result.getcumulativedatalist(); if (!cumulativedatalist.isempty()) { for(cumulativedata cumulativedata : cumulativedatalist) { //"todo 3 (1)" //"todo 3 (2)" } } } return steps; run unit tests for your convenience, you will find an additional unit tests package. this will let you verify your code changes even without using a physical watch. see instruction below on how to run unit tests: right click on com.samsung.sdc21.stepcount (test) and execute run 'tests in 'com.samsung.sdc21.stepcount'' command. if you completed all the tasks correctly, you will see all the unit tests passed successfully. run the app after building the apk, you can run the application on a connected device to see real-life aggregated steps count measured by a smartwatch. right after the app is started, it will request for the user permission. allow the app to receive data of the activity. afterwards, the application main screen will be shown. it will automatically display today’s step count. tap on refresh button to read current steps count from health platform. you're done! congratulations! you have successfully achieved the goal of this code lab. now, you can create a daily step counter app by yourself! if you're having trouble, you may download this file: health step count complete code (119.79 kb) learn more by going to health platform.

measure skin temperature on galaxy watch with samsung privileged health sdk objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung privileged health sdk to obtain skin temperature measurement results. partnership request in this code lab, you will use a specially prepared mock library. it has limited functionality and uses dummy data instead of real-time data. you will need the full version of the samsung privileged health sdk library to get real values, which is available to samsung partners. apply as a partner by checking out the partner app program for exclusive samsung privileged health sdk access. overview samsung privileged health 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 active sensor of galaxy watch runs powerful health sensors such as photoplethysmogram (ppg), electrocardiogram (ecg), bioelectrical impedance analysis (bia), sweat loss, and spo2. see samsung privileged health sdk descriptions for detailed information. set up your environment you will need the following: galaxy watch5 or newer with updated health platform 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! skin temperature tracking sample code (123.64 kb) notethis code lab uses mock library, which has limited functionality with dummy data. data from the mock library is not from the galaxy watch’s real sensor data. you need a full version of the samsung privileged health sdk library to get actual values and it's only available to registered partners. the code lab works using a mock library on the galaxy watch4 or newer, while the official library works using galaxy watch5 or newer. 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 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 this step is only applicable to registered partners of samsung privileged health sdk. you can replace priv-health-tracking-mock-2023.aar in app > libs with the real library to receive real sensor data with the application. this requires health platform to be set in developer mode: 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 after downloading the sample code containing the project files, open your android studio and click open to open an existing project. locate the downloaded android project (skintemptracking) from the directory and click ok. check tracking capabilities to track the data with the sdk, the device must support skin temperature, like the galaxy watch5. skin temperature tracking can work in 2 modes: batching and on-demand. the tracker type for batching is healthtrackertype.skin_temperature_continuous and healthtrackertype.skin_temperature for on-demand. in this code lab, you are going to use on-demand tracker. in connectionmanager.java, navigate to isskintemperatureavailable() function. use a provided healthtrackingservice object to create a healthtrackercapability instance, and send it to checkavailabletrackers() function, and assign its result to availabletrackers list. gettrackingcapability() returns a healthtrackercapability instance in 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 healthtrackertype list. /****************************************************************************************** * [practice 1] check capabilities to confirm skin temperature availability * * ---------------------------------------------------------------------------------------- * * (hint) replace todo 1 with java code * get healthtrackercapability object from healthtrackingservice * send the object to checkavailabletrackers() ******************************************************************************************/ boolean isskintemperatureavailable(healthtrackingservice healthtrackingservice) { if (healthtrackingservice == null) return false; @suppresswarnings("unusedassignment") list<healthtrackertype> availabletrackers = null; //"todo 1" if (availabletrackers == null) return false; else return availabletrackers.contains(healthtrackertype.skin_temperature); } initialization of skin temperature tracker before starting the measurement, initialize the skin temperature tracker by creating a healthtracker object. in skintemperaturelistener.java, navigate to setskintemperaturetracker(). using the provided healthtrackingservice object, create an instance of the healthtracker class of skin_temperature type and assign it to the skintemperaturetracker object. gethealthtracker() with healthtrackertype.skin_temperature as an argument creates a healthtracker instance after a single measurement, the tracker should be stopped when using on-demand measurement. for continuous measurement, use healthtrackertype.skin_temperature_continuous healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype. healthtracker gethealthtracker(healthtrackertype healthtrackertype) create a healthtracker instance for the given healthtrackertype. /******************************************************************************************* * [practice 2] setup skin temperature tracker * * ---------------------------------------------------------------------------------------- * * (hint) replace todo 2 with java code * initialize skintemperaturetracker with proper samsung privileged health sdk functionality * call gethealthtracker() on healthtrackingservice object * use healthtrackertype.skin_temperature as an argument ******************************************************************************************/ void setskintemperaturetracker(healthtrackingservice healthtrackingservice) { //"todo 2" } starting and stopping the tracker for the client app to obtain the data through the sdk, set a listener method on healthtracker. this method is called every time there is new data. healthtrackerhealthtracker enables an application to set an event listener and get tracking data for a specific healthtrackertype. public void seteventlistener(healthtracker.trackereventlistener listener) set an event listener to the healthtracker instance. void starttracker() { if (!ishandlerrunning) { skintemperaturehandler.post(() -> skintemperaturetracker.seteventlistener(skintemperaturelistener)); ishandlerrunning = true; } } after the finished measurement, the on-demand tracker should be stopped. you can do that by unsetting the event listener from healthtracker. healthtrackerhealthtracker enables an application to set an event listener and get tracking data for a specific healthtrackertype. public void unseteventlistener() stop the registered event listener to this healthtracker instance. void stoptracker() { if (skintemperaturetracker != null) skintemperaturetracker.unseteventlistener(); skintemperaturehandler.removecallbacksandmessages(null); ishandlerrunning = false; } process obtained skin temperature data the answer from the healthtrackingservice is asynchronous. the skintemperaturelistener receives the callback containing a data point with all the required information. follow the steps below to get skin temperature data: in skintemperaturelistener.java, go to the updateskintemperature() function and read skin temperature data from datapoint: get skin temperature status using datapoint api (key: valuekey.skintemperatureset.status). get skin temperature value using datapoint api (key: valuekey.skintemperatureset.object_temperature). get ambient temperature value using datapoint api (key: valuekey.skintemperatureset.ambient_temperature) datapointdatapoint provides a map of valuekey and value with a timestamp. public <t>t getvalue(valuekey<t>type) get data value for the given key. private final healthtracker.trackereventlistener skintemperaturelistener = new healthtracker.trackereventlistener() { @override public void ondatareceived(@nonnull list<datapoint> list) { stoptracker(); for (datapoint data : list) { updateskintemperature(data); } } }; /******************************************************************************************* * [practice 3] read values from datapoint object * - get skin temperature status value * - get wrist skin temperature value - it's named "object_temperature" in the library * - get ambient temperature value ------------------------------------------------------------------------------------------- * - (hint) replace todo 3 with parts of code * (1) remove skintemperaturestatus.invalid_measurement and * set status from 'datapoint' object using data.getvalue(valuekey.skintemperatureset.status) * * if status is 'skintemperaturestatus.successful_measurement' then: * (2) set wristskintemperaturevalue from 'datapoint' object using: * data.getvalue(valuekey.skintemperatureset.object_temperature); * (3) set ambienttemperaturevalue from 'datapoint' object using: * data.getvalue(valuekey.skintemperatureset.ambient_temperature); ******************************************************************************************/ void updateskintemperature(datapoint data) { final int status = skintemperaturestatus.invalid_measurement; float wristskintemperaturevalue = 0; float ambienttemperaturevalue = 0; //"todo 3" trackerdatasubject.notifyskintemperaturetrackerobservers(status, ambienttemperaturevalue, wristskintemperaturevalue); } run unit tests for your convenience, you will find an additional unit tests package. this will let you verify your code changes even without using a physical watch. see the instruction below on how to run unit tests: right click on com.samsung.health.skintemptracking (test) and execute run 'tests in 'com.samsung.health.skintemptrackin" command. if you have completed all the tasks correctly, you can see all the unit tests pass successfully. run the app after building the apk, you can run the application on a connected device to measure your skin temperature. once the app starts, allow the app to receive data from the body sensors. afterwards, the screen shows the application. tap the measure button to get your skin temperature. to stop measuring, 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 skin temperature by yourself! if you face any trouble, you may download this file: skin temperature tracking complete project (123.09 kb) to learn more about samsung health, visit: developer.samsung.com/health

measure blood oxygen level on galaxy watch objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung privileged health sdk to trigger and obtain blood oxygen level (spo2) measurement results. partnership request in this code lab, you will use a specially prepared mock library. it has limited functionality and uses dummy data instead of real-time data. to get real values, you will need the full version of the samsung privileged health sdk library, which is available to registered samsung partners. apply as a partner by checking out the partner app program to get exclusive access to the samsung privileged health sdk. overview samsung privileged health 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 privileged health 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 (122.49 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 this step is only applicable to registered partners of samsung privileged health sdk. you can replace priv-health-tracking-mock-2023.aar in app/libs with the real library to receive real sensor data with the application. this requires health platform to be set in developer mode: 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 after downloading the sample code containing the project files, 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 privileged health 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); } check connection error resolution using samsung privileged health 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 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 privileged health sdk functionality * call gethealthtracker() on healthtrackingservice object * use healthtrackertype.spo2 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 (117.81 kb) to learn more about samsung health, visit: developer.samsung.com/health

transfer heart rate data from galaxy watch to a mobile device with samsung privileged health sdk 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. partnership request in this code lab, you will use a specially prepared mock library. it has limited functionality and uses dummy data instead of real-time data. you will need the full version of the samsung privileged health sdk library to get real values, which is available to samsung partners. apply as a partner by checking out the partner app program for exclusive samsung privileged health sdk access. overview with this code lab, you can measure various health data using samsung privileged health sdk and send it to a paired android mobile device for further processing. using a paired mobile device will make the data more organized by taking advantage of a bigger screen and saving health data to a local database or remote server. see samsung privileged health sdk descriptions for detailed information. set up your environment you will need the following: galaxy watch4 or newer, powered by wear os 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 (196.70 kb) notethis code lab uses mock library, which has limited functionality with dummy data. data from the mock library is not from the galaxy watch’s real sensor data. you need a full version of the samsung privileged health sdk library to get actual values and it's only available to registered partners. 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 this step is only applicable to registered partners of samsung privileged health sdk. you can replace priv-health-tracking-mock-2023.aar in app > libs with the real library to receive real sensor data with the application. this requires health platform to be set in developer mode: 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 after downloading the sample code containing the project files, in android studio click open to open an existing project. locate the downloaded android project (hrdatatransfer-code-lab) from the directory and click ok. parse data from the watch after opening the sample project, you need to parse the ibi data collected while tracking the heart rate-related data. 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 the wear > java > data > com.samsung.health.hrdatatransfer. 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 it up so it can send data to a paired android mobile device. first, check if the devices within range have proper capabilities. the capability data type is a string and is used when sending a message on both devices. go to the wear > java > com.samsung.health.hrdatatransfer > data. in capabilityrepositoryimpl.kt, and fill in the function below: /************************************************************************************** * [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 } the purpose of this exercise is to identify which nodes have the exact capability you are looking for (represented by capability argument). you need those nodes later to send the message to them. 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. go to the 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 } 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. do the same step with the mobile module. 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 project (195.74 kb) to learn more about samsung health, visit: developer.samsung.com/health

measure blood oxygen level and heart rate on galaxy watch objective create a health app for galaxy watch, operating on wear os powered by samsung, utilizing samsung privileged health sdk to trigger and obtain results of simultaneous blood oxygen level (spo2) and heart rate measurements. partnership request in this code lab, you will use a specially prepared mock library. it has limited functionality and uses dummy data instead of real-time data. to get real values, you will need the full version of the samsung privileged health sdk library, which is available to samsung partners. apply as a partner by checking out the partner app program to get exclusive access to the samsung privileged health sdk. overview samsung privileged health 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 privileged health 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 and heart rate sample code (135.23 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 this step is only applicable to registered partners of samsung privileged health sdk. you can replace priv-health-tracking-mock-2023.aar in app/libs with the real library to receive real sensor data with the application. this requires health platform to be set in developer mode: 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 after downloading the sample code containing the project files, in android studio click open to open existing project. locate the downloaded android project from the directory and click ok. establish service connection and check capabilities for the device to track data with the samsung privileged health sdk, it must connect to the service by healthtrackingservice api. after establishing a connection, verify if the required tracker type is available. to check this, get the list of available tracker types and verify that the tracker is on the list. in this code lab, you will utilize blood oxygen level and heart rate trackers. the healthtrackingservice api usage is in the table below. healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype. public void connectservice() establish a connection with samsung's health tracking service. public void disconnectservice() release a connection for samsung's health tracking service. public healthtrackercapability gettrackingcapability() provide a healthtrackercapability instance to get a supporting health tracker type list. initialize multiple trackers before the measurement starts, initialize the spo2 tracker by obtaining the proper health tracker object. in the connectionmanager.java file, navigate to initspo2(), create an oxygen saturation healthtracker instance, and pass it to the spo2listener instance. get the healthtracker object using the healthtrackingservice api. use the healthtrackertype.spo2 type as parameter. healthtrackingservicehealthtrackingservice initiates a connection to samsung's health tracking service and provides a healthtracker instance to track a healthtrackertype. public healthtracker gethealthtracker(healthtrackertype healthtrackertype) provide a healthtracker instance for the given healthtrackertype. pass the healthtracker object to the spo2listener instance object. spo2listener public void sethealthtracker(healthtracker tracker) set healthtracker instance for the given tracker. /******************************************************************************************* * [practice 1] create blood oxygen level health tracker object * - get health tracker object * - pass it to spo2listener ------------------------------------------------------------------------------------------- * - (hint) replace todo 1 with parts of code * (1) get healthtracker object using healthtrackingservice.gethealthtracker() * use healthtrackertype.spo2 type as parameter * (2) pass it to spo2listener using sethealthtracker function ******************************************************************************************/ public void initspo2(spo2listener spo2listener) { //"todo 1 (1)" //"todo 1 (2)" sethandlerforbaselistener(spo2listener); } next, in the connectionmanager.java file, in the initheartrate() function, create a heart rate healthtracker instance, and pass it to the heartratelistener instance. get the healthtracker object using the healthtrackingservice api. use the healthtrackertype.heart_rate type as parameter. pass the healthtracker object to the heartratelistener instance object. heartratelistener public void sethealthtracker(healthtracker tracker) set healthtracker instance for the given tracker. /******************************************************************************************* * [practice 2] create heart rate health tracker object * - get health tracker object * - pass it to heartratelistener ------------------------------------------------------------------------------------------- * - (hint) replace todo 2 with parts of code * (1) get healthtracker object using healthtrackingservice.gethealthtracker() * use healthtrackertype.heart_rate type as parameter * (2) pass it to heartratelistener using sethealthtracker function ******************************************************************************************/ public void initheartrate(heartratelistener heartratelistener) { //"todo 2 (1)" //"todo 2 (2)" sethandlerforbaselistener(heartratelistener); } start and stop trackers for the client app to start obtaining the data through the sdk, set a listener method on healthtracker. this method will be called every time there is new data. after the measurement completes, the listener has to be disconnected. to start measurement in the baselistener.java file, navigate to starttracker() function, and set trackereventlistener as listener healthtracker object. set an event listener on healthtracker object using healthtracking api. use the healthtracker.trackereventlistener object instance as parameter. healthtrackerhealthtracker enables an application to set an event listener and get tracking data for a specific healthtrackertype. public void seteventlistener(healthtracker.trackereventlistener listener) set an event listener to this healthtracker instance. /******************************************************************************************* * [practice 3] start health tracker by setting event listener * - set event listener on health tracker ------------------------------------------------------------------------------------------- * - (hint) replace todo 3 with parts of code * set event listener on healthtracker object using healthtracker.seteventlistener() * use trackereventlistener object as parameter ******************************************************************************************/ public void starttracker() { log.i(app_tag, "starttracker called "); log.d(app_tag, "healthtracker: " + healthtracker.tostring()); log.d(app_tag, "trackereventlistener: " + trackereventlistener.tostring()); if (!ishandlerrunning) { handler.post(() -> { //"todo 3" sethandlerrunning(true); }); } } to stop measurement, unset the trackereventlistener from the healthtracker object in the stoptracker() function. unset the event listener on healthtracker object using healthtracking api. healthtrackerhealthtracker enables an application to set an event listener and get tracking data for a specific healthtrackertype. public void unseteventlistener() stop the registered event listener to this healthtracker instance. /******************************************************************************************* * [practice 4] stop health tracker by removing event listener * - unset event listener on health tracker ------------------------------------------------------------------------------------------- * - (hint) replace todo 4 with parts of code * unset event listener on healthtracker object using healthtracker.unseteventlistener() ******************************************************************************************/ public void stoptracker() { log.i(app_tag, "stoptracker called "); log.d(app_tag, "healthtracker: " + healthtracker.tostring()); log.d(app_tag, "trackereventlistener: " + trackereventlistener.tostring()); if (ishandlerrunning) { //"todo 4" sethandlerrunning(false); handler.removecallbacksandmessages(null); } } process obtained and batching data the response from the platform will be asynchronous with the results you want to obtain. follow the steps below to get blood oxygen level and heart rate data. in the spo2listener.java file, navigate to updatespo2() function, and read spo2 data from datapoint: get the oxygen saturation status using the datapoint api (key: valuekey.spo2set.status). get the oxygen saturation value using the datapoint api (key: valuekey.spo2set.spo2). datapointdatapoint provides a map of valuekeyand value with a timestamp. public <t>t getvalue(valuekey<t> type) get data value for the given key. /******************************************************************************************* * [practice 5] read values from datapoint object * - get blood oxygen level status * - get blood oxygen level value ------------------------------------------------------------------------------------------- * - (hint) replace todo 5 with parts of code * (1) remove spo2status.calculating and * set status from 'datapoint' object using datapoint.getvalue(valuekey.spo2set.status) * (2) set spo2value from 'datapoint' object using datapoint.getvalue(valuekey.spo2set.spo2) * if status is 'spo2status.measurement_completed' ******************************************************************************************/ public void updatespo2(datapoint datapoint) { int status = spo2status.calculating; //"todo 5 (1)" int spo2value = 0; //"todo 5 (2)" trackerdatanotifier.getinstance().notifyspo2trackerobservers(status, spo2value); log.d(app_tag, datapoint.tostring()); } in the heartratelistener.java file, navigate to readvaluesfromdatapoint() function, and read the heart rate data from datapoint: get heart rate status using datapoint api (key: valuekey.heartrateset.heart_rate_status). get heart rate value using datapoint api (key: valuekey.heartrateset.heart_rate). get heart rate ibi value using datapoint api (key: valuekey.heartrateset.ibi_list). get ibi quality using datapoint api (key: valuekey.heartrateset.ibi_status_list). /******************************************************************************************* * [practice 6] read values from datapoint object * - get heart rate status * - get heart rate value * - get heart rate ibi value * - check retrieved heart rate’s ibi and ibi quality values ------------------------------------------------------------------------------------------- * - (hint) replace todo 6 with parts of code * (1) set hrdata.status from 'datapoint' object using datapoint.getvalue(valuekey.heartrateset.heart_rate_status) * (2) set hrdata.hr from 'datapoint' object using datapoint.getvalue(valuekey.heartrateset.heart_rate) * (3) set local variable 'list<integer> hribilist' using datapoint.getvalue(valuekey.heartrateset.ibi_list) * (4) set local variable 'final list<integer> hribistatus' using datapoint.getvalue(valuekey.heartrateset.ibi_status_list) * (5) set hrdata.ibi with the last of 'hribilist' values * (6) set hrdata.qibi with the last of 'hribistatus' values ******************************************************************************************/ public void readvaluesfromdatapoint(datapoint datapoint) { heartratedata hrdata = new heartratedata(); //"todo 6 (1)" //"todo 6 (2)" //"todo 6 (3)" //"todo 6 (4)" //"todo 6 (5)" //"todo 6 (6)" trackerdatanotifier.getinstance().notifyheartratetrackerobservers( hrdata); log.d(app_tag, datapoint.tostring()); } 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.multisensortracking (test) and execute run 'tests in 'com.samsung.health.multisensortracking'' 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 see blood oxygen level and heart rate values. 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 and automatically display the heart rate. to get the blood oxygen level (spo2) value, tap on the measure button. to stop the measurement, tap on the stop button. tap on the details label to see more heart rate data. 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 and heart rate by yourself! if you're having trouble, you may download this file: measuring blood oxygen level and heart rate complete code (134.82 kb) to learn more about samsung health, visit: developer.samsung.com/health

overview package class tree deprecated index samsung health android sdk - data api reference 1.5.0 health data this document describes com.samsung.android.sdk.healthdata apis in samsung health sdk for android. see: description packages package description com.samsung.android.sdk.healthdata this package provides classes and interfaces for the health data framework in samsung health sdk for android. health data this document describes com.samsung.android.sdk.healthdata apis in samsung health sdk for android. the health data package contains classes and interfaces which enable you to create applications with the following functionalities. health data store a partner app that uses samsung health sdk for android can write its health data to samsung health or read samsung health's data through the health data store connection. see health data store for more information. health data type the sdk provides useful predefined and custom data types. see health data types for more information. privacy data permission acquisition is required to access a specific data type. see permission manager for more information. for more information related to the development environment, fundamentals, features and sample descriptions, see programming guide. compatible version of samsung health samsung health sdk for android works with samsung health. the sdk's data library works properly with the specific samsung health version. sdk's heath data library version samsung health compatible version 1.5.0 6.12 or above 1.4.0 or above 6.2 or above 6.11 or below 1.3.0 5.11 or above6.1 or below 1.2.01.2.1 5.10 1.0.01.1.0 4.0 or above5.9 or below e.g. if you create your app with the health data library 1.5.0, it requires to install samsung health 6.12 or above in the device. if the sdk and samsung health's version is not matched, the sdk gives an error. old_version_platform you can resolve the error simply and induce the users to update samsung health to the latest version. here is a guide to prevent the related error. connect to the health data store. see healthdatastore.connectservice(). private healthdatastore mstore; @override public void oncreate(bundle savedinstancestate) { // create a healthdatastore instance and set its listener mstore = new healthdatastore(this, mconnectionlistener); // request the connection to the health data store mstore.connectservice(); } if it fails, check healthconnectionerrorresult.onconnectionfailed(). private final healthdatastore.connectionlistener mconnectionlistener = new healthdatastore.connectionlistener() { // ... @override public void onconnectionfailed(healthconnectionerrorresult error) { // ... } if the error is old_version_platform, it means that samsung health needs to be updated to the latest version. show a proper message to the user. @override public void onconnectionfailed(healthconnectionerrorresult error) { if (error.geterrorcode() == healthconnectionerrorresult.old_version_platform) { // show a message to the user to update samsung health } } check a resolution for the error with healthconnectionerrorresult.hasresolution(). if it gives true, resolve the error with healthconnectionerrorresult.resolve(). if (error.hasresolution()) { // if there is a solution, resolve it error.resolve(mainactivity.this); } the samsung health platform leads to upgrade samsung health on the app market. see its example: exception handing

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

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

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

faq q01. which watch devices support the converted watch faces? the converted watch faces are compatible with galaxy watches with wear os powered by samsung, including the galaxy watch 4. q02. how do i distribute my converted watch face? the converted watch faces are compatible with galaxy watches with wear os powered by samsung, including the galaxy watch 4. you can distribute your converted watch face through google play. q03. are there any issues using converted watch faces on a device with a different resolution? a watch face built by the converter automatically scales the screen to fit the new device. this process is automatic and should produce no issues, but it is recommended that you test the face on the new device afterwards as the conversion can result in a loss of quality. q04. what is the author certificate? why it is necessary? the author certificate is a private key file (with the file extension .p12) that you registered when you built the .tpk file on galaxy watch studio. to prevent a non-author from distributing the converted results, the converter requires the author's certificate and password. q05. if a watch face includes health functions that are not supported in galaxy watch studio converter, what happens if i proceed with the conversion? any unsupported health function is not updated, so the displayed value or the object linked to the value will not change on the converted watch face. q06. do you have any plans to improve the features which are not currently supported? the current limitations the converter tool are due to platform differences, making future improvements difficult. for creating watch faces on the new platform, we recommend you use the watch face studio.