Usage

User Authorization

The method for authorizing users. A result or an error are sent to method onAuthorizeResult.

1. By default, the method uses guest authorization.
2. After 24h since the first authorization "Save progress" window appears.
3. If a user has been authorized before, then the token refreshes by calling onAuthorizeResult.

// Java
Platform101XP.Companion.authorize();

---

// Kotlin
Platform101XP.authorize()

The method for user’s profile display. The result of the authorization or an error is passed to method OnAuthorizeResult.

// Java
Platform101XP.Companion.showProfile();

---

// Kotlin
Platform101XP.showProfile()

Deprecated

Method Platform101XP.managedAuthorize() is deprecated, please use Platform101XP.showProfile() method.

SDK events processing

The result of the authorization attempt is sent to the listener method after calling Platform101XP.authorize() or Platform101XP.showProfile().

1. In case of successful authorization, token is sent to the method.
2. In case of an error, error is sent to the method.

// Java
void onAuthorizeResult(Platform101XPToken token, Platform101XPError error){
}

---

// Kotlin
override fun onAuthorizeResult(token: Platform101XPToken?, error: Platform101XPError?){
}

and if successful authorization with delay information about the account will come.

// Java
void onGetAccountResult(Platform101XPAccount account, Platform101XPError error){
}

---

// Kotlin
override fun onGetAccountResult(account: Account?, error: Platform101XPError?){
}

Handling an event when a player clicks Cancel button

To handle this event onAuthorizeResult is used:

// Java
public void onAuthorizeResult(Platform101XPToken token, Platform101XPError error) {
   if(error.getErrorType() == Platform101XPError.ErrorType.ERROR_CANCELED){
       showMessage("Action canceled!");
   }
}

---

// Kotlin
override fun onAuthorizeResult(token: Platform101XPToken?, error: Platform101XPError?) {
    val message = token?.let {
        "Success!"
    } ?: run {
        error?.let {
            if (it.getErrorType() == BaseErrorType.ERROR_CANCELED)
                "User action: Canceled!"
            else
                "Error! $error"
        } ?: run {
            "Unknown Error"
        }
    }
    showMessage(message)
}

Connection error

If a user does not have an internet connection the method onAuthorizeResult will return ERROR_CONNECTION.

// Java
public void onAuthorizeResult(Platform101XPToken token, Platform101XPError error) {
    if(error.getErrorType() == Platform101XPError.ErrorType.ERROR_CONNECTION){
        showMessage("Connection error!");
    }
}

---

// Kotlin
override fun onAuthorizeResult(token: Platform101XPToken?, error: Platform101XPError?) {
    val message = token?.let {
        "Success!"
    } ?: run {
        error?.let {
            if (it.getErrorType() == BaseErrorType.ERROR_CONNECTION)
                "Connection error!"
            else
                "Error! $error"
        } ?: run {
            "Unknown Error"
        }
    }
    showMessage(message)
}

User logout

To handle this event use method onLogout() from listener.Platform101XPListener.

// Java
@Override
public void onLogout() {
    // Do something after logout
}

---

// Kotlin
override fun onLogout() {
    // Do something after logout
}