mobile.chooseContact

Lets the user choose a contact from the mobile device contact list and returns the vCard.

Syntax

ui.Interface.frontCall("mobile", "chooseContact",
   [], [result])
  • result - The vCard string from the device's contacts database.

Usage

The "chooseContact" front call opens the mobile device contact chooser, allows the user to select a contact and returns the contact as a vCard string.

Important:

For GMA / Android™, using the chooseContact front call needs the android.permission.READ_CONTACTS Dangerous Permission to be specified when building the APK. See Android permissions for more details. On Android 5.1 and lower (< API 23), use the android.permission.GET_ACCOUNTS permission.

If the user cancels the contact chooser, NULL is returned.

Example

DEFINE vcard STRING
CALL ui.Interface.frontCall("mobile", "chooseContact", [], [vcard] )