Log In

This guide introduces how to initialize JC SDK and log in.

Initialize

Call JCClient.create (opens new window) on the main thread to create a JCClient (opens new window) instance object. Pass in the obtained appKey to initialize the JCClient (opens new window):

/// JCClient object
JCClient mClient;

/// Initialization function
public bool initialize(Application app) {
    mClient = JCClient.create(app, "User appKey", new JCClientCallback() {

        public void onLogin(bool b, int i) {

        }

        public void onClientStateChange(int i, int i1) {

        }
    }, null);
    /// Get the initialization state (used to judge the initialization state)
    mInit = mClient.state == JCClientState.Idle;
    return mInit;
}

Initiate login

After the SDK is initialized, login integration is possible.The call flow of the login interface is as follows:

First create a JCClient.LoginParam (opens new window) instance to adjust the login parameters. Then call login (opens new window) to initiate login:

JCClient.LoginParam loginParam = new JCClient.LoginParam();
/// 1. Set the server environment.
loginParam.serverAddress = "Server address";
/// 2. Initiate login
mClient.login(userID, password, loginParam);

TIP

1. Environment settings:

   • Domestic environment http:cn.router.justalkcloud.com:8080 (Default)

   • International environment http:intl.router.justalkcloud.com:8080

2. userID is English, numbers and + - _ . , case-insensitive, the length should not exceed 64 characters, - _ . cannot be the first character.

3. password the length should not exceed 128 characters.

4. When calling this interface returns true, it only means that the interface is called successfully, not that the login is successful. The result of the login will be reported through the onLogin callback.

After the interface is successfully called, the login state change callback onClientStateChange (opens new window) will be triggered first. You can perform logical operations by overriding onClientStateChange (opens new window):

public void onClientStateChange(JCClientState state, JCClientState oldState) {
     if (state == JCClient.STATE_IDLE) { /// Not logged in
        ...
    } else if (state == JCClient.STATE_LOGINING) { /// Logging in
        ...
    } else if (state == JCClient.STATE_LOGINED) { /// Login successful
        ...
    } else if (state == JCClient.STATE_LOGOUTING) { /// Logout
        ...
    }
}

Then trigger the onLogin (opens new window) callback. You can perform logical operations by overriding onLogin (opens new window):

public void onLogin(bool result, JCClientReason reason) {
    if (result) {/// Login successful
        ...
    }
    if (reason == REASON_AUTH) {/// Account password is wrong
        ...
    }

}

After the login is successful, the SDK will automatically maintain the connection status with the server until the user actively calls the logout interface, or the device is logged out because the account is logged in on another device. Login success/failure reason Refer to JCClientReason (opens new window) .

Log out

The call flow of the logout interface is as follows:

Call logout (opens new window) to initiate logout.More logout reason reference: JCClientReason (opens new window) .

Logging out will also trigger a login state change (onClientStateChange) callback, after which the logout result will be reported via the onLogout callback:

public void onLogout(JCClientReason reason) {
    if (reason == REASON_SERVER_LOGOUT) {/// Force logout
        ...
    }
}