Skip to main content

Extra: Calories events

Upload and display current day calories.

Introduction​

Calories events not only send current day calories count but also return the data that was sent, you can use this data to update your UI without waiting for the webhook event.

Getting started​

Android configuration​

Go to the main Android configuration section to see the basic configuration.

Logging​

Go to the main Logging section to configure logs.

Usage​

Initialize​

Go to the main Initialize and Update userID sections to initialize.

RookSyncManager​

You can call RookSyncManager functions by creating an instance with a context:

val rookSyncManager = RookSyncManager(context)

rookSyncManager.doSomething()

Or using the Companion object and providing a context with each call:

RookSyncManager.doSomething(context)

Permissions​

To use Calories events you will need:

info

In order to generate an event you need at least one of the following permissions Active Calories Burned, Total Calories Burned.

Send calories events​

Retrieve and upload current day calories count of Health Connect.

rookSyncManager.getTodayCaloriesCount().fold(
    {
        when (it) {
            SyncStatusWithData.RecordsNotFound -> {
                // No calories events found
            }

            is SyncStatusWithData.Synced -> {
                val dailyCalories: DailyCalories = it.data

                // Update the UI with calories count
            }
        }
    },
    {
        // Handle error
    }
)

Warning: This function contributes to the Health Connect rate limit, don't call it too frequently.