사용자 생성 / 로그인

TalkPlus는 익명 사용자 기반의 로그인, 토큰 기반의 로그인을 지원합니다. 토큰 기반의 로그인을 지원하기 위해서는 REST API 중 /api/users/create, /api/users/login 를 통하여 유저를 생성/로그인한 후 토큰을 생성하여 사용할 수 있습니다.

번역 기능이 필요할 경우 아래 내용을 확인하여 주십시오.

메시지 번역 기능은 구글 클라우드 번역 서비스를 통하여 지원됩니다. 이 기능을 사용하려면 톡플러스 대쉬보드(TalkPlus Dashboard)에서 구글 클라우드 서비스 계정 KEY 를 추가하여 주십시오.

• 번역 기능을 사용 할 경우, TPLoginParams 객체의 translationLanguage 멤버에 번역 될 언어 코드 (ISO-639) 값을 입력하여 주십시오.

• 사용할 수 있는 언어 코드 (ISO-639) 값은 아래 링크를 참조하여 주십시오. https://cloud.google.com/translate/docs/languages

• TPMessage 객체의 'getTranslatedText' 메소드를 호출하면 Key-Value 형태의 타입으로 번역 결과물이 반환되며, 'translationLanguage' 파라미터에 사용한 언어 코드 (ISO-639) 값을 키(KEY) 값으로 사용하면 번역된 텍스트(Value)를 가져올 수 있습니다.

1. Anonymous User

Unique ID, 사용자 닉네임을 사용하여 익명 로그인을 할 수 있습니다.

이 기능을 사용하려면, 대시보드에 있는 앱 설정에서 Anonymous User기능을 활성화 해야합니다.

TPLoginParams 객체의 translationLanguage 멤버에 값을 설정할 경우, "onMessageReceived" 콜백 이벤트를 통하여 수신되는 TPMessage 객체에 번역된 메시지 정보가 포함되어 있습니다.

• 메시지를 수신하는 측에서 콜백 이벤트를 통해서 번역된 메시지를 받는 기능으로써, 기본 값으로 사용할 번역 언어를 설정 하십시오.

• TPLoginParams 클래스는 TalkPlus Android SDK v0.5.3 이상에서 지원됩니다.

Java

// 이미지 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) {
        }
    }
);

// 이미지 파일 업로드 방식
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) {
        }
    }
);

Kotlin

// 이미지 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) {}
})

// 이미지 파일 업로드 방식
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

login Token, Unique ID, 사용자 닉네임을 사용하여 로그인을 할 수 있습니다.

REST API 중 /api/users/create, /api/users/login 를 통하여 유저를 생성/로그인한 후 토큰을 생성해야 합니다.

TPLoginParams 객체의 translationLanguage 멤버에 값을 설정할 경우, "onMessageReceived" 콜백 이벤트를 통하여 수신되는 TPMessage 객체에 번역된 메시지 정보가 포함되어 있습니다.

• 메시지를 수신하는 측에서 콜백 이벤트를 통해서 번역된 메시지를 받는 기능으로써, 기본 값으로 사용할 번역 언어를 설정 하십시오.

• TPLoginParams 클래스는 TalkPlus Android SDK v0.5.3 이상에서 지원됩니다.

Java

// 이미지 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) {
        }
    }
);

// 이미지 파일 업로드 방식
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

// 이미지 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) {}
})

// 이미지 파일 업로드 방식
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) { }
})