Choosing SDK mode
The SDK offers several modes of integration, depending on how much of the user experience (UX) you want to use out of the box or build yourself.
Option 1: Full UX Flow (Default)
By default, the SDK provides a complete guided experience for end-users, including:
- Step-by-step instructions
- Camera feedback and positioning hints
- Result interpretation and health risk assessments
This is called the Full UX flow and is ideal if you want a ready-to-use experience. However, note that some parts of the embedded UI such as text content or how results are displayed cannot currently be customized.
All available customization options (e.g., themes, visible metrics, screen visibility) can be explored in the web playground.
See Providing the user interface for details on how to place the SDK’s view in your app.
Option 2: Partially Custom UI (Camera Feed Only)
If you need more control but still want the SDK to handle camera feedback, you can choose a mode that shows:
- Only the camera feed
- Positioning hints
- Visual overlays
To disable the built-in UI elements, set the following settings during initialization (in InitializationSettings
):
showUserInterface: false
to hide all UI elements- Set
onboardingMode
toHIDDEN
so that camera preview is shown immediately after initialization
You can manage the rest of the UI independently, using the SDK API to retrieve real-time data and events.
You’ll still need to create the SDK view in your app, but it will only show the camera feed and positioning hints without any additional UI elements.
Option 3: Full Custom UI (No Visual Elements)
For maximum flexibility, you can disable the SDK’s entire embedded interface and build your own UX from scratch. This is useful if:
- You want to fully control the look and feel
- You’re running measurements in the background
- You’re providing camera feedback via your own interface
To use the SDK in this mode, set showUserInterface: false
in InitializationSettings
during initialization, and omit creating the SDK view in your app altogether.
You’ll still have full access to all SDK data and events through the API.