Dev Insight 2025년 4월: Samsung Health Accessory SDK의 기능 업데이트, 삼성 IAP Unity 플러그인 v6.3.0 출시 및 최신 소식

Measure Blood Oxygen Level on Galaxy Watch

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

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

Partnering with Pharma to Conduct Research and Create Novel Therapies

advancements in medical research and technology are transforming the pharmaceutical industry by accelerating drug development, enabling personalized medicine, and enhancing patient care through ai, big data, and advanced diagnostics. samsung health collects and analyzes valuable health data from users’ daily activities. using sensors in galaxy smartphones and wearables, it tracks fitness activities, sleep cycles, nutrition, and more. when combined, this data offers a comprehensive, data-driven view of an individual’s overall health. when studied in depth, these insights can serve as a crucial resource for researchers, helping them better understand health conditions and explore how pharmaceutical interventions can improve wellness. one key area of study is sleep disturbances, a common and disruptive symptom among menopausal women. however, the causes of these disturbances remain insufficiently understood, and existing sleep aids often prove ineffective. to bridge this knowledge gap, samsung health has partnered with bayer to conduct an observational study on sleep disturbances in menopausal women. with access to one of the world’s largest collections of biometric data from wearable devices, samsung is uniquely positioned to enhance research in women's health with real-world evidence. by analyzing sleep patterns, heart rate variability, and overall well-being, samsung health can help bayer gain deeper insights into women's health, enabling the development of targeted and meaningful treatment options at various life stages. this research aims to expand treatment options and improve sleep solutions for those experiencing menopause-related sleep issues. technology plays a vital role in advancing clinical studies and medical research by providing real-time data and analytics from everyday activities, ultimately shaping better health outcomes.

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 3 0 2 47 mb 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 partnership request

FAQs

faq what are the benefits of the samsung health research stack? samsung health research stack provides end-to-end solutions for collecting and analyzing data from wearable devices in android and wear os environments and allows developers to design advanced health and wellness applications developers can also build research study portal which acts as a centralized hub for managing every facet of research studies, from enrollment to compliance how do i get access to the samsung health research stack? you can learn about accessing samsung health research stack here here what devices are compatible with samsung health research stack? the galaxy watch 5 and later has been tested for compatibility with this tech stack is it possible to contribute to samsung health research stack? yes, as an open-source project, samsung health research stack welcomes contributions from the developer community if you'd like to contribute, check out contributing to the open source project here how can i modify the ui on the starter-app? you can customize the ui by modifying the presentation package classes in starter mobile/wearable app specifically, you can edit the files in starter-mobile-app/src/main/kotlin/researchstack/presentation/ for theme or color changes, update the theme/appcolors kt file are the screens and flows for the mobile app available in android studio? yes, the screens and flows for the mobile app are available in android studio, and they are not configured in the container and backend how does data synchronization work in the app? the app uses android workmanager for periodic data sync once the user permits the use of their health data and finishes logging in, workmanager is initialized and periodically syncs health data from healthconnect to the backend, even when the app is not open what is the minimum interval for data sync, and can it be manually triggered? the least interval that can be set for data sync is 15 minutes workmanager cannot be manually triggered; it operates based on the configuration is it expected for data to only be pushed when the app is engaged? no, once workmanager is initialized, it syncs data periodically even when the app is not engaged various sequences of opening and closing the researchsample app and samsung health may trigger data transfer, but workmanager operates independently based on the configuration how do i modify the ui of the web portal? you might need to change ui materials before building the container please, contact our support to get a more precise answer how can i capture more types of health data from samsung health? there are two steps specify the app’s permissions for health connect in the health_permissions xml file, and add healthdatasyncspecs to mainactivity kt the healthconnectadapter currently supports 11 types of health data alternatively, you could utilize samsung health sdks what should i do if the account verification email is not sent when creating a web portal account? ensure that smtp access is activated on the account and that outbound calls on the corresponding smtp port are allowed from your server if using 2-factor authentication 2fa , try signing in with an app password if not, you might need to allow less secure apps to access your account what could cause authentication issues when sending emails from the account service? if you are using 2-factor authentication 2fa , try signing in with an app password if it does not work, you might need to allow less secure apps to access your account where can i find logs or monitor the workmanager for debugging? you can briefly monitor the workmanager in the "app inspection" tab in android studio how can i monitor and troubleshoot workmanager for data synchronization? you can monitor workmanager in the "app inspection" tab in android studio this can help you check if data sync is happening as expected and identify any issues how can i change the configuration for data synchronization? the data synchronization process is handled by workmanager, and the interval for data sync is set in the configuration you can modify this configuration according to your needs, but the minimum interval that can be set is 15 minutes missing google-services json file in the source code if you want to use firebase to provide a 3rd party login to users the google-services json file must be included in the source code a reference to integrate it can be found here need guidance on backend installation for the app the app fetches project information such as surveys and activity tasks from the backend for testing, it's recommended to follow the backend installation guide instead of integrating your own backend system detailed instructions can be found here how to capture and export accelerometry continuously, not just during the activity task? the app regularly sends health data logged by health connect at intervals that can be set by the user for sensor data related to each activity task, it's collected & synced when the activity is conducted specific activity tasks and their associated sensor types are provided what data types from health connect can be utilized? the app can utilize all data types supported by health connect by modifying the list of healthdatarequired, you can adjust the app to collect additional data types recorded by health connect however, to have data input, that data needs to exist in health connect resolution to /gradlew clean failing for app-sdk? this appears to be an issue with the system failing to communicate with the gradle plugin repository ensure that your system is online, and if you're using a proxy environment, check proxy settings if a proxy is in use, the issue might be an ssl handshake failure check ssl settings and proxy configurations

HealthDataResolver.ReadRequest.Builder

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

HealthPermissionManager

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

Code Lab | Samsung Developers

code lab code lab is an education platform that engages anyone to understand, through a series of topics, the entirety of the sdks and tools powered by samsung. all tags all tags in-app purchase implement in-app subscriptions using samsung iap 30 mins start watch face studio design a watch face with customizable edge complication slots and digital clock 30 mins start in-app purchase add samsung in-app purchase service to your app 30 mins start watch face studio get creative with weather data in watch face studio 30 mins start sdc24 health build a health app with steps from samsung health and its connected wearables 30 mins start sdc24 health access rich sleep data from samsung health measured by galaxy wearables 30 mins start sdc24 smartthings create a smartthings edge driver for an iot bulb 30 mins start sdc24 smartthings develop a smartthings find-compatible device 30 mins start sdc24 smartthings test edge drivers using smartthings test suite 30 mins start sdc24 health research stack establish a health research system using samsung health research stack 30 mins start sdc24 samsung pay samsung wallet integrate samsung pay web checkout with merchant sites 30 mins start sdc24 samsung pay samsung wallet integrate samsung pay sdk flutter plugin into merchant apps for in-app payment 30 mins start sdc24 samsung wallet utilize add to samsung wallet service for digital cards 30 mins start sdc24 samsung wallet verify your id with samsung wallet 30 mins start sdc24 automotive create an android automotive operating system (aaos) app with payments via samsung checkout 30 mins start watch face studio apply gyro effects to a watch face using watch face studio 20 mins start sdc23 smartthings matter: create a virtual device and make an open source contribution 25 mins start sdc23 smartthings matter: build a matter iot app with smartthings home api 25 mins start sdc23 galaxy z develop a widget for flex window 25 mins start sdc23 samsung pay samsung wallet integrate in-app payment into merchant apps using samsung pay sdk 30 mins start sdc23 gamedev optimize game performance with adaptive performance in unity 30 mins start sdc23 gamedev galaxy z implement flex mode into a unity game 30 mins start sdc23 watch face studio customize styles of a watch face with watch face studio 30 mins start sdc23 watch face studio galaxy z customize flex window using good lock plugin on watch face studio 20 mins start sdc23 health measure skin temperature on galaxy watch 20 mins start sdc23 health transfer heart rate data from galaxy watch to a mobile device 30 mins start watch face studio design a watch face using mask and moon phase tags 30 mins start sdc22 bixby smartthings control a smart bulb 30 mins start sdc22 watch face studio apply conditional lines on watch faces 20 mins start sdc22 health measure blood oxygen level on galaxy watch 30 mins start sdc22 health measure blood oxygen level and heart rate on galaxy watch 40 mins start sdc22 galaxy z implement multi-window picture-in-picture on a video player 20 mins start sdc22 samsung blockchain transfer erc20 token with blockchain app 45 mins start sdc22 galaxy ar emoji gamedev use ar emoji on games and 3d apps 60 mins start sdc22 gamedev galaxy z implement flex mode on an unreal engine game 120 mins start sdc22 smartthings integrate iot devices into the smartthings ecosystem 45 mins start health create a daily step counter on galaxy watch 40 mins start health track deadlift exercise on galaxy watch 40 mins start watch face studio create a watch face using tag expressions 60 mins start galaxy z implement flex mode on a video player 30 mins start galaxy z implement app continuity and optimize large screen ui of a gallery app 40 mins start galaxy z configure an app to enable copy and paste in multi-window 30 mins start galaxy z configure an app to enable drag and drop in multi-window 30 mins start galaxy s pen remote implement keyevent.callback by mapping air actions 30 mins start galaxy s pen remote handle s pen's raw data 30 mins start samsung blockchain develop a secure blockchain app 40 mins start samsung blockchain develop a blockchain shopping app 40 mins start

Transfer heart rate data from Galaxy Watch to a mobile device

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