Android Integration Guide

PASS.showLogin(new LoginListener() {
    @Override
    public void onSuccess(UserInfo userInfo) {
        // Signed in: userInfo.userId, userInfo.displayName, userInfo.sessionId
    }
 
    @Override
    public void onFail(Error error) {
        // Handle cancel/failure
    }
});

PASS.showLogin(object : LoginListener {
    override fun onSuccess(userInfo: UserInfo) {
        // Signed in: userInfo.userId, userInfo.displayName, userInfo.sessionId
    }
 
    override fun onFail(error: Error?) {
        // Handle cancel/failure
    }
})

PASS.autoLogin(new LoginListener() {
    @Override
    public void onSuccess(UserInfo userInfo) {
        // Same result as showLogin
    }
 
    @Override
    public void onFail(Error error) { }
});

PASS.autoLogin(object : LoginListener {
    override fun onSuccess(userInfo: UserInfo) {
        // Same result as showLogin
    }
 
    override fun onFail(error: Error?) { }
})

PASS.directLogin(SocialType.GOOGLE, new LoginListener() {
    @Override
    public void onSuccess(UserInfo userInfo) { /* signed in */ }
 
    @Override
    public void onFail(Error error) { /* handle failure */ }
});

PASS.directLogin(SocialType.GOOGLE, object : LoginListener {
    override fun onSuccess(userInfo: UserInfo) { /* signed in */ }
    override fun onFail(error: Error?) { /* handle failure */ }
})

PASS.logout();

PASS.logout()

# Domain and secret key come from your server's environment, never from a literal.
TIMESTAMP=$(date +%s)
SIG=$(printf '%s%s%s%s%s' "$VGA_SECRET_KEY" "$GAME_ID" "$USER_ID" "$TIMESTAMP" "$SESSION_ID" | md5sum | cut -d' ' -f1)
 
curl -X POST "$VGA_DOMAIN/api/login/checkSession" \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode "gameID=$GAME_ID" \
  --data-urlencode "userID=$USER_ID" \
  --data-urlencode "sessionID=$SESSION_ID" \
  --data-urlencode "timestamp=$TIMESTAMP" \
  --data-urlencode "sig=$SIG"

PASS.quickLogin(new LoginListener() {
    @Override
    public void onSuccess(UserInfo userInfo) { /* signed in */ }
 
    @Override
    public void onFail(Error error) { /* error on failure */ }
});

PASS.quickLogin(object : LoginListener {
    override fun onSuccess(userInfo: UserInfo) { /* signed in */ }
    override fun onFail(error: Error?) { /* error on failure */ }
})

VGSDKQuickAuth.showLogin(new VGSDKAuthenticationListener() {
    @Override
    public void onSuccess(UserInfo userInfo) { /* signed in */ }
 
    @Override
    public void onFail(Error error) { /* failed */ }
});

VGSDKQuickAuth.showLogin(object : VGSDKAuthenticationListener {
    override fun onSuccess(userInfo: UserInfo) { /* signed in */ }
    override fun onFail(error: Error?) { /* failed */ }
})

VGSDKQuickAuth.playAsGuest(new VGSDKAuthenticationListener() {
    @Override
    public void onSuccess(UserInfo userInfo) { /* signed in as guest */ }
 
    @Override
    public void onFail(Error error) { /* failed */ }
});

VGSDKQuickAuth.playAsGuest(object : VGSDKAuthenticationListener {
    override fun onSuccess(userInfo: UserInfo) { /* signed in as guest */ }
    override fun onFail(error: Error?) { /* failed */ }
})

VGSDKQuickAuth.showChannelSelection(new VGSDKAuthenticationListener() {
    @Override
    public void onSuccess(UserInfo userInfo) { /* signed in */ }
 
    @Override
    public void onFail(Error error) { /* failed */ }
});

VGSDKQuickAuth.showChannelSelection(object : VGSDKAuthenticationListener {
    override fun onSuccess(userInfo: UserInfo) { /* signed in */ }
    override fun onFail(error: Error?) { /* failed */ }
})

PASS.manageAccount(new ManageAccountListener() {
    @Override
    public void onBoundAccountSuccess(UserInfo userInfo) { /* bound */ }
 
    @Override
    public void onSwitchAccountSuccess(UserInfo userInfo) { /* switched */ }
 
    @Override
    public void onClose() { /* closed without change */ }
});

PASS.manageAccount(object : ManageAccountListener {
    override fun onBoundAccountSuccess(userInfo: UserInfo) { /* bound */ }
    override fun onSwitchAccountSuccess(userInfo: UserInfo) { /* switched */ }
    override fun onClose() { /* closed without change */ }
})

PASS.getProductList(Arrays.asList("item-1"), new ProductListListener() {
    @Override
    public void onFinished(List<SkuDetails> products) {
        // Render pricing, e.g. products.get(0).getPrice() (store-formatted)
    }
});

PASS.getProductList(listOf("item-1"), object : ProductListListener {
    override fun onFinished(products: List<SkuDetails>) {
        // Render pricing, e.g. products.firstOrNull()?.price (store-formatted)
    }
})

PaymentInfo info = new PaymentInfo();
info.setUserID("user-1");
info.setItemID("item-1");
info.setServerID("server-1");
info.setRoleID("role-1");
info.setAppTransID("txn-1");
info.setAddInfo("");
PASS.pay(info, new PaymentListener() {
    @Override public void onSuccess() { /* granted */ }
    @Override public void onProcessing() { /* awaiting external confirmation */ }
    @Override public void onCancel() { /* player canceled */ }
    @Override public void onFail(String message) { /* failed */ }
});

val info = PaymentInfo(
    userID = "user-1", itemID = "item-1", serverID = "server-1",
    roleID = "role-1", appTransID = "txn-1", addInfo = ""
)
PASS.pay(info, object : PaymentListener {
    override fun onSuccess() { /* granted */ }
    override fun onProcessing() { /* awaiting external confirmation */ }
    override fun onCancel() { /* player canceled */ }
    override fun onFail(message: String?) { /* failed */ }
})

PASS.checkItemReward(new CheckHasRewardListener() {
    @Override
    public void onSuccess(boolean isHas) {
        // true: a reward is pending, show the claim entry point
    }
 
    @Override
    public void onError(String s) {
        // The check could not complete: keep the entry point hidden
    }
});

PASS.checkItemReward(object : CheckHasRewardListener {
    override fun onSuccess(isHas: Boolean) {
        // true: a reward is pending, show the claim entry point
    }
 
    override fun onError(s: String?) {
        // The check could not complete: keep the entry point hidden
    }
})

RewardInfo rewardInfo = new RewardInfo();
rewardInfo.setUserID("user-1");
rewardInfo.setServerID("server-1");
rewardInfo.setAppTransID("txn-1");
rewardInfo.setAddInfo("");
rewardInfo.setRoleID("role-1");
PASS.verifyReward(rewardInfo, new VerifyRewardListener() {
    @Override public void onFinishSuccess(String message) { /* reward granted */ }
    @Override public void onFinishFailToRetry(String message) { /* transient: retrying is safe */ }
    @Override public void onFinishFailNonRetry(String message) { /* permanent, e.g. 9011: do not retry */ }
});

val rewardInfo = RewardInfo(
    userID = "user-1", serverID = "server-1", appTransID = "txn-1",
    addInfo = "", roleID = "role-1"
)
PASS.verifyReward(rewardInfo, object : VerifyRewardListener {
    override fun onFinishSuccess(message: String?) { /* reward granted */ }
    override fun onFinishFailToRetry(message: String?) { /* transient: retrying is safe */ }
    override fun onFinishFailNonRetry(message: String?) { /* permanent, e.g. 9011: do not retry */ }
})

// Bind role context once after login, before sending events
VGSDKAnalytics.miscConfigAnalytics("role-1", "Hero");

// Bind role context once after login, before sending events
VGSDKAnalytics.miscConfigAnalytics("role-1", "Hero")

// Pick the providers to send to; "" = no per-provider prefix
VGSDKAnalyticsPlatform facebook =
    new VGSDKAnalyticsPlatform(VGSDKAnalyticsProvider.facebook, "");
HashMap<String, Object> params = new HashMap<>();
params.put("level", 5);
VGSDKAnalytics.sendCustomEvent("level_up", params, facebook);

// Pick the providers to send to; "" = no per-provider prefix
val facebook = VGSDKAnalyticsPlatform(VGSDKAnalyticsProvider.facebook, prefix = "")
VGSDKAnalytics.sendCustomEvent("level_up", hashMapOf<String, Any?>("level" to 5), facebook)

// Sends to the SDK's default provider set (no platforms list)
HashMap<String, Object> params = new HashMap<>();
params.put("k", "v");
VGSDKAnalytics.miscCustomEvent("my_event", params);

// Sends to the SDK's default provider set (no platforms list)
VGSDKAnalytics.miscCustomEvent("my_event", hashMapOf<String, Any?>("k" to "v"))

VGSDKAnalytics.regAppOpen(new HashMap<>());

VGSDKAnalytics.regAppOpen(hashMapOf<String, Any?>())

VGSDKAnalytics.regGetConfiguration(new HashMap<>());

VGSDKAnalytics.regGetConfiguration(hashMapOf<String, Any?>())

VGSDKAnalytics.regCheckConfigurationStart(new HashMap<>());

VGSDKAnalytics.regCheckConfigurationStart(hashMapOf<String, Any?>())

VGSDKAnalytics.regCheckConfigurationEnd(new HashMap<>());

VGSDKAnalytics.regCheckConfigurationEnd(hashMapOf<String, Any?>())

VGSDKAnalytics.regCDNDownloadStart("10MB", new HashMap<>());

VGSDKAnalytics.regCDNDownloadStart("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regCDNDownload25("10MB", new HashMap<>());

VGSDKAnalytics.regCDNDownload25("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regCDNDownload50("10MB", new HashMap<>());

VGSDKAnalytics.regCDNDownload50("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regCDNDownload75("10MB", new HashMap<>());

VGSDKAnalytics.regCDNDownload75("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regCDNDownloadFinish("10MB", new HashMap<>());

VGSDKAnalytics.regCDNDownloadFinish("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regExtractResourceStart("10MB", new HashMap<>());

VGSDKAnalytics.regExtractResourceStart("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.regExtractResourceEnd("10MB", new HashMap<>());

VGSDKAnalytics.regExtractResourceEnd("10MB", hashMapOf<String, Any?>())

VGSDKAnalytics.nruJoinedServer("server-1", new HashMap<>());

VGSDKAnalytics.nruJoinedServer("server-1", hashMapOf<String, Any?>())

VGSDKAnalytics.nruNamedRole("server-1", new HashMap<>());

VGSDKAnalytics.nruNamedRole("server-1", hashMapOf<String, Any?>())

VGSDKAnalytics.nruCreateRoleSuccess("role-1", "server-1", new HashMap<>());

VGSDKAnalytics.nruCreateRoleSuccess("role-1", "server-1", hashMapOf<String, Any?>())

VGSDKAnalytics.nruTutorialStart("role-1", "server-1", "0", new HashMap<>());

VGSDKAnalytics.nruTutorialStart("role-1", "server-1", "0", hashMapOf<String, Any?>())

VGSDKAnalytics.nruTutorialProgress25("role-1", "server-1", "25", new HashMap<>());

VGSDKAnalytics.nruTutorialProgress25("role-1", "server-1", "25", hashMapOf<String, Any?>())

VGSDKAnalytics.nruTutorialProgress50("role-1", "server-1", "50", new HashMap<>());

VGSDKAnalytics.nruTutorialProgress50("role-1", "server-1", "50", hashMapOf<String, Any?>())