Hub/docs/methods/CS hubGuestBind

 

CS_hubGuestBind

Description

  • Guest사용자를 hub의 실사용자로 전환한다. 계정 전환이 성공하면 전환된 실사용자의 인증 정보가 전달된다.


Format

int CS_hubGuestBind(
    const char *guestUid,
    const char *candidateUid,
    HubCallbackWithJSON closeCallback,
    void *callbackParam
);


Parameters

  • [in] const char * guestUid
전환 가입할 guest User Id

 

  • [in] const char * candidateUid
전환 될 실사용자의 User Id

 

계정 전환 처리가 완료되었을 때 호출될 callback함수
계정 전환 처리 결과가 jsonString인자로 전달된다.

 

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


Return Value

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

 

  • HUB_E_INVALID
    • guestUid 또는 candidateUid가 NULL 이거나 빈 문자열("")이 전달됨.

 

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

 

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

 

  • HUB_E_SUCCESS
    • API 호출 성공.


Note

  • N/A


Sample Code

const char *guestUid = "90000000025";
const char *candidateUid = "12345678";

CS_hubGuestBind(guestUid, candidateUid, hubCloseCallback, NULL);


JSON

Key Data Type Value
"type" string "guest/bind"
"error_code" number  
error_code가 HUB_SERVER_E_SUCCESS 일 때,
"uid" string 전환된 실사용자의 User Id
"did" string 전환된 실사용자의 Device Id
"sessionkey" string 전환된 실사용자의 세션키
error_code != HUB_SERVER_E_SUCCESS 일 때,
"error_msg" string 에러 메시지
계정 전환 성공 시,
{
    "type": "guest/bind",
    "error_code": 0,
    "did": "8311806",
    "uid": "27881470",
    "sessionkey": "8f0778438075d3ff3b613bc9599bb9"
}
계정 전환 실패 시 (이것은 예시일 뿐이며 다양한 에러 상황이 있을 수 있음),
{
    "type": "guest/bind",
    "error_code": 1100,
    "error_msg": "guest_uid_is_not_match"
}


Related Method