Digits: Find Your Friends

Using the “Find Your Friends” feature, users can upload their address book to find other Digits users in your app that they know.

Getting started

You must include the android.permission.READ_CONTACTS permission in your manifest. Without this, Digits will be unable to access the user’s address book.

To start the “Find Your Friends” process call the startContactsUpload method. You can optionally call startContactsUpload with a custom theme.

Digits.getInstance().getContactsClient().startContactsUpload();

The first time startContactsUpload is called a dialog requesting permission to upload the user’s address book will be displayed.

Once the user clicks “Okay” the address book will be upload in the background using an IntentService.

Getting results

Once complete the contacts upload service will broadcast an Intent with the action value com.digits.sdk.android.UPLOAD_COMPLETE for success or com.digits.sdk.android.UPLOAD_FAILED for failure. On success the Intent will contain an extra value with additional information. You can create a BroadcastReceiver to receive the Intent and perform some action.

public class MyResultReceiver extends BroadcastReceiver {
  @Override
  public void onReceive(Context context, Intent intent) {
    if (ContactsUploadService.UPLOAD_COMPLETE.equals(intent.getAction())) {
      ContactsUploadResult result = intent
        .getParcelableExtra(ContactsUploadService.UPLOAD_COMPLETE_EXTRA);

      // Post success notification
    } else {
      // Post failure notification
    }
  }
}

Don’t forget to add your BroadcastReceiver to the application manifest.

<receiver
  android:name=".MyResultReceiver"
  android:exported="false">
  <intent-filter>
    <action android:name="com.digits.sdk.android.UPLOAD_COMPLETE"/>
    <action android:name="com.digits.sdk.android.UPLOAD_FAILED"/>
  </intent-filter>
</receiver>

Results can be retrieved by calling lookupContactMatches method.

Digits.getInstance().getContactsClient().lookupContactMatches(null, null,
  new ContactsCallback<Contacts>() {

    @Override
    public void success(Result<Contacts> result) {
      if (result.data.users != null) {
        // Process data
      }
    }

    @Override
    public void failure(TwitterException exception) {
      // Show error
    }
  });