Hub/docs/methods/CS hubGuestAcquireUid

 

CS_hubGuestAcquireUid

Description

  • Guest사용자를 hub의 실사용자로 전환하기 위하여 전환할 실사용자의 uid를 얻기 위해 사용한다. 이 함수는 다이얼로그를 노출하여 아래 인증 방법 중 한가지를 선택하여 uid를 얻을 수 있다.
    • 아이디 / 패스워드 인증
    • 외부 소셜 서비스 계정 인증
    • 회원 가입
  • 위의 방법으로 인증된 실사용자의 uid만 획득되고, 실제 로그인은 guest사용자의 uid와 실사용자의 uid가 연결(CS_hubGuestBind)된 후에 이루어진다.


Format

int CS_hubGuestAcquireUid(
    HubCallbackWithJSON closeCallback,
    void *callbackParam
);


Parameters

실사용자의 uid가 획득 되었거나 사용자가 닫힘 버튼을 눌렀을 때 호출될 callback함수
실사용자의 uid 획득 결과가 jsonString인자로 전달된다.

 

  • [in] void * callbackParam
closeCallback의 param인자로 전달되는 값


Return Value

  • HUB_E_NOTSUP
    • Hub 모듈이 초기화되지 않음.

 

  • HUB_E_INUSE
    • 다이얼로그를 이미 사용 중임.

 

  • HUB_E_NOMEMORY
    • 메모리 부족으로 다이얼로그 생성 실패.

 

  • HUB_E_SUCCESS
    • API 호출 성공.


Note

  • N/A


JSON

  • UID 획득에 성공한 경우
Key Data Type Value
"type" string "guest/acquire_uid"
"error_code" number HUB_SERVER_E_SUCCESS
"uid" string 실사용자의 uid
"did" string 실사용자의 uid를 획득한 단말의 did. 게임 서버에서 계정 전환 시, uid 검증 용으로 사용됨.
uid 획득 성공 시,
{
    "type": "guest/acquire_uid",
    "error_code": 0,
    "uid": "27881470",
    "did":"8311806"
}
  • 사용자가 취소한 경우
Key Data Type Value
"type" string "guest/acquire_uid"
"error_code" number HUB_E_DIALOG_CLOSE
"error_msg" string "Dialog closed."
인증 취소 시,
{
    "type": "guest/acquire_uid",
    "error_code": 2002
    "error_msg": "Dialog closed.",
}


Related Method