Default UI - Elements

In the previous section we talked about the Defaul UI as whole.

In this section we’ll break down each element of the Default UI, their names and purposes.

Distance Indicator

Distance Info

Purpose:
Informs the user about the distance from the device to the tire.
Possible states are "Move away" - Red, "Move closer" - Red, "Distance OK" - Green.

Class type:
DistanceIndicatorConfig

Properties:

Name Summary

textMoveAway

Text displayed when the user needs to move away from the tire. Default value is "Move away".

textMoveCloser

Text displayed when the user needs to move closer to the tire. Default value is "Move closer".

textOk

Text displayed when the user is correctly positioned to scan the tire. Default value is "Distance OK".

visible

Determines the visibility status. Default value is true.

Focus Point Tooltip

Focus point

Purpose:
Instructs the user on how to move the device in order to find a surface to scan.

Class type:
FocusPointTooltipConfig

Properties:

Name Summary

text

Text displayed when the focus has not yet been found. Default value is "Move your device slowly back and forth to detect the tire.".

smallText

Small text displayed above the bold caption, when the focus has not yet been found. Default value is "Initializing tire detection…​".

visible

Determines the visibility status. Default value is true.

Tap to Start Scanning Tooltip

Tap to Start Scanning

Purpose:
Once the device is correctly positioned, informs the user that they can tap the screen to start scanning.

Class type:
TapToStartScanningTooltipConfig

Properties:

Name Summary

textOk

Text displayed when the user can start the scan process. Default value is "Tap to start recording".

textNotOkMetric

Text displayed when the user needs to move the device to the correct distance. Default value is "Hold your phone around 20cm from the tire to start.".

textNotOkImperial

Text displayed when the user needs to move the device to the correct distance. Default value is "Hold your phone around 8in from the tire to start.".

visible

Determines the visibility status. Default value is true.

Tire Overlay

Tire Overlay

Purpose:
Helps the user correctly position their device by displaying a tire overlay which should aligned with the tire to be scanned.

Class type:
TireOverlayConfig

Properties:

Name Summary

visible

Determines the visibility status. Default value is true.

Upload View

Upload View

Purpose:
Informs the user that the upload process is currently in progress.

Class type:
UploadViewConfig

Properties:

Name Summary

text

Text displayed to inform that the upload is currently in progress. Default value is "Uploading…​".

visible

Determines the visibility status. Default value is true.

Abort Button

Abort button

Purpose:
At any point in time, enables the user to abort the scan process.
Triggers the onScanAbort(uuid: String?) callback, which has to be handled by the integrator.

Not customizable

Orientation Warning

Orientation Warning

Purpose:
This UI element is shown when the user is holding the device in portrait mode. It signalises to reorient the device to landscape mode for an optimal scan experience.

Class type:
OrientationWarningConfig

Properties:

Name Summary

text

Text displayed to inform the user about the correct orientation of the device. Default value is "Rotate your device horizontally".

visible

Determines the visibility status. Default value is true.

Countdown

Countdown

Purpose:
This UI element is shown as soon as the scan starts and shows the remaining time until the process finishes.

Class type:
CountdownConfig

Properties:

Name Summary

visible

Determines the visibility status. Default value is true.

Scan Direction

Countdown

Purpose:
This UI element is shown as soon as the scan starts and shows the direction the user has to move the device for an optimal scan result.

Class type:
ScanDirectionConfig

Properties:

Name Summary

visible

Determines the visibility status. Default value is true.