Filter

Code Lab 100
Sorry, no results
found for "Code Lab" on the website

Learn Code Lab

codelab

Measure Blood Oxygen Level and Heart Rate on Galaxy Watch

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 health sensor sdk to trigger and obtain results of simultaneous blood oxygen level spo2 and heart rate measurements 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 and heart rate sample code 164 2 kb connect your galaxy watch to wi-fi go to settings > connection > wi-fi and make sure that wi-fi is enabled from the list of available wi-fi networks, choose and connect to the same one as your pc turn on developer mode and adjust its settings on your watch, go to settings > about watch > software and tap on software version 5 times upon successful activation of developer mode, a toast message displays as on the image below afterwards, developer options is going to be visible under settings tap developer options and enable the following options adb debugging in developer options find wireless debugging turn on wireless debugging check always allow on this network and tap allow go back to developer options and click turn off automatic wi-fi notethere may be differences in settings depending on your one ui version connect your galaxy watch to android studio go to settings > developer options > wireless debugging and choose pair new device take note of the wi-fi pairing code, ip address & port in android studio, go to terminal and type adb pair <ip address> <port> <wi-fi pairing code> when prompted, tap always allow from this computer to allow debugging after successfully pairing, type adb connect <ip address of your watch> <port> upon successful connection, you can see the following message in android studio’s terminal connected to <ip address of your watch> now, you can run the app directly on your watch turn on developer mode for health platform swipe down from the top of the screen to open the quick panel, then tap the settings icon scroll down and tap apps select health platform quckly tap health platform for about 10 times developer mode is enabled when [dev mode] appears below health platform noteyou can disable developer mode by quickly tapping the health platform until [dev mode] disappears start your project in android studio, click open to open existing project locate the downloaded android project from the directory and click ok establish service connection and check capabilities for the device to track data with the samsung health sensor 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're going to 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_on_demand 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_on_demand 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_continuous 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_continuous 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 is 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 is 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 heart rate and oxygen saturation 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 163 5 kb to learn more about samsung health, visit developer samsung com/health

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

Learn Code Lab

codelab

Apply gyro effects to a watch face using Watch Face Studio

apply gyro effects to a watch face using watch face studio objective learn how to change the appearance of your watch face as the watch tilts in different directions by applying gyro effects using watch face studio overview watch face studio is a graphical authoring tool that enables you to design watch faces for the wear os smartwatch ecosystem, including galaxy watch4 and newer versions it provides easy and simple features, such as gyro effects, for creating attractive and dynamic watch faces without coding gyro effects are a feature in watch face studio, which uses the watch's gyro sensor to animate or alter the look of watch faces the effects are triggered when the watch is tilted within the -90° to 90° tilt angle range along the x and y axes see illustration below a tilt angle of 0° on both axes indicates that the watch rests on a flat surface the following shows the expected tilt angle values when the watch tilts 90° in different directions direction of tilt tilt angle clockwise along the y-axis or tilt forward y = -90° counterclockwise along the y-axis or tilt backward y = 90° clockwise along the x-axis or tilt to the right x = 90° counterclockwise along the x-axis or tilt to the left x = -90° set up your environment you will need the following watch face studio latest version galaxy watch4 or newer smart watch running on wear os api 30 or higher sample project here is a sample project for you to start coding in this code lab download it and start your learning experience! gyro effects sample project 322 00 kb start your project to load the sample project in watch face studio click open project locate the downloaded file and click open the sample project is a premade watch face design it contains a background image, a digital clock, and a date notein watch face studio, you can add a digital clock component in different formats such as hh, mm, ss, or hh mm ss setting the digital time properties, such as color and dimension, per digit is also possible when you choose a component from variable options the project also contains three ellipses two ellipses with tag expressions in rotate > angle properties to represent the analog time hour and second and one ellipse as the background of the digital hour in the style tab, you can see the watch face's different theme color palettes resize a component when tilted forward or backward as the watch tilts, a component can enlarge or shrink relative to its pivot when applying gyro effects the pivot is the point at the center of the component the component remains at the same position as it gets bigger or smaller select the time background component in properties, you can see that the component's dimension width x height is 100px by 100px select apply gyro to show the properties of gyro effects initially, a component does not resize, move, rotate, or change opacity when you tilt the watch in any direction the gyro effect occurs when you set the changing to properties higher or lower than the default values to resize the component when the watch tilts forward or backward, go to y-axis properties and set the scale width and height to the following 70% for -90° to 0° range 130% for 0° to 90° range in the run pane, you can simulate the rotation of the watch the component enlarges from 100% to 130% as the watch tilts backward and shrinks to 70% as the watch tilts forward notewhen you drag the gyro joystick upward, it simulates the backward rotation of the watch similarly, when you move the joystick downward, it simulates the forward rotation rotate a component when tilted to the left or right in gyro mode, a component can rotate around its pivot when a component rotates, its position remains the same select the digital date component the format of the digital date is a curved text, and its pivot is at the center of the canvas inner pivot x = 225px, inner pivot y = 225px enable gyro effects then, change the rotation angle to -90° for the following tilt angle ranges along the x-axis -90° to 0° 0° to 90° as the watch tilts to the left or right, the date component rotates up to 90° gradually counter-clockwise change the appearance of the background image based on the adjusted tilt angle range range values define how tilted the watch should be for a component to resize, rotate, appear, or move to the maximum value you set for example, when you set the range from 0° to 45° along the x-axis and the scale to 200%, the component will enlarge twice from its original size once the watch reaches the 45° tilt angle to the right select the background image change the opacity of the components to 0° for the following ranges -45° to 0° along the x-axis 0° to 45° along the x-axis -45° to 0° along the y-axis as the watch tilts in any direction other than backward, the background image slowly disappears as it approaches the 45° tilt angle then, for the 0° to 45° range along the y-axis, change the rotation angle to 360° to rotate the background image clockwise as the watch tilts backward test the watch face in the run pane, click the preview watch face icon move the gyro simulator joystick to see how the appearance of time background, digital date, and background image changes to test your watch face on a smartwatch, you need to connect a watch device to the same network as your computer in watch face studio, select run on device select the connected watch device you want to test with if your device is not detected automatically, click scan devices to detect your device or enter its ip address manually by clicking the + button notethe always-on display is already set in the project to run the watch face successfully, you may need to configure its always-on display to avoid any error when you click run on device you’re done! congratulations! you have successfully achieved the goal of this code lab now, you can apply gyro effects using watch face studio to change the appearance of your watch face all by yourself! if you’re having trouble, you may download this file gyro effects complete project 322 02 kb to learn more about watch face studio, visit developer samsung com/watch-face-studio

https://developer.samsung.com/codelab/watch-face-studio/gyro-effects.html

Learn Code Lab

codelab

Access rich sleep data from Samsung Health measured by Galaxy wearables

access rich sleep data from samsung health measured by galaxy wearables objective create a health app for android devices, utilizing the samsung health data sdk to obtain samsung health's rich sleep data overview samsung health offers various features to monitor user health data, including automatic sleep recording the samsung health data sdk grants access to the collected data, allowing developers to filter it based on factors such as the device used or a specific timeframe this sdk obtains comprehensive sleep information, including sleep scores, sleep sessions, sleep stages, and associated data such as skin temperature and blood oxygen levels you can retrieve rich sleep data from samsung health using the samsung health data sdk and apply device and local time filters to refine your queries effectively set up your environment you will need the following android studio latest version recommended java se development kit jdk 17 or later android mobile device compatible with the latest samsung health version sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! health data sleep sample code 666 8 kb set up your android device click on the following links to set up your android device enable developer options run apps on a hardware device activate samsung health's developer mode to enable the developer mode in the samsung health app, follow these steps in the top-right, tap the ⋮ button of samsung health select settings > about samsung health tap the version number quickly 10 times or more if you are successful, the developer mode samsung health data sdk button is displayed select developer mode samsung health data sdk agree with notice of usage of the developer mode for reading data from samsung health with samsung health data sdk, turn on the developer mode for data read now, you can test your app with samsung health notethe samsung health developer mode is only intended for testing or debugging your application it is not for application users start your project in android studio, click open to open an existing project locate the downloaded android project sleepdiary from the directory and click ok check gradle settings before using the samsung health data sdk library, certain configurations are necessary these steps are already applied in the sample code provided the samsung-health-data-api-1 0 0 aar library is added to the app\libs folder, and included as a dependency in the module-level build gradle file in the same file, the gson library is also added as a dependency dependencies { implementation files "libs/samsung-health-data-api-1 0 0 aar" implementation libs gson } next, the kotlin-parcelize plugin is applied plugins { id "kotlin-parcelize" } lastly, the following entries are also added in the gradle > libs version toml file [versions] gson = "2 11 0" [libraries] gson = { module = "com google code gson gson", version ref = "gson" } request sleep data permissions the application requires the appropriate permissions and the user's agreement to share their health data for the app to read their sleep data from samsung health while this code lab focuses solely on datatypes sleep, it is important to recognize that other data types such as skin temperature and blood oxygen levels are also available during sleep these additional data types can be accessed using datatypes skin_temperature and datatypes blood_oxygen respectively go to app > kotlin+java > com samsung health sleepdiary > repository in the healthdatastorerepository kt file, navigate to the preparepermissionset function create a permission object consisting of sleep data type and read access type, and assign it to the sleeppermission variable permission indicates the unit of permission to obtain user consent to share data with the samsung health's data store it's a pair of datatype and accesstype permission companion object of datatype datatype, accesstype accesstype creates a permission /****************************************************************************************** * [practice 1] prepare permission set to receive sleep data * * ---------------------------------------------------------------------------------------- * * use the provided variable 'sleeppermission' which is currently null * create a permission object by calling 'permission of datatype datatype, accesstype accesstype ' function * use data type 'datatypes sleep' and access type 'accesstype read' * assign the permission object to 'sleeppermission' variable ******************************************************************************************/ fun preparepermissionset mutableset<permission> { val permissionset mutableset<permission> = mutablesetof var sleeppermission permission? = null // todo assign the ‘sleeppermission’ variable here using permission class apis sleeppermission? let { permissionset add sleeppermission } return permissionset } prepare a read request for sleep data in order to retrieve sleep data from samsung health, the client app should prepare a readdatarequest object and send it to the healthdatastore this read request includes filters such as localtimefilter or readsourcefilter to ensure that only the desired data is received moreover, if the user wears both a galaxy watch and a galaxy ring while sleeping, samsung health combines the data from both devices to create an integrated sleep session, providing the most accurate sleep data not setting the device filter allows access to the combined data in the healthdatastorerepository kt file, navigate to the preparereadsleeprequest function prepare a read request that retrieves data from a specific day within the past week and includes the option to specify a device filter for either a ring or a watch using the provided localtimefilter object, update the readrequestbuilder object you can take your time to familiarize yourself with the readdatarequest builder creation datatypes sleep readdatarequestbuilder function creates a builder for sleep data type setlocaltimefilter function, called on a builder object, adds a time filter to the request setsourcefilter function, called on a builder object, adds a read source filter to the request with an application filter and a device filter build function, called on a builder object, builds readdatarequest from the configuration of this builder readdatarequest it represents a request for read query over a period of time to get a list of original healthdatapoints readdatarequest dualtimebuilder<t> setlocaltimefilter localtimefilter localtimefilter sets the local time filter of the request readdatarequest dualtimebuilder<t> setsourcefilter sourcefilter readsourcefilter sets the source filter of the request readdatarequest build builds readdatarequest from the configuration of this builder /****************************************************************************************** * [practice 2] prepare a read request for sleep data * * ---------------------------------------------------------------------------------------- * * use the provided variable 'localtimefilter' * set a time filter by calling ' setlocaltimefilter localtimefilter ' on a 'readrequest' builder ******************************************************************************************/ fun preparereadsleeprequest localtimefilter localtimefilter, readsourcefilter readsourcefilter readdatarequest<healthdatapoint> { val readrequest = datatypes sleep readdatarequestbuilder // todo use the 'localtimefilter' variable here to set the time filter setsourcefilter readsourcefilter build return readrequest } learn how to receive a response from samsung health receiving sleep data from samsung health is done by sending a readdatarequest query to the healthdatastore notethis is a blocking call and should not be called from the main thread healthdatastore it is a proxy which provides a way to access samsung health data an application can access the data through operations healthdatastore provides, such as inserting, updating, deleting, reading, and aggregating data a healthdatastore instance can be obtained by healthdataservice getstore method dataresponse<t> abstract suspend fun <t datapoint> readdata request readdatarequest<t> reads a set of data from samsung health according to the given request this method returns the original data point which is not processed or aggregated the code below, which is already included in the project file, shows how to receive a response from samsung health val healthdatalist = healthdatastore readdata readrequest datalist understand how the collected sleep data is processed a sleep healthdatapoint is a specific type of healthdatapoint that contains samsung health sleep data it includes various fields that can be accessed by calling getvalue function on the data point some of the fields include duration - returns a duration object that indicates how long the sleep lasted sleep score - returns the calculated quality of the sleep sessions - returns a list of sessions during the sleep period if the user wakes up during sleep for an extended period, multiple sleep sessions may be generated within a single sleep data point additionally, each session can consist of various sleep stages including light, rem rapid eye movement , deep, or awake the code below, which is already included in the project file, shows how the collected sleep data is processed private fun preparesleepresult healthdata healthdatapoint sleepdata { healthdata let { val score int score = preparesleepscore it ? 0 val duration = it getvalue datatype sleeptype duration ? duration zero val sleepsessionlist = it getvalue datatype sleeptype sessions ? emptylist return sleepdata score, sleepsessionlist size, duration tohours toint , duration minushours duration tohours tominutes toint , it starttime, it endtime, extractsessions sleepsessionlist } } notesamsung health can also measure the user's blood oxygen level and skin temperature during sleep, if supported by the wearable device these values are associated to the sleep data in the samsung health data sdk an application can use the healthdatapoint’s unique id uid to create an associatedreadrequest and retrieve the blood oxygen level and skin temperature data associated with the sleep data point extract sleep score from a health data point most of the data accessible through the samsung health data sdk is stored as fields within data points these fields can be extracted by specifying the appropriate keys in the getvalue function in the healthdatastorerepository kt file, navigate to the preparesleepscore function read the sleep score field from the healthdatapointby by calling the getvalue function with the key datatype sleeptype sleep_score healthdatapoint it indicates each health data record saved in the samsung health's data store <t> t? getvalue field field<t> returns the value of the given field /****************************************************************************************** * [practice 3] extract a sleep score from the sleep data * * ---------------------------------------------------------------------------------------- * * use the provided variable 'sleepscore' * extract a sleep score from a health data point by calling 'healthdatapoint getvalue ' function * use field 'datatype sleeptype sleep_score' as an argument * assign the obtained sleep score to 'sleepscore' variable ******************************************************************************************/ fun preparesleepscore healthdatapoint healthdatapoint int? { var sleepscore int? = null // todo assign the 'sleepscore' variable here by extracting sleep score from 'healthdatapoint' return sleepscore } run unit tests for your convenience, an additional unit tests package is provided this package lets you verify your code changes even without using a physical phone right-click on com samsung health sleepdiary test > run 'tests in 'com samsung health sleepdiary' 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 read your sleep data once the app starts, allow all permissions to read sleep data from samsung health and tap done afterwards, the app's main screen appears, displaying today's sleep data from all connected devices you can use the calendar or device filter to show sleep data from a different day or a specific device you can tap on any sleep data to see the list of sessions you can tap on any session to see details such as sleep stages you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a mobile health app that reads samsung health rich sleep data by yourself! if you are having trouble, you may download this file health data sleep complete code 666 4 kb to learn more about samsung health, visit developer samsung com/health

https://developer.samsung.com/codelab/health/sleep-data.html

Learn Code Lab

codelab

Create an Android Automotive Operating System (AAOS) app with payments via Samsung Checkout

create an android automotive operating system aaos app with payments via samsung checkout objective create a shopping app for android automotive os aaos , which uses templates from aaos and ignite store, and processes payments via the ignite payment sdk powered by samsung checkout partnership request to use the ignite payment sdk and have access to development tools and resources, such as ignite aaos emulators, you must become an official partner once done, you can fully utilize this code lab you can learn more about the partnership process by visiting the ignite store developer portal overview android automotive os android automotive os aaos is a base android platform that runs directly on the car and is deeply integrated with the underlying vehicle hardware unlike the android auto platform, users can download compatible apps with aaos directly into their cars, without needing a phone, and utilize an interface specifically designed for the car screen aaos can run both system and third-party android applications as aaos is not a fork and shares the same codebase as android for mobile devices, developers can easily adapt existing smartphone apps to function on aaos the diagram below illustrates the architecture of aaos at the hardware abstraction layer hal level, aaos incorporates additional components such as the vehicle hal vhal , exterior view system evs , and broadcast radio br to handle vehicle properties and connectivity at the framework level, car service and webview modules are included at the application level, the main system applications include car system ui, car launcher, and car input method editor ime additionally, car media and automotive host are incorporated as system apps third-party apps are classified into three categories audio media, car templated, and parked car templates the car templated apps use templates specified by the car app library, which are rendered by the automotive host, customized by original equipment manufacturers oem the library consists of approximately 10 templates list, grid, message, pane, navigation and is utilized in both android auto aa and android automotive os aaos apps to target aaos, you must incorporate an additional app-automotive library that injects the carappactivity into the app the carappactivity needs to be included in the manifest and can be set as distractionoptimized upon launching the application, the carappactivity provides a surface that is employed by the automotive host to render the template models additionally, on the harman ignite store, you can optionally integrate the ignite-car-app-lib, which adds supplementary templates such as explore, listdetails, routeoverview, and poistreaming harman ignite store the harman ignite store is a white-labeled and modular aaos-based automotive app store by connecting app developers with car manufacturers, harman creates unique in-vehicle experiences the ignite store has a rich app ecosystem with unique content, growth opportunities, and long-term partnerships it facilitates future-proof monetization with a payments api powered by samsung checkout after registering at the ignite store developer portal, developers can submit their apps for certification and testing by harman upon approval from the oem, the developer can proceed with publishing their app comprehensive developer documentation and tools are available to support app developers throughout the development process payments api the ignite store comes enabled with payment features empowering developers to monetize their apps developers are now able to offer their apps as paid apps the payment sdk exposes apis for goods and services, in-app purchases, and subscriptions developers can also integrate their own payment service providers psps , to sell goods or services, and receive the money directly in their bank account for a frictionless in-car payment experience, ignite provides a dedicated digital wallet app for end-users to securely store their credit card information the payment processor is powered by the industry proven samsung checkout the developer portal provides additional documentation to allow developers to access ignite aaos emulators, vim3, tablet or cuttlefish ignite images, and additional guidelines set up your environment you will need the following ignite aaos system image running on android emulator or on reference devices 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! aaos ignite shopping app sample code 11 7 mb prepare your ignite aaos emulator add the ignite aaos emulator to your android studio by following the guide provided in the ignite store developer console open the device manager and start the emulator configure the emulator to use fake data for payments, as instructed in the ignite store developer console under the offline mode tab in the payment sdk section the sample app requires navigation from point a starting location to point b destination location the destination addresses are predefined and near san jose mcenery convention center to shorten the distance between two locations, follow the steps below to set the starting location a open the extended controls in the emulator panel b go to location, search for a location near the destination location, and click set location next, in the emulator, go to the ignite navigation app's settings and enable the following enable navigation simulation enable mock location provider go to settings > system > developer options > location and set ignite navigation as mock location app 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 igniteautomotivepaymentssdc202488 from the directory and click ok check the ignite payment sdk dependency verify that the ignite payment sdk library is included in the dependencies section of the module's build gradle file dependencies { implementation files 'libs/ignite-payment-sdk-3 13 0 24030417-0-snapshot aar' } add payment permission next, go to the manifests folder and, in the androidmanifest xml file, include the payment_request permission to perform in-app purchases <uses-permission android name="com harman ignite permission payment_request" /> this ensures that the app has the necessary permissions to perform transactions and handle sensitive financial data show the payment screen when an item is added to the cart, the shopping cart screen displays the select store button, selected pickup store address, total amount to pay, and details of each item added the screen also includes the pay button go to kotlin + java > com harman ignite pickupstore > screens > shoppingcartscreen kt in the docheckout function, use the car app's screenmanager to navigate to the payment screen from the shopping cart screen after clicking the pay button getscreenmanager push paymentscreen carcontext, session notethe screenmanager class provides a screen stack you can use to push screens that can be popped automatically when the user selects a back button in the car screen or uses the hardware back button available in some cars instantiate the ignite payment client the ignite payment api provides a singleton class called ignitepaymentclientsingleton, which enables performing and tracking transactions navigate to the paymentscreen kt file and instantiate the ignite payment client private val mipc = ignitepaymentclientsingleton getinstance carcontext define the ignite payment transaction callback the ignite payment transaction provides three callback methods onsuccess, oncanceled, and onfailure after each callback, make sure to set the ispaymentfailed variable to track whether a payment is successful or not update the session which owns the shopping cart screen to reflect the status of the payment transaction call the updatetemplate function to invalidate the current template and create a new one with updated information private val mipctcb = object iignitepaymentclienttransactioncallback { override fun onsuccess requestuuid string?, sessionid string?, successmessage string?, paymentadditionalproperties hashmap<string, string>? { log d tag, log_prefix + "onsuccess rid $requestuuid, sid $sessionid, sm $successmessage" cartoast maketext carcontext, "payment successful", cartoast length_short show ispaymentfailed = false session paymentdone requestuuid, sessionid, successmessage updatetemplate } override fun oncanceled requestuuid string?, sessionid string? { log d tag, log_prefix + "oncanceled rid $requestuuid, sid $sessionid" cartoast maketext carcontext, "payment canceled", cartoast length_long show ispaymentfailed = true session paymenterror requestuuid, sessionid, null updatetemplate } override fun onfailure requestuuid string?, sessionid string?, wallererrorcode int, errormessage string { log d tag, log_prefix + "onfailure rid $requestuuid, sid $sessionid, wec $wallererrorcode, em $errormessage" cartoast maketext carcontext, "payment failed", cartoast length_long show ispaymentfailed = true session paymenterror requestuuid, sessionid, errormessage updatetemplate } } define the ignite payment client connection callback the ignite payment client needs to be connected in order to perform a payment request once the client connects successfully, retrieve the names of the shopping cart items and use them to create an order summary afterwards, construct an ignite payment request containing the total amount, currency code, merchant id, and details of the order summary then, initiate the payment process by invoking the readytopay function of the ignite payment client api private val mipccb = iignitepaymentclientconnectioncallback { connected -> log d tag, log_prefix + "onpaymentclientconnected $connected" if connected { val textsummary = session shoppingcart cartitems jointostring ", " { item -> item name } val ipr = ignitepaymentrequest builder setamount session shoppingcart gettotal * 100 setcurrencycode currencycode usd setpaymentoperation paymentoperation purchase setmerchantid constants merchant_id setordersummary ordersummary builder setordersummarybitmapimage bitmapfactory decoderesource carcontext resources, session shoppingcart store largeicon setordersummarylabel1 "${carcontext getstring r string pickupstore_app_title } ${session shoppingcart store title}" setordersummarysublabel1 session shoppingcart store address setordersummarylabel2 textsummary setordersummarysublabel2 carcontext getstring r string pickupstore_payment_sublabel2 build build try { mipc readytopay ipr, mipctcb } catch e exception { log d tag, log_prefix + "payment exception $e" e printstacktrace } catch e error { log d tag, log_prefix + "payment error $e" e printstacktrace } } } start the payment process and go back to previous screen after the transaction next, in the startpayment function, connect the ignite payment client and the connection callback to start the payment process mipc connect mipccb after the transaction is completed, the updatetemplate function refreshes the template used in the payment screen before calling the schedulegoback function modify the schedulegoback function to navigate back to the previous template screen shopping cart you can use the pop method of the screenmanager screenmanager pop start the navigation to the store to collect the paid pickup the shopping cart screen shows the pickup store location, details of the order, and go to store button after a successful payment go to kotlin + java > com harman ignite pickupstore > pickupstoresession kt modify the navigatetostore geofence geofence function to trigger the navigation to the pickup store when the go to store button is clicked you can use the intent carcontext action_navigate with geo schema rfc 5879 data, containing latitude and longitude e g , geo 12 345, 14 8767 to send the intent, use the carcontext startcarapp api call val geouristring = "geo ${geofence latitude},${geofence longitude}" val uri = uri parse geouristring val navintent = intent carcontext action_navigate, uri try { carcontext startcarapp navintent } catch e exception { log e tag, log_prefix + "navigatetostore exception starting navigation" e printstacktrace cartoast maketext carcontext, "failure starting navigation", cartoast length_short show } run the app on ignite aaos emulator run the pickup-store-app on ignite aaos emulator when the app starts for the first time, it requests for user permissions click grant permissions choose allow all the time for location permission and click the return button 4 browse the pickup store catalog and add items to shopping cart open the shopping cart and click pay you can also change the pickup store by clicking select store check the order summary and billing information then, click confirm and pay to process payment after a successful payment, the app returns to shopping cart screen with the updated transaction information click go to store to start the navigation to the store the app displays a notification when the car is near the store click the notification to show a reference qr code to present to the store upon pick up you're done! congratulations! you have successfully achieved the goal of this code lab topic now, you can create an aaos templated app, which supports payments by yourself! if you're having trouble, you may download this file aaos ignite shopping app complete code 11 7 mb learn more by going to the developer console section of the ignite store developer portal

https://developer.samsung.com/codelab/automotive/in-vehicle-app.html

tutorials foldable, mobile

blog

Best Practices of App Development for Various Screen Sizes—Powered by Good Lock

due to the large variety of android devices, supporting multiple screen sizes and display modes is an essential part of modern android application development. a responsive and adaptable ui provides a seamless user experience for people using the application on different devices, such as phones, foldables, and tablets. this article offers some tips and tricks for developing adaptable applications that support features specific to foldable and large screen devices: displaying widgets and applications on the cover screen adapting applications to flex mode adapting applications to multi-window mode display widgets and applications on the cover screen using good lock one of the biggest strengths of android devices is customization. with good lock, users can customize one ui to cater to their individual needs, such as adding widgets to the cover screen. in august 2023, samsung released the galaxy z flip5, a foldable smartphone with a cover screen display. the 3.4-inch cover screen can be used to provide the user direct access to the most important information and functionality of their applications. it also offers new opportunities for customization and personalization. the cover screen is designed to display customizable widgets, such as clocks, wallpapers, notification lists, and calendars. for basic information about creating android widgets, see create a simple widget. you can also create widgets for your application that can be displayed on the cover screen. for example, if you are developing a messaging application, you can enhance your application by creating a widget that displays recent or unread messages on the cover screen. to enable displaying your widget on the galaxy z flip5 cover screen (also called the flex window): create a new xml resource file inside your application's res/xml folder. paste the following code to configure your widget's display for the flex window:<samsung-appwidget-provider display="sub_screen"> </samsung-appwidget-provider> in your project's manifest file, add the metadata for the xml file you just created inside the <receiver> element for your application widget:<meta-data android:name="com.samsung.android.appwidget.provider" android:resource="@xml/samsung_meta_info_sample_widget" /> in the xml file containing the metadata for your application widget, change the attributes of your widget to these recommended values:<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:initiallayout="@layout/test_widget" android:minheight="352dp" android:minwidth="339dp" android:resizemode="vertical|horizontal" android:widgetcategory="keyguard"> </appwidget-provider> when the application is installed, your widget appears on the list of cover screen widgets on the device. the user can display the widget on the flex window by going to settings > cover screen > widgets and selecting the widget from the list. to learn more about widget development for the cover screen, see the develop a widget for flex window code lab. although the cover screen is primarily meant for widgets, users can also use the multistar application in good lock to launch full applications on the cover screen. to launch an application on the cover screen: install good lock from galaxy store. in the good lock application, go to life up > multistar > i ♡ galaxy foldable > launcher widget. from the list, select the application you want to launch on the cover screen and tap enable launcher widget. it is vital that your applications can adapt to small screens as much as large screens. the next two sections briefly summarize how to adapt your applications to both flex mode and multi-window mode. adapt your application to flex mode constraint layout is recommended for implementing responsive ui in your applications. constraint layout gives you a flat view hierarchy, avoiding troublesome nested views. you can assign a relative size and distance between viewgroups, so the components scale based on the device that the application is running on. let's say you want to create an application that displays a list of pictures in the middle of the screen, equally spaced. to do this, you can use guidelines, which are virtual guides that help you to align views. to add guidelines and adapt your ui to it: in android studio, go to helpers > guideline(horizontal) or guideline(vertical) and drag guidelines onto your layout. change the value of app:layout_constraintguide_begin from a static value to a percentage value. align your views to the new guidelines by constraining them to the guidelines. for more information on implementing layouts using guidelines and a demonstration, see design a single responsive layout for foldable phones using android guidelines. you can also use android's jetpack windowmanager library, which supports various form factors, including multi-window, to provide support for flex mode in your application: add the following dependencies to the application's build.gradle file: implementation "androidx.window:window:1.0.0" implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.6.1" set a lifecycle-aware task that can obtain window layout information from the windowlayoutinfo object. the checkandupdatestate() function is used to update your ui. pass the newlayoutinfo object to this function and make the appropriate changes. lifecyclescope.launch(dispatchers.main) { lifecycle.repeatonlifecycle(lifecycle.state.started) { windowinfotracker.getorcreate(this @mainactivity) .windowlayoutinfo(this @mainactivity) .collect { newlayoutinfo -> checkandupdatestate(newlayoutinfo) } } } the windowlayoutinfo object contains a displayfeatures object that contains the current state of your application. the displayfeatures object also contains the foldingfeature interface, which describes device states and orientations specific to foldable devices: if the displayfeatures object is null, the device is closed or folded. if foldingfeature.state is half_opened and foldingfeature.orientation is vertical, the device is a galaxy flip device in flex mode. if foldingfeature.state is half_opened and foldingfeature.orientation is horizontal, the device is a galaxy fold device in flex mode. if foldingfeature.state is flat, the device is fully open. for more information about adapting your ui for various device states and orientations, see make your app fold aware. to configure your application for the current window size, whether it is portrait, landscape, folded, unfolded, multi-window or any other mode, override the onconfigurationchanged() function and retrieve the current window size from the windowmetricscalculator interface. override fun onconfigurationchanged(newconfig: configuration) { super.onconfigurationchanged(newconfig) val windowmetrics = windowmetricscalculator.getorcreate() .computecurrentwindowmetrics(this@mainactivity) val bounds = windowmetrics.getbounds() ... } to learn more about implementing flex mode in an existing android project, see implement flex mode on a video player in code lab. adapt your application to multi-window mode multi-window mode and app continuity are key foldable device features that contribute to a more versatile and user-friendly experience. they enhance multitasking capabilities and overall usability of applications across multiple form factors. multi-window mode enables using two or more applications simultaneously on the same screen. applications can also be used in pop-up view, as a movable pop-up on top of another open application. to implement support for multi-window mode and app continuity: add the following attributes to the <activity> element in your androidmanifest.xml file: android:configchanges="screensize|smallestscreensize|screenlayout" android:resizeableactivity="true" adding these flags to the configchanges attribute accounts for every relevant device configuration change, creating a more foldable-aware ui. setting resizeableactivity to true allows the activity to be launched in split-screen and pop-up mode. to remember the application state before configuration changes, you need to use lifecycle-aware components: you can save your previous application state in a bundle inside the onsaveinstancestate() function as key-value pairs. you can then check if a saved application state exists inside the oncreate() function. if the savedinstancestate bundle is null, there is no saved application state. if it is not null, you can retrieve the previous application state and update the ui accordingly. for more information, see foldable adaptation essentials: app continuity and multi-window handling. alternatively, you can use viewmodels. a viewmodel allows you to store the application's ui state, and also provides access to its core business logic. to create a viewmodel, create a separate class that extends the viewmodel class and initialize mutablestate objects that can store the state. create an instance of your viewmodel in your activity's oncreate() function and use it to update your ui elements. for more information, see how to update your apps for foldable displays. if you do not want to support multi-window mode in your application, you can simply set resizeableactivity to false in the <activity> element inside the androidmanifest.xml file. conclusion this article describes some key practices for creating a responsive and adaptable ui for your application, such as enabling cover screen widgets and implementing flex mode and multi-window mode. following these practices ensures a versatile and user-friendly experience on foldable android devices, enhancing multitasking capabilities and the overall usability of applications across various form factors. related content foldables and large screens develop a widget for flex window implement flex mode on a video player galaxy z documentation

Samiul Hossain

https://developer.samsung.com/sdp/blog/en-us/2024/01/09/best-practices-of-app-development-for-various-screen-sizespowered-by-good-lock

Learn Code Lab

codelab

Customize styles of a watch face with Watch Face Studio

customize styles of a watch face with watch face studio objective learn how to easily customize the style of a watch face using the customization editor in watch face studio know how to make your watch face respond to your step count using conditional lines overview watch face studio is a graphic authoring tool that enables you to create watch faces for wear os it offers a simple and intuitive way to add images and components, and to configure the watch movement without any coding watch face studio supports watch faces for the galaxy watch4 or newer version, and other watch devices that run on the same platform the style in watch face studio allows you to modify the style of the selected layer you can define image styles and theme color palettes that the user can choose from to customize their watch the customization editor in wfs enables you to refine, organize, name, and preview the styles you have defined for the watch conditional lines let you show and hide components on your watch face and control the behavior of the components use conditional lines to change the look of your watch face in response to certain conditions, such as the time and event, such as unread notifications set up your environment you will need the following watch face studio galaxy watch4 or newer smart watch running on wear os3 or higher sample project here is a sample project for this code lab download it and start your learning experience! style customization sample project 385 30 kb start your project download the sample project file, and click open project in watch face studio locate the downloaded sample project, and then click open add styles to the watch hands and index styles can be added for image-based layers such as icons, index, and hand component layers the watch face supports up to 10 image styles in the style tab, add a file of the same type as the existing image in the layer select the watch hand named min_hand click on the style tab click the + button to add more minute hands simply select the first three images repeat the previous steps for the hour hand and index create style sets go to the style tab and click on customization editor select min_hand, hour_hand, and index_line merge these by using right-click on your mouse change the name of the style sets using text id click on text id of the previously merged style set then, click the add new button set the id name to id_time and the default value to time then, click ok now, you can change the name of your style set click again on the text id and search for the id name that you just set here, the name and default value for your style set are changed finally, repeat the same thing for the background merge the other components to make a single background using the text id, change the name of the style set to id_background and the default value to background modify the theme color palette the theme color palette is a set of colors that you can use on a specific design component each palette can have up to three colors the watch face supports up to 30 theme colors here, you add a new set of colors for the month component go to the style tab under the theme color palette, click the + button choose a color from the palette you can change the other two colors by clicking on the color box preview your watch face using customization editor at this point, you have created custom styles for the watch hands and index, background, and color you can use the run pane and customization editor to preview how the watch face looks like when changing different styles open the run pane in a separate window and click customization editor in the customization editor, you can see the three tabs background, color, and time go to each tab and preview the different custom styles that you’ve created use conditional lines for step count use the conditional lines to make the step count on your watch face respond to certain conditions here, you want to show different images depending on the step count percentage 0% to 20%, 21% to 80%, and 81% to 100% click on the + button and select steps as a conditional line click on the steps icon to view the default conditional lines for all components select the sc_initial component then, double-click on the layer of its conditional line a warning prompts you that any existing conditional lines will be overwritten, simply click ok now, you can start changing the conditional line for the sc_initial component drag the start of the bar to 0% and drag the end of the bar to 20% this sets the condition that the sc_initial image visually appears on the watch face when the step percentage is from 0% to 20% for the sc_moderate component, set the conditional line from 21% to 80%, and for the sc_good component, set it from 81% to 100% this makes the sc_moderate and sc_good images to visually appear on the mentioned step count percentages tipread apply conditional lines on watch faces to know more about conditional line test the watch face in the run pane, click the preview watch face icon and you can run the created watch face with different custom designs to test your watch face, you need to connect a watch device to the same network as your computer in watch face studio, select run on device select the connected watch device you want to test with if your device is not detected automatically, click scan devices to detect your device or enter its ip address manually by clicking the + button noteto run the watch face successfully, you may need to configure its always-on display to avoid any error when you run it on your watch for more details about testing your watch faces, click here you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a watch face using style and conditional lines in watch face studio by yourself! if you face any trouble, you may download this file style customization complete project 425 73 kb to learn more about watch face studio, visit developer samsung com/watch-face-studio

https://developer.samsung.com/codelab/watch-face-studio/style-customization.html

Learn Code Lab

codelab

Get creative with weather data in Watch Face Studio

get creative with weather data in watch face studio objective learn how to create a watch face that changes dynamically based on weather conditions using weather tags, bitmap font, and conditional lines overview watch face studio is a graphic authoring tool which provides a straightforward and easy-to-understand method of configuring the watch movement and adding watch components without the need of any coding you can use watch face studio to create custom watch faces for galaxy watch, and other watches running on wear os bitmap fonts are images that can be used to replace preset dynamic elements such as timestamps, dates, text, and digital clock components you can replace numbers, punctuation, clock, and calendar abbreviations tag expressions are conditions that let you change the rotation, placement, and opacity of a component based on tag values that represent watch data, such as the date and time, battery status, steps, or weather your watch face changes dynamically as the tag value changes you can configure its movement and data dynamically weather tags provide a variety of information about the weather such as weather conditions, current temperature, or uv index conditional lines let you show and hide components on a watch face and control the components' behavior use conditional lines to change the appearance of your watch face in response to certain conditions such as step count, battery, or weather set up your environment you will need the following watch face studio version 1 7 or higher galaxy watch or smartwatch running on wear os 5 or higher sample project here is a sample project for this code lab download it and start your learning experience! weather data sample project 574 3 kb start your project to load the sample project in watch face studio click open project locate the downloaded file and select weather data sample project check the availability of weather data when creating watch faces, always check the value of the [wthr_is_avail] tag before utilizing other weather tags in the sample project, it is already configured to display a no info text with a black background whenever the weather data is not available go to the run pane > weather to preview how your watch face appears with and without weather data notethe [wthr_is_avail] tag checks the availability of weather data and it returns either 0 no or 1 yes change the background using bitmap font watch face studio allows you to use bitmap font for text components you can use the bitmap font to change the background color of your watch face based on specific weather conditions such as sunny, rainy, or snowy using the weather condition tag [wthr_cond] as the value of the text field, you can change the background during a snowy weather select bg from the component list from the properties tab, go to font setting section click the gear icon of the bitmap font setting noteweather condition for bg is already set in the sample project for this bitmap, the default font size is set to 450 pixels which is the watch face size in addition, the [wthr_cond] tag has a value of 0 to 15, wherein the value of 7 indicates a snowy weather since the digit in the bitmap font settings only provides values from 0 to 9, the remaining values 10 to 15 are added in the custom tab to set the bitmap font for snowy weather, click the + sign for 7 to add a background image locate the image from the downloaded sample project in the resources folder, select the bg_snow png image using tag expression to set the background of your watch face during a rainy weather condition, use a tag expression under the bg_transparent group, select the bg_rain_transparent image component change the image visibility by toggling the eye icon from the properties tab, go to color and in its opacity click the tags button input [wthr_cond] == 6 ?0 -100 as the tag expression since the initial opacity value is 100, the expression indicates that the background image is set to 100% opacity when the weather is rainy and 0% opacity otherwise notethe [wthr_cond] tag has a value of 0 to 15, wherein the value of 6 indicates a rainy weather set the weather icon using conditional lines to add a weather icon, you can either use bitmap font or conditional lines in this part, use the conditional lines to set the icon based on weather conditions the conditional line is already added for all weather conditions except for the sunny weather click on the + sign to add the conditional lines for weather click the show/hide weather icon to show the conditional lines for weather under the icon group, select the sunny image component and set its condition under sunny add a temperature unit using bitmap font the weather data provides the current temperature in either celsius c or fahrenheit f as its temperature unit use the temperature unit tag [wthr_tem_unit] to change the text component to the unit based on preference notethe temperature unit tag [wthr_tem_unit] has the following values for celsius, the value is 1 for fahrenheit, the value is 2 use bitmap font to set the image of the temperature unit based on the value of [wthr_tem_unit] under the temperature group, select unit c/f from the component list from the properties tab, go to font setting section click the gear icon of the bitmap font setting to set bitmap font for the value of 2 fahrenheit , click the + sign to add an image locate the image from the downloaded sample project in the resources folder, select the fahrenheit png image notein the bitmap font setting, the default font size is set to 50 test the watch face go to the run panel > weather to test the watch face for different weather conditions by changing the values of the condition adjust the weather condition value to see how the watch face changes for sunny, rainy, and snow weather conditions you can also check whether the temperature unit changes to either celsius or fahrenheit for other weather conditions, the watch face displays the following you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create a watch face that changes dynamically based on weather conditions in watch face studio all by yourself! if you're having trouble, you may download this file weather data complete project 665 6 kb to learn more about watch face studio, visit developer samsung com/watch-face-studio/

https://developer.samsung.com/codelab/watch-face-studio/weather-data.html

Learn Code Lab

codelab

Apply Conditional Lines on Watch Faces

apply conditional lines on watch faces objective learn how to create a watch face that responds to time and notification using conditional lines in watch face studio overview watch face studio is a graphic authoring tool that enables you to create and design watch faces for watches running on wear os it offers a simple and intuitive way to add images and components, and to configure the watch movement without any coding watch face studio supports watch faces for the galaxy watch4 or newer version, and other watch devices that run on the same platform conditional lines in watch face studio lets users easily control components and its behaviors on watch faces you can make your watch faces change dynamically based on time, step-count, or battery using conditional lines now, with the latest version of watch face studio, you can also set conditional lines based from events such as low battery, unread notification, or scenarios without any events set up your environment you will need the following watch face studio latest version galaxy watch4 or newer any supported wear os watch sample project here is a sample project for this code lab download it and start your learning experience! conditional lines sample project 2 43 mb start your project download the sample project file, and click open project in watch face studio locate the downloaded file, then click open apply conditional lines based on time using conditional lines in watch face studio, your watch face can visually change its design based on the time of the day here, you can change the background image of the watch face based on certain time intervals by setting the timeline condition of two background images, named background_day and background_night click the show/hide timeline icon to show the frame area notice that there's a default conditional line based on time for every component each conditional line is represented by a bar in the timeline and you can adjust it using the slider at the end of the bar collapse the background group containing the two background images in the timeline area of background_day, click on its bar and hover your mouse at the start of the bar drag the start of the bar to 06 00 00h and drag the end of the bar to 18 00 00h this sets the condition that background_day visually appears on the watch face from 6 00 am until 6 00 pm tipto quickly navigate on the timeline, hold shift + mouse scroll learn more about keyboard shortcuts, by referring to this guide next, for background_night, set the first time condition from 00 00 00h to 06 00 00h by dragging its bar respectively at the start of 18 00 00h, double-click at the timeline area to create a 2nd bar at that specific time drag the end of the bar to 00 00 00h, at the rightmost part of the timeline this makes background_night to appear conditionally from 6 00 pm until 6 00am on your watch face now, it's time to check if your watch face responds correctly based on the time of the day click show/hide run button to open the run panel in watch face studio move the time control slider from 06 00 00h to 18 00 00h and the watch face should show background_day as its background similarly, check if the watch face changes its background to background_night when the time is from 18 00 00h to 06 00 00h set the unread notification event make your watch face change dynamically based on a specific device event in this step, add an event for unread notifications on notification_envelope, an animation component included in the sample project click + or add conditional line and select event noteto remove conditional line icons such as the battery, steps, 12h/ 24h, or event, simply right-click on it and select remove click show/hide event to start configuring the event-based conditional line for notification_envelope on the notification_envelope layer, double-click on the event frame in the warning window, click ok in this case, all existing conditional frames for this layer are deleted afterward, a bar is created for the event-based conditional line noteeach layer responds to only one type of condition next, drag the bar from no event to unread notification noteno event is used if there is no condition set on either battery low or unread notification events check if the notification_envelope animation component appears on your watch face whenever there's an unread notification click play run preview and move the unread notification slider in the run panel when the unread notification is set to a value of 1 or more, the animation component should visually appear on your watch face test the watch face to test your watch face, you need to connect a watch device to the same network as your computer in watch face studio, select run on device select the connected watch device you want to test with if your device is not detected automatically, click scan devices to detect your device or enter its ip address manually by clicking the + button notethe always-on display is already set in the project to run the watch face successfully, you may need to configure its always-on display to avoid any error when you run on device you're done! congratulations! you have successfully achieved the goal of this code lab now, you can use conditional lines in watch face studio, all by yourself! if you're having trouble, you may download this file conditional lines complete project 2 43 mb to learn more about watch face studio, visit developer samsung com/watch-face-studio

https://developer.samsung.com/codelab/watch-face-studio/conditional-lines.html

Learn Code Lab

codelab

Utilize the Add to Samsung Wallet service for digital cards

utilize the add to samsung wallet service for digital cards notescenes in the demo video are simulated and does not represent any real-world conditions or outcomes objective learn how to use the add to samsung wallet service so that users can store digital contents, such as boarding passes, tickets, and coupons, to their samsung wallet app partnership request to create, manage, and monitor performance of wallet cards with the samsung wallet partners site, you must become an official samsung partner once done, you can fully utilize this code lab you can learn more by visiting samsung wallet partner onboarding process, here in samsung developers overview samsung wallet is an application that securely stores essential items such as boarding passes, tickets, and coupons, making them easily accessible from anywhere with this app, users can access various partner wallet cards in one place, simply by swiping up from the bottom of the screen the add to samsung wallet service provides interfaces for users to conveniently add digital content to samsung wallet here are examples of the supported wallet cards boarding pass journey information such as flights, trains, and buses can be provided as notifications, allowing easy retrieval when checking in by configuring server synchronization, updates to journey information such as gate changes, schedule changes, or cancellations can be received by the users ticket notifications about events and additional information, including benefits, can be provided based on real-time utilization of performances, sports games, movies, and admission tickets, status updates related to expiration and availability can be provided gift card gift card, also referred to as a prepaid card, provides real-time balance and transaction history loyalty loyalty cards function as membership credentials, managing membership information through these cards, loyalty points can be administered and redeemed id id cards can fulfill identification verification purposes, such as identity cards, employee cards, and licenses physical documents can be represented through wallet cards, and near field communication nfc -based authentication can be provided reservation reservation cards can contain diverse online booking details, including rental cars, restaurants, and accommodations ongoing reservation information can be managed as a journey pay as you go pay as you go cards allow users to register services that can be charged and utilized according to their preference for convenient use generic card generic cards enable users to create customized cards by selecting preferred card template layouts and designing elements notedepending on your country or region, some card types are not supported if you need assistance, please contact us at developer samsung com/dashboard/support the image below shows the process of managing wallet cards for more information, refer to manage wallet cards set up your environment you will need the following latest version of samsung wallet app from galaxy store samsung galaxy device that supports samsung wallet access to samsung wallet partners site internet browser, such as chrome openssl intellij idea or any java ide optional start the onboarding process partners can manage wallet cards and monitor performance with the samsung wallet partners site to join as partner generate a private key and certificate signing request csr using the openssl command you can follow the instructions in security factors notea private key enables encryption and is the most important component of certificates while csr, which is a necessary factor to obtain a signed certificate, includes the public key and additional information like organization and country proceed to register in the samsung wallet partners site using your samsung account follow the samsung wallet partner onboarding process upload the generated csr for data encryption in encryption setting management section after registration, you will receive a welcome email noteupon receiving the certificates via email, be sure to keep the information safe from exposure and only use them for the following purposes signed certificate used along with the private key to sign data samsung certificate used to encrypt card data and validate authentication tokens in server api headers create a wallet card follow the steps below to create a wallet card in samsung wallet partners site click the wallet cards menu and choose create wallet card fill out the general information form with the details of the wallet card in wallet card template, choose a card type and sub type select the design type and click done you can choose from various types of wallet card templates optimized for partners after inputting all necessary details, click save to set the wallet card status to draft launch the wallet card you can launch and request activation of the card by clicking the launch button upon agreeing to proceed, the launch button text changes to launched and the card status becomes verifying add the card to samsung wallet using the test tool open a web browser on your computer or galaxy mobile device, and go to the following link partner walletsvc samsung com/addtowallettest go to add to wallet tab and click choose key file to upload your private key in the select card dropdown menu, select the created card to display the card details and populate sample data navigate to the form tab and modify the card data as desired notethe structure for configuring wallet cards follows the defined specification you can refer to the full list of card-specific attributes specification scroll down to the bottom of the page and click the add to samsung wallet button click done when a preview of the card shows on your mobile screen with a message indicating that the card has been added to your wallet once the card is added to your samsung wallet app, you can check its details by clicking on it noteyou can also go to the playground tab and add cards to the samsung wallet app even without creating a card on the wallet partners site update the status of the added card if a server api info partner get card data and partner send card state is registered in the wallet card, real-time updates of the user's registered cards can be provided notefor more information, see server interaction modify and update the card's status by utilizing the push notification feature of the test tool navigate to the push notification tab ensure that the correct private key is uploaded and the same card as in the add to wallet tab is selected copy the ref id value from the add to wallet tab and paste it into ref id field in the push notification tab in the status field, enter one of the following card states expired, redeemed, held, suspended, or deleted the current state is set to active then, click the request push notification button check the card in the samsung wallet app to confirm the change tokenize card data and implement the add to samsung wallet button to your service optional notethis step is optional, but if you want to learn how to integrate the add to samsung wallet button into your services like an android app, web app, or email, you can follow these steps the samsung wallet partners site provides generated add to samsung wallet scripts for each wallet card you create you can simply copy and paste these scripts into your partner apps web and android or include them in emails/mms messages to implement the add to wallet button, follow these steps go to the [add to wallet script guide] section of the card you created click show to view the available scripts and then copy the appropriate script for your service develop a program that can generate tokenized card data cdata the cdata represents the actual content of the wallet card and comes in different formats depending on the card type you can check the cdata generation sample code for reference the cdata is derived from the card data, which is in json format for testing purposes, you can utilize the generated json from the test tool follow the implementing atw button guide to determine where to incorporate the generated cdata and gain further insights into this process you're done! congratulations! you have successfully achieved the goal of this code lab topic now, you can utilize the add to samsung wallet service by yourself! to learn more about samsung wallet, visit developer samsung com/wallet

https://developer.samsung.com/codelab/wallet/add-to-wallet-interface.html

Learn Code Lab

codelab

Implement in-app subscriptions using Samsung IAP

implement in-app subscriptions using samsung iap objective learn how to integrate the samsung in-app purchase sdk into your application so that users can purchase and upgrade subscriptions directly within the app overview the samsung in-app purchase iap service provides developers with a reliable solution for managing digital purchases within mobile applications it guarantees a smooth and secure experience for users when buying digital goods, managing subscriptions, or processing refunds and consumed products the iap sdk enables easy integration of the iap functionality into your app, such as configuring iap, retrieving product details, offering and selling products, and managing purchased products to successfully sell in-app products, follow these four basic steps download and integrate the samsung iap sdk into your application request for commercial seller status in the samsung galaxy store seller portal upload your application's binary file in the seller portal add in-app products to your app by integrating in-app purchases iap , your apps can sell in-app products, including subscriptions a subscription is a specific type of in-app product available for purchase through your app in the galaxy store when a user buys a subscription, it grants access for a set duration known as the subscription period or payment cycle at the end of this period, the subscription automatically renews, allowing the user to continue using the product for another subscription period and to be automatically billed with the subscription price for more information, go to samsung iap set up your environment you will need the following android studio latest version recommended samsung iap sdk latest version samsung galaxy device android 6 0 or higher samsung galaxy store seller portal commercial seller account sample code here is a sample code for you to start coding in this code lab download it and start your learning experience! in-app subscription bookspot sample code 1 5 mb start your project in android studio, click open to open an existing project locate the downloaded sample project and click ok register the app and its associated subscriptions in the seller portal to register the sample app along with the in-app products in the samsung galaxy store seller portal, follow these steps sign in using your commercial seller account in android studio, modify the package name of the sample app navigate to app > kotlin + java > com example bookspot view, and in the mainactivity java file, refactor the application name bookspot from the package name com example bookspot for all directories notethe package name com example bookspot is already registered in the seller portal to avoid any conflicts, rename it with a different package name next, open the app > manifests > androidmanifest xml file and check that all necessary permissions are present com samsung android iap permission billing to connect to iap and enable in-app product registration in the seller portal android permission internet because iap uses the internet <uses-permission android name="com samsung android iap permission billing" /> <uses-permission android name="android permission internet" /> build the apk from android studio and upload the binary to the seller portal once the testing process is complete and the app functions smoothly as intended, return to this step and upload the final apk file in the in app purchase tab, click on add new item and select subscription add the subscriptions with item ids as basic and standard these are the item ids of the subscriptions created in the sample app next, set the subscription price by clicking on set new price noteto learn more about pricing, see manage subscription pricing provide the details for the payment cycle, grace period, free trial period, and free trial/tiered pricing limit as shown below noteincluding a free trial promotion for your app is optional to test the functionality of the getpromotioneligibility api, you can add a free trial select all subscriptions you added and click on activate lastly, add a license tester to enable purchasing within the app edit your seller portal profile and include your samsung account in the license test field on the test device, sign in with the same samsung account initialize the samsung iap sdk before using the samsung iap sdk library samsung-iap-6 5 0 aar , ensure that it is added to the app > libs folder and included as a dependency in the module-level build gradle file dependencies { implementation filetree dir 'libs', include ['* aar'] } next, open the mainactivity java file in the oncreate function, create an instance of iaphelper and set the operation mode to operation_mode_test this mode enables only license testers to test the application without incurring charges iaphelper = iaphelper getinstance getapplicationcontext ; iaphelper setoperationmode helperdefine operationmode operation_mode_test ; notebefore submitting the app for beta testing or release, change the operation mode to operation_mode_production get product details and check the promotion eligibility to obtain information about subscriptions registered in the store related to your app, use the getproductsdetails api you can retrieve details about a specific subscription by providing the argument named itemid with values such as basic or standard you can use an empty string "" as the argument to obtain all product details iaphelper getproductsdetails itemid, new ongetproductsdetailslistener { @override public void ongetproducts @nonnull errorvo errorvo, @nonnull arraylist<productvo> productlist { if errorvo geterrorcode == iaphelper iap_error_none { for productvo item productlist { itemname settext item getitemname +" level course" ; itemtype settext "item type "+item gettype ; itemprice settext "item price "+item getitemprice +item getcurrencyunit ; itemduration settext "item duration "+item getsubscriptiondurationunit ; subscriptiondialogbutton setonclicklistener dialogbtnlistener ; getpromotioneligibility item getitemid ; } } else { log e "ongetproducts error ", errorvo geterrorstring ; } } } ; after getting the product details, check the promotion eligibility use the getpromotioneligibility api to return the pricing options for a subscription, including free trials and introductory prices that may apply to the user iaphelper getpromotioneligibility itemid, new ongetpromotioneligibilitylistener { @override public void ongetpromotioneligibility @nonnull errorvo errorvo, @nonnull arraylist<promotioneligibilityvo> pricinglist { if errorvo geterrorcode == iaphelper iap_error_none { for promotioneligibilityvo pricing pricinglist { itempricing settext "promotion eligibility "+pricing getpricing ; } } else { log e "ongetpromotioneligibility error ", errorvo geterrorstring ; } } } ; initiate the payment process and acknowledge the subscription to initiate a purchase and complete the payment transaction process, use the startpayment api the result of the purchase is specified through the onpaymentlistener interface, which provides detailed purchase information in the event of a successful transaction use obfuscatedaccountid and obfuscatedprofileid value is up to 64 bytes to detect fraudulent payments these values are returned in purchasevo that contains the purchase results you can find more details about it in the purchase an in-app product section of the programming guide once the app has granted entitlement to the user, notify samsung iap of the successful transaction using the acknowledgepurchases api additionally, call the handlechangeplan function to make the change plan button visible and to set the onclicklistener iaphelper startpayment itemid, obfuscatedaccountid, obfuscatedprofileid, new onpaymentlistener { @override public void onpayment @nonnull errorvo errorvo, @nullable purchasevo purchasevo { if errorvo geterrorcode == iaphelper iap_error_none && purchasevo != null { acknowledgepurchases purchasevo getpurchaseid ; handlechangeplan itemid ; } else { log e "onpayment error ", errorvo geterrorstring ; } } } ; use the acknowledgepurchases api as below iaphelper acknowledgepurchases purchaseid, errorvo, acknowledgedlist -> { if errorvo geterrorcode == iaphelper iap_error_none { for acknowledgevo item acknowledgedlist { log e "onacknowledgepurchases ", item getstatusstring ; } } else { log e "onacknowledgepurchases error ", errorvo geterrorstring ; } } ; manage changes to subscription plans the changesubscriptionplan api allows users to switch between different tiers of the same subscription changes can be categorized as follows upgrade - moving from a lower-priced tier to a higher-priced tier, or switching between tiers of equal value downgrade - transitioning from a higher-priced tier to a lower-priced tier you can use proration modes to set the payment and current subscription period settings there are four proration modes available instant_prorated_date, instant_prorated_charge, instant_no_proration, and deferred in this code lab, use instant_prorated_date so that the current subscription is changed instantly, allowing the user to start using the new subscription tier right away also, use obfuscatedaccountid and obfuscatedprofileid to detect fraudulent payments iaphelper changesubscriptionplan itemid, newitemid, helperdefine prorationmode instant_prorated_date, obfuscatedaccountid, obfuscatedprofileid, new onchangesubscriptionplanlistener { @override public void onchangesubscriptionplan @nonnull errorvo errorvo, @nullable purchasevo purchasevo { if errorvo geterrorcode == iaphelper iap_error_none && purchasevo != null { handlechangeplan newitemid ; updatechangeplanview newitemid ; } else { log e "onchangesubscriptionplan error ", errorvo geterrorstring ; } } } ; notefor more details on handling changes to subscription plans, see manage subscription plan changes retrieve and process the list of subscriptions the getownedlist api retrieves a list of in-app products that the user has previously purchased, including active subscriptions and free trials call the getownedlist api from the iaphelper class and obtain the results through the ongetownedlistlistener interface utilize the helperdefine product_type_subscription parameter to fetch only subscription data after acquiring the subscription list, check the acknowledgment status of each subscription using the getacknowledgedstatus function and check whether all of the subscriptions are being acknowledged by samsung iap if any of the subscription status is not acknowledged, then call the acknowledgepurchases function to notify the acknowledgement to samsung iap if the subscription price has changed in the seller portal, it may be necessary for existing subscribers to consent to the price increase before the next subscription period, depending on certain conditions to determine if consent is required from the subscriber, use the getpricechangemode and isconsented functions if consent is needed, call the handleconsent function to make the consent button visible, and set the onclicklistener for the button accordingly iaphelper getownedlist helperdefine product_type_subscription, new ongetownedlistlistener { @override public void ongetownedproducts @nonnull errorvo errorvo, @nonnull arraylist<ownedproductvo> ownedlist { if errorvo geterrorcode == iaphelper iap_error_none { for ownedproductvo item ownedlist { // check the acknowledgedstatus helperdefine acknowledgedstatus acknowledgedstatus = item getacknowledgedstatus ; if acknowledgedstatus equals helperdefine acknowledgedstatus not_acknowledged { acknowledgepurchases item getpurchaseid ; } // handle the price change if item getitemid equals item1 || item getitemid equals item2 { handlechangeplan item getitemid ; subscriptionpricechangevo subscriptionpricechangevo = item getsubscriptionpricechange ; if subscriptionpricechangevo != null && subscriptionpricechangevo getpricechangemode equals helperdefine pricechangemode price_increase_user_agreement_required && !subscriptionpricechangevo isconsented { handleconsent item getitemid , item getpurchaseid ; } } } } else { log e "getownlist error ", errorvo geterrorstring ; } } } ; to create a deep link to the consent page when needed, use the following code uri deeplinkuri = uri parse "samsungapps //subscriptiondetail?purchaseid="+purchasedid ; intent intent = new intent intent action_view, deeplinkuri ; startactivity intent ; run the app after building the apk, install the app on a samsung galaxy device to test the app, click on view details in the basic tab this displays the purchase details, including promotion eligibility, item type, duration, and price then, click on continue to subscribe in the samsung checkout pop-up, select your payment method and click the subscribe button a payment confirmation screen appears upon successful completion of the transaction when the change plan button appears, click on it a pop-up shows the changes in your subscription plan click next and then subscribe using your payment method a payment confirmation screen appears, and the view changes to the standard tab, where you can see the details of your new subscription noteto test and display the consent button, you must increase the price of any subscription in the seller portal the price update will be applied in the galaxy store after a waiting period of 7 days the subscription renews every 10 minutes and will expire in operation_mode_test mode to test the change in the subscription price, set the operation mode to operation_mode_production you're done congratulations! you have successfully achieved the goal of this code lab now, you can implement in-app subscriptions using samsung iap into your application by yourself! if you are having trouble, you may download this file in-app subscription bookspot complete code 1 5 mb to learn more about developing apps with samsung iap sdk, visit developer samsung com/iap

https://developer.samsung.com/codelab/iap/in-app-subscriptions.html

Didn’t find what you were looking for?

FAQ

Search frequently asked
questions
by keywords.

Join the Forum

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

Get Support

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

Preferences Submitted

You have successfully updated your cookie preferences.