This feature (Android App Callout) will only be available to CommCare users with an Advanced Plan or higher. For more details, see the CommCare Software Plan page.
This page will walk you through the steps of integrating Dimagi's breath counter application with your CommCare ODK app.
- Download and install the breath counter app from the play store to your device at https://play.google.com/store/apps/details?id=org.commcare.respiratory. This app is called Breath Counter 3.0, not to be confused with an older version called Respiratory Counter.
- Navigate to the form builder for your app on CommCare HQ
- Navigate to where you want to insert the question.
- Press the Add Question button and add an "Android App Callout" question type under the "Advanced" tab
- Create an ID and label as you would a normal question
- Under "External App", select Breath Counter. The following should appear in the field to the right: org.commcare.respiratory.BREATHCOUNT (if for some reason you are using the old app Respiratory Counter, you will need to select Custom and then put in change.uw.android.BREATHCOUNT)
- Under "Logic" you can enforce the same things as you would a normal question, IE enforce this must be a realistic value, non-null, etc (validation condition: . != 'null')
- Once the user performs the breath counting via the 'Breath Counter' application, the resulting integer value will be passed back to CommCare and stored in the "Android App Callout" question's "Question ID"
For more info on app callout question types see Integrating Android applications with CommCare.
Setting up a form question that calls out to the Breath Counter app
Before calling breath counter app
Using the breath counter app to collect the count data
Showing the result passed back from the breath counter app