Create User / Login

TalkPlus supports anonymous and token-based login. In order to use token-based login, you must call /api/users/create and /api/users/login from our REST API endpoints to create user and obtain user login token.

If you need translation feature, see below.

Message translation feature is provided through Google Cloud Translation. To use this feature, register an appropriate Google Cloud Service Account Key on our dashboard.

• To enable message translation, provide the language code (ISO-639) in translationLanguage property of TPLoginParams object when logging in.

• Supported languages (ISO-639) can be found here.

• Calling 'getTranslatedText' on TPMessage object will return a Key-Value map. Translated text(value) can be accessed from the map by using language code (used in 'translationLanguage' parameter) as key.

1. Anonymous User

You need a unique user ID and a username to login anonymously.

You need to allow Anonymous User Login option under App Settings in the dashboard to use this feature.

If translationLanguage property in TPLoginParams is set, TPMessage object received via "onMessageReceived" callback event will contain translated text for that language.

• Setting the translation language here enables realtime messages handled via callback events to be translated.

• TPLoginParams class is available starting from TalkPlus Android SDK v0.5.3.

Java

// manually set profile image URL
TPLoginParams params = 
    new TPLoginParams.Builder(userID, TPLoginParams.LoginType.ANONYMOUS)
        .setUserName(userName)
        .setProfileImageUrl(profileImageUrl)
        .setMetaData(metaData)
        .build();
        
TalkPlus.login(params, 
    new TalkPlus.CallbackListener<TPUser>() {
        @Override
        public void onSuccess(TPUser tpUser) {
        }
        
        @Override
        public void onFailure(int i, Exception e) {
        }
    }
);

// upload profile image file
TPLoginParams params = 
    new TPLoginParams.Builder(userID, TPLoginParams.LoginType.ANONYMOUS)
        .setUserName(userName)
        .setProfileImageFile(profileImageFile)
        .setMetaData(metaData)
        .build();
        
TalkPlus.login(params, 
    new TalkPlus.CallbackListener<TPUser>() {
        @Override
        public void onSuccess(TPUser tpUser) {
        }
        @Override
        public void onFailure(int i, Exception e) {
        }
    }
);

With profile image file upload

// manually set profile image URL
val params = TPLoginParams.Builder(userID, TPLoginParams.LoginType.ANONYMOUS)
    .setUserName(userName)
    .setProfileImageUrl(profileImageUrl)
    .setMetaData(metaData)
    .build()
        
TalkPlus.login(params, object : TalkPlus.CallbackListener<TPUser>() {
    override fun onSuccess(TPUser tpUser) { }   
    override fun onFailure(int i, Exception e) {}
})

// upload profile image file
val params = TPLoginParams.Builder(userID, TPLoginParams.LoginType.ANONYMOUS)
    .setUserName(userName)
    .setProfileImageFile(profileImageFile)
    .setMetaData(metaData)
    .build()
        
TalkPlus.login(params, object : TalkPlus.CallbackListener<TPUser>() {
    override fun onSuccess(TPUser tpUser) { }   
    override fun onFailure(int i, Exception e) { }
})

2. Token User

You need a unique user ID, a username and a login token to login.

You need to call /api/users/create and /api/users/login from our REST API endpoints to obtain login token.

If translationLanguage property in TPLoginParams is set, TPMessage object received via "onMessageReceived" callback event will contain translated text for that language.

• Setting the translation language here enables realtime messages handled via callback events to be translated.

• TPLoginParams class is available starting from TalkPlus Android SDK v0.5.3.

Java

// manually set profile image URL
TPLoginParams params = 
    new TPLoginParams.Builder(userID, TPLoginParams.LoginType.TOKEN)
        .setLoginToken(loginToken)
        .setUserName(userName)
        .setProfileImageUrl(profileImageUrl)
        .setMetaData(metaData)
        .build();
        
TalkPlus.login(params, 
    new TalkPlus.CallbackListener<TPUser>() {
        @Override
        public void onSuccess(TPUser tpUser) {
        }
        
        @Override
        public void onFailure(int i, Exception e) {
        }
    }
);

// upload profile image file
TPLoginParams params = 
    new TPLoginParams.Builder(userID, TPLoginParams.LoginType.TOKEN)
        .setLoginToken(loginToken)
        .setUserName(userName)
        .setProfileImageFile(profileImageFile)
        .setMetaData(metaData)
        .build();
        
TalkPlus.login(params, 
    new TalkPlus.CallbackListener<TPUser>() {
        @Override
        public void onSuccess(TPUser tpUser) {
        }
        @Override
        public void onFailure(int i, Exception e) {
        }
    }
);

Kotlin

// manually set profile image URL
val params = TPLoginParams.Builder(userID, TPLoginParams.LoginType.TOKEN)
    .setLoginToken(loginToken)
    .setUserName(userName)
    .setProfileImageUrl(profileImageUrl)
    .setMetaData(metaData)
    .build()
        
TalkPlus.login(params, object : TalkPlus.CallbackListener<TPUser>() {
    override fun onSuccess(TPUser tpUser) { }   
    override fun onFailure(int i, Exception e) {}
})

// upload profile image file
val params = TPLoginParams.Builder(userID, TPLoginParams.LoginType.TOKEN)
    .setLoginToken(loginToken)
    .setUserName(userName)
    .setProfileImageFile(profileImageFile)
    .setMetaData(metaData)
    .build()
        
TalkPlus.login(params, object : TalkPlus.CallbackListener<TPUser>() {
    override fun onSuccess(TPUser tpUser) { }   
    override fun onFailure(int i, Exception e) { }
})