Improving verification performance with a great UI
For better verification performance, it should be straightforward and easy for users to enter their phone phone numbers. To simplify this step and build a UI that accurately captures the correct input from the users, both Android (starting from API level 21) and Sinch SDK provide some utility APIs.
PhoneNumberFormattingTextWatcher
The Android SDK provides a PhoneNumberFormattingTextWatcher. This watcher can be added as a text changed listener to a text field, and will format it automatically if a phone number is entered in local or international format.
Phone Number Hint
In addition to providing an UI where a user can type the number manually, we recommend using the Phone Number Hint library to facilitate the process and fallback to default flow if Phone Number Hint fails to fetch the number.
Important:
Note that the number returned from Phone Number Hint might not be in E.164 format, which is required by Sinch SDK. Before passing it, make sure to format it correctly. See Phone numbers section for more information.
SinchPhoneNumberUtils
Another convenient helper utility class available in Sinch SDK is SinchPhoneNumberUtils. The function isPossiblePhoneNumber is especially useful to check phone numbers that are typed by the user that seem to be correct. If it's not, the text field could be highlighted with a different color (red).
WARNING: Important
isPossiblePhoneNumber internally uses Android SDK and its Telephony API. In some rare cases, it has been reported that for some numbers it acted as if the numbers were valid and the were treated as incorrect. For that reason, you should use these APIs only as a hint and don't disable the UI completely even if that function returns false.
