Hive 통합 모듈을 사용하기 위해서는 각 프로젝트에 맞게 세팅해야 한다. 세팅은 크게 세 가지로 나누어진다.
- Project 환경설정
- 마케팅 어트리뷰션 설정
- Build 설정
Unity, Android, iOS, Unreal 각각에 맞는 적절한 세팅이 필요하다.
Hive Module Error Code
| Hive Module error code | code | desc |
|---|---|---|
| Success | 0 | 성공 |
| Fail | -1 | 실패 |
| InvalidArg | -2 | 잘못된 인자 |
| FailOperation | -3 | 실행이 실패함 |
| CancelOperation | -4 | 실행이 취소됨 |
| FailInitialization | -5 | 초기화가 실패함 |
| NotSupported | -6 | 지원되지 않음 |
| OperationPending | -29 | 이미 요청중이거나 요청할 수 없는 상태 |
| PermissionDenied | -99 | 안드로이드 퍼미션 권한 거부 상태 |
| NeedLogin | -200 | 정식 유저로 로그인이 필요함 |
| NeedGuestLogin | -202 | 게스트 유저로 로그인이 필요함 |
| NeedRestore | -300 | 구매전 Restore가 필요한 경우 |
| NetworkError | -301 | 네트워크 통신 장애 |
| ServerResponseFail | -302 | 통신 성공 후 서버 결과가 fail일 경우 |
| PurchaseStateUnavilable | -303 | purchase/check에서 서버 응답이 리젝(유저 블락 등)일 경우, 통신 실패 아님 |
| PurchaseTransactionError | -304 | 마켓 구매 성공 후 모듈 서버와 통신에서 실패 시, Restore 필요 |
| NeedInitialize | -305 | 이니셜라이즈가 필요함 |
| RestoreNotOwnedItem | -306 | 리스토어할 아이템이 없음 |
| InvalidJsonFormat | -4000 | 잘못된 json 문자열 형식 |
| FailConvertToJsonFormat | -4001 | json 문자열 형식으로 변경할 수 없음 |
| FailCanMakePayments | -5000 | in app lock (ios) |
| Broken | -8001 | 데이터의 무결성이 깨짐 |
| MemoryExceed | -8002 | 메모리를 할당받을 수 없음 |
| Unknown | -1444445 | 알 수 없는 에러 |
Hub Error Code
| Hub error code | code | desc |
|---|---|---|
| HUB_E_SUCCESS | 0 | 성공 |
| HUB_E_INUSE | -8 | 현재 사용중이거나 이미 사용중 |
| HUB_E_INVALID | -9 | 매개변수가 잘못되었음 |
| HUB_E_NOTSUP | -16 | 해당 서비스를 지원하지 않음 |
| HUB_E_NOMEMORY | -17 | 메모리 부족 |
| HUB_E_NOTEXIST | -28 | 존재하지 않는 것 |
| HUB_E_FBNOTOPEN | -100 | 페이스북 세션이 열려있지 않음 |
| HUB_E_SOCIAL_NOTSUP | -101 | 앱에서 지원하지 않는 소셜 서비스임 |
| HUB_E_UNKNOWN | 1100 | 알수 없는, 또는 기타 에러 상황 |
| HUB_E_NOT_CONNECT_DB | 1101 | DB 접속 에러 |
| HUB_E_INVALID_URL | 1200 | (Corresponds to HTTP 404 Error) – 없는 URL |
| HUB_E_INVALID_JSON | 1201 | 잘못된 포맷의 요청을 보냈을 때 (JSON 파싱 실패 등) |
| HUB_E_AUTH_FAIL | 1300 | 쿠키 인증 등이 실패했을 때 |
| HUB_E_DEVICE_DENIED | 1400 | 디바이스가 차단되어서 서비스를 더 이상 제공할 수 없음 |
| HUB_E_USER_DENIED | 1401 | 유저가 차단되어서 서비스를 더 이상 제공할 수 없음 |
| HUB_E_GUEST_API_DENIED | 1402 | 정식 유저의 인증 쿠키가 존재하는 상태에서는 게스트 생성 또는 인증 API를 사용할 수 없음 |
| HUB_E_GATEWAY_TIMEOUT | 1500 | 외부 시스템 연결시 타임아웃 발생 |
| HUB_E_GATEWAY_BAD_RESPONSE | 1501 | 외부 시스템에서 정상적이지 않은 응답을 보냈을 때 |
| HUB_E_SYSTEM_ERROR | 2000 | 기타 시스템에서 전달되는 네트워크 에러 (Hive SDK v1.16.0부터 2000, 2100, 2101, 2102로 에러코드 세분화) |
| HUB_E_DIALOG_CLOSE | 2001 | 사용자에 의해 다이얼로그 닫힘 |
| HUB_E_SOCIAL_AUTH_FAIL | 2002 | 외부 소셜 서비스 인증 에러 |
| HUB_E_SOCIAL_REQUEST_FAIL | 2003 | 외부 소셜 서비스 에러 |
| HUB_E_NETWORK_TIMEOUT | 2100 | 네트워크 요청 시 타임아웃이 발생 (Hive v1.16.0+) |
| HUB_E_NETWORK_BAD_RESPONSE | 2101 | 수신한 응답 포맷이 잘못되었을 때 (Hive v1.16.0+) |
| HUB_E_SSL_ERROR | 2102 | Android 웹뷰 SSL 에러 발생 (Hive v1.16.0+) |
LoginCenter Error Code
| Hive Module error code | code | desc |
|---|---|---|
| Success | 0 | 성공 |
| Server Error | 1 | 서버 내부 에러 |
| Invalid AppID | 2 | 등록되지 않은 AppID |
| Invalid GameID | 3 | 등록되지 않은 GameID (현재는 AppID만 보고 판단하므로 미사용) |
| Invalid Api | 4 | 유효하지 않은 API 호출 |
| Invalid platform | 5 | 유효하지 않은 platform (현재는 Hive만 사용하므로 미사용) |
| Invalid account | 6 | 발급되지 않았거나 유효하지 않은 VID |
| Invalid Sessionkey | 10 | 유효하지 않은 세션. 해당 VID의 세션키가 변경되었거나 잘못된 세션키를 보냈을 경우. |
| Kakao server connect error | 100 | 정식로그인시 카카오 서버로 세션검증을 위한 연결 시도 실패 (현재 카카오는 지원 안함) |
| Kakao auth error | 101 | 정식로그인시 카카오서버를 통한 카카오 계정 세션검증 실패 (현재 카카오는 지원 안함) |
| Hub server connection error | 102 | 정식로그인시 Hive 소셜 서버로 세션검증을 위한 연결 시도 실패 |
| Hub auth error | 103 | 정식 로그인 시 Hive 소셜 서버를 통한 UID 세션검증 실패 |
| database connect fail | 1000 | 내부 Database 연결 실패로 처리 불가 상태 |
| database error | 1001 | Database 연결은 되었으나 처리를 할 수 없는 에러 발생 |
| blocking | 2000 | 블럭된 유저(vid, uid, did)로 로그인 실패 |