Sessions

McsSession is a singleton that will keep alive during the life time of your program. McsSession provides everything you need about authentication.

Sign In

Use McsSession.getInstance().requestSignIn() to sign user in.

// call in main thread
McsSession.getInstance().requestSignIn(email, pwd, 
    new McsResponse.SuccessListener<JSONObject>() {
        @Override public void onSuccess(JSONObject response) {
            // Signed in, back to UI thread
        }
    },
    /**
     * Optional.
     * Default error message shows in log.
     */
    new McsResponse.ErrorListener() {
        @Override public void onError(Exception e) {
            // Sign in failed, back to UI thread
        }
    }
);

Note that requestSignIn() will work in background network thread.

Sign Out

It's even easier to sign out.

// call in main thread
McsSession.getInstance().requestSignOut(
    new McsResponse.SuccessListener<JSONObject>() {
      @Override public void onSuccess(JSONObject response) {
        // Signed out, back to UI thread
    }
);

Get Access Token

Basically you do not need to care about the access token, because every request you sent is verified by your APP_ID and APP_SECRET.

After signed in, you can use McsUser.getInstance().getAccessToken() to get access token to access the MCS APIs from your own third party service. Also, McsSession.getInstance().getAccessToken() could get the same access token for your ease of use to reduce the dependency of modules.

Get User and Mobile Info

Once signed in, the following information would be prepared.

• McsUser.getInstance()
• McsUserInfo.getInstance()
• McsMobile.getInstance()

These information will be keep in the internal storage of Android application using SharedPreferences.

McsUser

McsUserInfo

McsMobile