HIVE SDK 초기화 및 HIVE 인증 기능을 제공한다
HIVE SDK 는 xml 설정 파일을 기반으로 초기화를 수행한다.
더 자세히 ...
클래스 | |
class | hive.AuthV4 |
HIVE SDK 초기화 및 HIVE 인증 기능을 제공한다 HIVE SDK 는 xml 설정 파일을 기반으로 초기화를 수행한다. 더 자세히 ... | |
class | hive.AuthV4.ProfileInfo |
유저의 프로필 정보 playerID : 유저의 고유한 ID playerName : 외부에 보여질 유저의 닉네임, 처음 연결된 Provider 의 정보로 채워지며 HIVE 멤버쉽으로 연동한 사용자는 변경이 가능하다. 더 자세히 ... | |
class | hive.AuthV4.PlayerInfo |
사인-인 유저의 정보 프로필 정보 (ProfileInfo) 와 함께 유저의 토큰과 DID 값이 포함되어 있다. 더 자세히 ... | |
class | hive.AuthV4.ProviderInfo |
프로바이더 정보 연결된 프로바이더의 UserId 를 포함하고 있다. 더 자세히 ... | |
class | hive.AuthV4.AuthV4MaintenanceInfo |
서버 점검 및 업데이트 상태 표시 정보 title : 점검 제목 message : 점검 내용 button : 버튼의 Text 문구 ex) 확인 action : 버튼을 눌렀을때 동작될 행동 url : action 이 OPEN_URL 일 경우에 브라우징 될 URL remainingTime : EXIT 일 경우 점검 완료까지 남은 초단위 시간. 더 자세히 ... | |
class | hive.AuthV4.AuthV4MaintenanceExtraButton |
점검 팝업을 커스터마이징 하기 위한 버튼 정보 action : 버튼을 눌렀을때 동작될 행동 url : action 이 OPEN_URL 일 경우에 브라우징 될 URL button : 버튼의 Text 문구 ex) 확인 더 자세히 ... | |
class | hive.AuthV4.ParentalConsentInfo |
보호자 동의 정보 유저의 생년월일과 보호자의 이메일 주소가 포함되어 있다. 더 자세히 ... | |
열거형 타입 | |
enum | hive.AuthV4.ProviderType |
Provider 형태 정의 여기서 AUTO 는 자동로그인의 용도로 쓰이며 isAutoSignIn() 이 true 일 경우 SignIn 시 AUTO 로 입력해 주면 된다. 더 자세히 ... | |
enum | hive.AuthV4.AuthV4MaintenanceActionType |
점검 화면에서 버튼을 눌렀을때 동작될 행동 OPEN_URL : 외부 브라우저로 전달된 URL 을 실행 EXIT : 앱 종료 DONE : 아무 처리 하지 않고 점검 팝업 종료 더 자세히 ... | |
함수 | |
delegate void | hive.AuthV4.onAuthV4Setup (ResultAPI result, Boolean isAutoSignIn, String did, List< ProviderType > providerTypeList) |
AuthV4 초기화 결과 통지 result : 최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 실패한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4SignIn (ResultAPI result, PlayerInfo playerInfo) |
AuthV4 사인-인 결과 통지 result : SUCCESS 가 아닐 경우 다시 로그인 화면으로 돌아가야한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4SignOut (ResultAPI result) |
AuthV4 사인-아웃 결과 통지 result : setup 이 되지 않았거나 (NEED_INITIALIZE) SignIn 혹은 SignOut 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4Connect (ResultAPI result, PlayerInfo conflictPlayer) |
AuthV4 Provider 연동 결과 통지 result : 지원하지 않는 ProviderType (INVALID_PARAM) 이거나 Sign 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4Disconnect (ResultAPI result) |
AuthV4 Provider 연동 해지 결과 통지 인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4GetProfile (ResultAPI result, List< ProfileInfo > profileInfoList) |
AuthV4 Profile Profile 정보 요청 결과 통지 프로필 서버에 요청한 playerId 들에 대한 profile 정보를 전달한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowProfile (ResultAPI result) |
AuthV4 Profile UI 요청 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowInquiry (ResultAPI result) |
AuthV4 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowMyInquiry (ResultAPI result) |
AuthV4 내 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowChatbotInquiry (ResultAPI result) |
AuthV4 챗봇 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowTerms (ResultAPI result) |
AuthV4 약관 다시보기 정보 표시 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4AdultConfirm (ResultAPI result) |
AuthV4 성인인증 정보 표시 결과 통지 UI 창이 닫히면 호출 된다. 더 자세히 ... | |
delegate void | hive.AuthV4.onDeviceProviderInfo (ResultAPI result, ProviderInfo providerInfo) |
AuthV4 Provider 상태 조회 결과 통지 요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4Maintenance (ResultAPI result, List< AuthV4MaintenanceInfo > maintenanceInfoList) |
AuthV4 서버 점검 조회 결과 통지 Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onGetProviderFriendsList (ResultAPI result, ProviderType providerType, Dictionary< String, Int64 > providerUserIdList) |
HIVE SDK 사용자 Provider 친구목록의 profile 요청 결과 통지. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ResolveConflict (ResultAPI result) |
resolveConflict(AuthV4ResolveConflictListener) 호출 결과 통지 AuthV4.resolveConflict() 에서 사용앱 내에서 로그아웃 할 수 없는 IdP (Apple GameCenter)의 경우 로그아웃은 불가능 하다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4ShowDeviceManagement (ResultAPI result) |
showDeviceManagement(AuthV4ShowDeviceManagementListener) 호출 결과 통지 AuthV4.showDeviceManagement() 에서 사용기기 관리 서비스를 이용하면서 등록이 안된 기기는 로그인이 불가능 하다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4RefreshAccessToken (ResultAPI result, string accessToken) |
refreshAccessToken(onAuthV4RefreshAccessToken) 호출 결과 통지 AuthV4.refreshAccessToken() 에서 사용accessToken을 갱신한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4GetAccountPlayerIdList (ResultAPI result, List< Int64 > playerId) |
플레이어 ID 반환 콜백 타입 정의 플레이어 ID 반환 결과를 처리하는 콜백 함수 타입을 정의한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4StorePlayerId (ResultAPI result) |
현재 로그인된 세션을 저장하는 콜백 타입 정의 현재 로그인된 세션을 저장하는 기능에 대한 콜백 함수 타입을 정의한다. 더 자세히 ... | |
delegate void | hive.AuthV4.onAuthV4DeletePlayerId (ResultAPI result) |
세션 정보 삭제 콜백 타입 정의 세션 정보 삭제 결과를 처리하는 콜백 함수 타입을 정의한다. 더 자세히 ... | |
static void | hive.AuthV4.setup (onAuthV4Setup listener) |
AuthV4 초기화를 수행한다. 더 자세히 ... | |
static void | hive.AuthV4.signIn (ProviderType providerType, onAuthV4SignIn listener) |
주어진 providerType 에 따라 signIn 을 요청 한다. 더 자세히 ... | |
static void | hive.AuthV4.signInWithAuthKey (String authKey, onAuthV4SignIn listener) |
자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 signIn을 요청 한다. 더 자세히 ... | |
static void | hive.AuthV4.signOut (onAuthV4SignOut listener) |
현재 세션을 제거 한다. 더 자세히 ... | |
static void | hive.AuthV4.playerDelete (onAuthV4SignOut listener) |
서버에 계정 삭제를 요청하고 연동된 모든 Provider 들을 해제 한다. 더 자세히 ... | |
static void | hive.AuthV4.connect (ProviderType providerType, onAuthV4Connect listener) |
현재 사인-인 된 유저에 요청한 provider 와 연동 한다. 더 자세히 ... | |
static void | hive.AuthV4.connectWithAuthKey (String authKey, onAuthV4Connect listener) |
자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 connect를 요청 한다. 더 자세히 ... | |
static void | hive.AuthV4.disconnect (ProviderType providerType, onAuthV4Disconnect listener) |
현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다. 더 자세히 ... | |
static void | hive.AuthV4.disconnectWithName (String providerName, onAuthV4Disconnect listener) |
현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다. 더 자세히 ... | |
static void | hive.AuthV4.selectConflict (Int64 selectedPlayerId, onAuthV4SignIn listener) |
connect 로 인한 계정 충돌 상황 (CONFLICT_PLAYER) 일 때 유저를 선택 한다. 더 자세히 ... | |
static Boolean | hive.AuthV4.isAutoSignIn () |
signIn(AUTO) 가 가능한지 여부를 반환한다. 더 자세히 ... | |
static PlayerInfo | hive.AuthV4.getPlayerInfo () |
현재 사인-인 된 유저의 정보를 반환 한다. 더 자세히 ... | |
static void | hive.AuthV4.getProfile (List< Int64 > playerIdList, onAuthV4GetProfile listener) |
요청한 playerId 들의 프로필 정보를 반환한다. 더 자세히 ... | |
static void | hive.AuthV4.showSignIn (onAuthV4SignIn listener) |
사인-인 을 할 수 있는 Provider 목록이 있는 UI 를 띄운다. 더 자세히 ... | |
static void | hive.AuthV4.showConflictSelection (JSONObject currentPlayerData, JSONObject conflictPlayerData, onAuthV4SignIn listener) |
충돌상태에서 유저를 선택하는 UI 를 띄운다. 더 자세히 ... | |
static void | hive.AuthV4.showProfile (Int64 playerId, onAuthV4ShowProfile listener) |
요청한 playerId 의 프로필 UI 를 표시한다. 더 자세히 ... | |
static void | hive.AuthV4.showInquiry (onAuthV4ShowInquiry listener) |
1:1 문의 UI 를 띄운다. 더 자세히 ... | |
static void | hive.AuthV4.showMyInquiry (onAuthV4ShowMyInquiry listener) |
내 문의 UI 를 띄운다. 더 자세히 ... | |
static void | hive.AuthV4.showChatbotInquiry (String additionalInfo, onAuthV4ShowChatbotInquiry listener) |
HIVE 챗봇 1:1 문의 화면 호출 더 자세히 ... | |
static void | hive.AuthV4.showTerms (onAuthV4ShowTerms listener) |
약관 정보를 표시한다. 더 자세히 ... | |
static void | hive.AuthV4.resetAgreement () |
약관 동의 기록을 초기화한다. | |
static void | hive.AuthV4.showAdultConfirm (onAuthV4AdultConfirm listener) |
성인 인증을 요청한다. 더 자세히 ... | |
static void | hive.AuthV4.checkProvider (ProviderType providerType, onDeviceProviderInfo listener) |
요청한 Provider 의 상태를 체크 한다. 더 자세히 ... | |
static void | hive.AuthV4.checkMaintenance (Boolean isShow, onAuthV4Maintenance listener) |
점검 상태 표시 및 데이터 반환한다. 더 자세히 ... | |
static void | hive.AuthV4.checkBlacklist (Boolean isShow, onAuthV4Maintenance listener) |
현재 유저의 제재 상태를 체크한다. 더 자세히 ... | |
static void | hive.AuthV4.setProviderChangedListener (onDeviceProviderInfo listener) |
연동된 Provider 의 정보가 바뀌었는지 통보 받는다. 더 자세히 ... | |
static Boolean | hive.AuthV4.getAgeGateU13 () |
COPPA 13세 나이 제한 여부를 반환한다. 더 자세히 ... | |
static void | hive.AuthV4.getProviderFriendsList (ProviderType providerType, onGetProviderFriendsList listener) |
입력받은 providerType 에 해당하는 연결된 사용자의 친구들의 playerId 목록 정보를 얻어온다. 더 자세히 ... | |
static void | hive.AuthV4.resolveConflict (onAuthV4ResolveConflict listener) |
connect 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다. 더 자세히 ... | |
static void | hive.AuthV4.showDeviceManagement (onAuthV4ShowDeviceManagement listener) |
기기 관리 서비스를 호출한다. 더 자세히 ... | |
static void | hive.AuthV4.refreshAccessToken (onAuthV4RefreshAccessToken listener) |
refreshAccessToken(onAuthV4RefreshAccessToken) 호출 결과 통지 AuthV4.refreshAccessToken() 에서 사용accessToken을 갱신한다. 더 자세히 ... | |
static void | hive.AuthV4.requestPermissionViewData (onAuthV4RequestPermissionViewData listener) |
권한고지 팝업을 구성하기 위한 데이터를 얻습니다. 더 자세히 ... | |
static void | hive.AuthV4.showGameCenterLoginCancelDialog (onAuthV4DialogDismiss listener) |
Game Center 로그인창을 표시할 수 없는 경우, 해당 상태를 보여주고, Game Center 로그인 방법을 안내하는 UI를 띄운다. | |
static void | hive.AuthV4.signInWithStoredPlayerId (Int64 playerId, Boolean useAutoSignIn, onAuthV4SignIn listener) |
PlayerID를 이용하여 로그인 요청을 수행한다. 더 자세히 ... | |
static void | hive.AuthV4.getStoredPlayerIdList (onAuthV4GetAccountPlayerIdList listener) |
저장된 플레이어 ID 리스트를 반환한다. 더 자세히 ... | |
static void | hive.AuthV4.storeCurrentPlayerId (onAuthV4StorePlayerId listener) |
현재 로그인된 세션을 저장한다. 더 자세히 ... | |
static void | hive.AuthV4.deleteStoredPlayerId (Int64 playerId, onAuthV4DeletePlayerId listener) |
저장된 세션 정보를 삭제한다. 더 자세히 ... | |
static ParentalConsentInfo | hive.AuthV4.getParentalConsentInfo () |
보호자 동의 정보를 반환한다. 더 자세히 ... | |
HIVE SDK 초기화 및 HIVE 인증 기능을 제공한다
HIVE SDK 는 xml 설정 파일을 기반으로 초기화를 수행한다.
점검 화면에서 버튼을 눌렀을때 동작될 행동 OPEN_URL : 외부 브라우저로 전달된 URL 을 실행
EXIT : 앱 종료
DONE : 아무 처리 하지 않고 점검 팝업 종료
Provider 형태 정의 여기서 AUTO 는 자동로그인의 용도로 쓰이며
isAutoSignIn() 이 true 일 경우 SignIn 시 AUTO 로 입력해 주면 된다.
|
static |
현재 유저의 제재 상태를 체크한다.
기본적으로 signIn, connect 시에 자동으로 체크되며 제재 팝업을 띄운다.
앱 내에서 필요한 시점에 실시간으로 체크가 필요할 때 사용할 수 있다.
요청시 isShow 가 true 였을 경우 팝업 UI 가 노출된다.
결과가 SUCCESS 이지만 제재 내용이 없다면 listener 의 maintenanceInfo 는 비어있게 된다.
요청시 isShow 를 false 로 주었다면 listener 의 maintenanceInfo 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.
isShow | HIVE UI 를 사용할 지 여부 |
listener | onAuthV4Maintenance |
|
static |
점검 상태 표시 및 데이터 반환한다.
Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다.
SDK 의 초기화가 완료되면 서버 점검 및 업데이트 상태를 확인해야 한다.
서버 점검 및 업데이트는 게임 클라이언트의 업데이트 후에 하위 버전을 차단하거나, 게임 서버의 점검 시간 동안 게임 접속을 차단할 수 있다.
HIVE 콘솔에 설정된 정보에 따라 서버 점검 혹은 공지 팝업을 노출하는 기능을 제공한다.
요청시 isShow 가 true 였을 경우 점검 팝업 UI 가 노출된다.
결과가 SUCCESS 이지만 점검 공지 내용이 없다면 listener 의 maintenanceInfo 는 비어있게 된다.
요청시 isShow 를 false 로 주었다면 listener 의 maintenanceInfo 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.
isShow | HIVE UI 를 사용할 지 여부 |
listener | onAuthV4Maintenance |
|
static |
요청한 Provider 의 상태를 체크 한다.
요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다.
Login 에 성공하면 providerUserId 까지 얻어 온다.
현재 playerId 와 connect 를 요청하지는 않는다.
SUCCESS 는 조회에 성공했다는 뜻이며 providerInfo 에 providerUserId 여부로 로그인된 유저를 판단해야 한다.
실제 provider 에 로그인 되어있다면 providerUserId 가 존재한다. 그 외 providerType 만 존재.
Google Play Games, Apple Game Center 등 묵시적 사인-인 방식을 사용할 경우
providerType | 상태를 체크할 ProviderType |
listener | onDeviceProviderInfo |
|
static |
현재 사인-인 된 유저에 요청한 provider 와 연동 한다.
요청한 Provider 로 로그인을 시도 한 뒤, 로그인에 성공하면 인증서버에 연동 요청을 보낸다.
해당 Provider 의 UserId 에 이미 매칭된 playerId 가 있을 경우 listener 의 result 에 CONFLICT_PLAYER 에러를 내려준다.
이 경우 listener 에 포함되어 있는 conflictPlayer 객체의 충돌 유저 정보를 가지고 유저에게 계정 선택을 위한 UI 를 구성 해야한다.
유저가 선택을 하면 선택된 유저 정보로 selectConflict() 를 호출해 주면 된다.
직접 UI 를 구성하지 않을 경우 showConflictSelection() 을 이용할 수 있다.
이 경우 selectConflict() 까지 진행되며 사인-인 완료된 결과까지 받을 수 있다.
연동이 완료되면 해당 상태를 앱 내 UI 에 갱신해 준다.
BLACKLIST 일 경우 SDK에서 제재 팝업을 띄우고 BLACKLIST 에러를 내려 준다.
providerType | connect 요청할 ProviderType. AUTO 나 GUEST 는 INVALID_PARAM 에러를 발생시킨다. |
listener | onAuthV4Connect result : 지원하지 않는 ProviderType (INVALID_PARAM) 이거나 Sign 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다. SignIn 이 되지 않은 상태에서는 INVALID_SESSION 에러가 된다. 이미 연결되어있는 Provider 의 경우 INVALID_PARAM 에러가 되며 해당 Provider 에 대해 disconnect 를 먼저 호출 후 다시 connect 해야 한다. 연결을 시도한 Provider 가 이미 다른 playerId 에 연결되어 있을 경우 CONFLICT_PLAYER 가 되며 conflictPlayer 객체에 해당 충돌 유저 정보가 포함되어있다. conflictPlayer : result 가 CONFLICT_PLAYER 일 경우 충돌 유저에 대한 정보 이다. playerId 와 충돌난 ProviderInfo 의 정보만 포함되어있다. playerToken 은 비어 있음. |
|
static |
자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 connect를 요청 한다.
connect 에 성공하게 되면 handler 에 포함되어있는 playerInfo 를 통해 유저 정보를 얻는다.
authKey | AuthKey to request connect |
listener | onAuthV4Connect AuthV4 connect result callback |
|
static |
저장된 세션 정보를 삭제한다.
storeCurrentPlayerId에서 저장된 세션 정보를 playerId를 이용하여 찾아서 삭제한다.
deleteListener | onDeletePlayerId 세션 정보 삭제 결과 통지 |
playerId | 삭제할 세션 정보를 찾기 위한 PlayerID |
|
static |
현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.
인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.
인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다.
모든 연동이 해제될 경우 게스트 상태가 될 수 있으니 주의.
providerType | disconnect 요청할 ProviderType. |
listener | onAuthV4Disconnect result : 인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황, 또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다. 그 외 성공. |
|
static |
현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.
인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.
인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다.
disconnect 로 인해 연동이 모두 해제될 경우 게스트 상태가 될 수 있으니 주의.
providerName | disconnect to ProviderName. |
listener | onAuthV4Disconnect result : If delivery fails to the authentication server, if the Sign or setup is in progress, or if the provider is already disconnected, it may fail. Otherwise, success. |
|
static |
COPPA 13세 나이 제한 여부를 반환한다.
기본값은 false이며, AuthV4.setup() 나 로그인 시 COPPA 약관 동의에 따라 결정된다.
정상적인 값을 받으려면 약관동의 이후에 호출하여야 한다.
|
static |
보호자 동의 정보를 반환한다.
이용자의 생년월일과 보호자 이메일 주소가 포함된다.
보호자 동의 이후에 호출하여야 한다.
해당 정보는 보호자 동의 이후 앱 종료 이전까지만 유지된다.
|
static |
현재 사인-인 된 유저의 정보를 반환 한다.
PlayerInfo 에는 playerToken 을 포함하고 있으며
프로필 정보 (playerName, playerImageUrl) 까지 포함하고 있으나,
요청시 실시간으로 서버에 요청하지 않고 로컬에 캐쉬되어 있는 프로필 정보를 반환 한다.
getProfile 이나 showProfile 에서 사인-인 된 유저 자신일 경우 자동으로 캐쉬를 갱신한다.
|
static |
요청한 playerId 들의 프로필 정보를 반환한다.
playerId 중 사인-인 된 자신이 있을 경우 playerName 과 playerImageUrl 을 동기화 한다.
playerIdList | ArrayList<Long> |
listener | onAuthV4GetProfile |
|
static |
입력받은 providerType 에 해당하는 연결된 사용자의 친구들의 playerId 목록 정보를 얻어온다.
요청한 providerType의 providerId와 연결된 사용자의 playerId를 페어로 얻어온다.
FACEBOOK 의 경우 최대 5000명.
getProfile 을 사용하여 친구의 PlayerInfo 를 조회할 수 있다.
providerType | 친구목록을 조회할 연결된 ProviderType 값. |
listener | AuthV4ProviderFriendsListener |
|
static |
저장된 플레이어 ID 리스트를 반환한다.
signOut 시 저장된 플레이어 ID 리스트를 반환한다.
playerIdListener | onPlayerId 플레이어 ID 리스트 반환 결과 통지 |
|
static |
signIn(AUTO) 가 가능한지 여부를 반환한다.
AuthV4.setup() 호출 시 알려주는 값과 동일 하며,
로컬에 저장된 기존 세션만 체크 하기때문에 세션이 실제로 만료되지 않은 유효한 토큰인지는 알 수 없다.
true 일 경우 'TOUCH TO START' 등의 UI 를 통해 signIn(AUTO) 를 호출하고
여기서 실패할 경우 다시 초기 사인-인 씬으로 돌아가야 한다.
false 일 경우 AuthV4.setup() 호출 시 받은 providerList 를 통해 UI 를 구성하여 signIn 을 시도 하거나
showSignIn() 을 통해 HIVE 에서 제공하는 UI 를 사용하여도 된다.
앱 중간에 signOut 등 사인-인 씬으로 돌아왔을 경우 이 API 를 통해 UI 구성여부를 체크할 수 있다.
delegate void hive.AuthV4.onAuthV4AdultConfirm | ( | ResultAPI | result | ) |
AuthV4 성인인증 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.
result : 사인-인 이 필요하기 때문에 사인-인 이 되어있지 않을 경우 INVALID_SESSION 이 올 수 있다.
성인인증에 정상적으로 진행되었을 경우 SUCCESS 가 된다.
delegate void hive.AuthV4.onAuthV4Connect | ( | ResultAPI | result, |
PlayerInfo | conflictPlayer | ||
) |
AuthV4 Provider 연동 결과 통지 result : 지원하지 않는 ProviderType (INVALID_PARAM) 이거나
Sign 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다.
SignIn 이 되지 않은 상태에서는 INVALID_SESSION 에러가 된다.
이미 연결되어있는 Provider 의 경우 INVALID_PARAM 에러가 되며
해당 Provider 에 대해 disconnect 를 먼저 호출 후 다시 connect 해야 한다.
연결을 시도한 Provider 가 이미 다른 playerId 에 연결되어 있을 경우 CONFLICT_PLAYER 가 되며
conflictPlayer 객체에 해당 충돌 유저 정보가 포함되어있다.
conflictPlayer : result 가 CONFLICT_PLAYER 일 경우 충돌 유저에 대한 정보 이다.
playerId 와 충돌난 ProviderInfo 의 정보만 포함되어있다.
playerToken 은 비어 있음.
delegate void hive.AuthV4.onAuthV4DeletePlayerId | ( | ResultAPI | result | ) |
세션 정보 삭제 콜백 타입 정의 세션 정보 삭제 결과를 처리하는 콜백 함수 타입을 정의한다.
result | : API 호출 결과 |
delegate void hive.AuthV4.onAuthV4Disconnect | ( | ResultAPI | result | ) |
AuthV4 Provider 연동 해지 결과 통지 인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.
result : 인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnect 된 Provider 일 경우 실패가 될 수 있다.
그 외 성공.
delegate void hive.AuthV4.onAuthV4GetAccountPlayerIdList | ( | ResultAPI | result, |
List< Int64 > | playerId | ||
) |
플레이어 ID 반환 콜백 타입 정의 플레이어 ID 반환 결과를 처리하는 콜백 함수 타입을 정의한다.
result | : API 호출 결과 |
playerIdList | : 반환된 플레이어 ID 리스트 |
delegate void hive.AuthV4.onAuthV4GetProfile | ( | ResultAPI | result, |
List< ProfileInfo > | profileInfoList | ||
) |
AuthV4 Profile Profile 정보 요청 결과 통지 프로필 서버에 요청한 playerId 들에 대한 profile 정보를 전달한다.
result : 요청에 대한 결과. 실패일 경우 profileInfoList 는 비어있다.
profileInfoList : 요청한 playerId 들에 대한 profile 정보.
각각 playerId, playerName, playerImageUrl 이 포함되어 있다.
delegate void hive.AuthV4.onAuthV4Maintenance | ( | ResultAPI | result, |
List< AuthV4MaintenanceInfo > | maintenanceInfoList | ||
) |
AuthV4 서버 점검 조회 결과 통지 Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다.
요청시 isShow 가 true 였을 경우 점검 팝업이 노출되고 닫힌 이후에 불리게 된다.
result : 서버에 조회 요청이 성공하면 SUCCESS 가 된다.
SUCCESS 이지만 점검 공지 내용이 없다면 maintenanceInfo 는 비어있게 된다.
maintenanceInfo : 점검 공지 팝업에 노출되는 동작에 대한 정보 이다.
요청시 isShow 를 false 로 주었다면 이 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.
delegate void hive.AuthV4.onAuthV4RefreshAccessToken | ( | ResultAPI | result, |
string | accessToken | ||
) |
refreshAccessToken(onAuthV4RefreshAccessToken)
호출 결과 통지 AuthV4.refreshAccessToken() 에서 사용
accessToken을 갱신한다.
delegate void hive.AuthV4.onAuthV4ResolveConflict | ( | ResultAPI | result | ) |
resolveConflict(AuthV4ResolveConflictListener)
호출 결과 통지 AuthV4.resolveConflict() 에서 사용
앱 내에서 로그아웃 할 수 없는 IdP (Apple GameCenter)의 경우 로그아웃은 불가능 하다.
따라서, 이런경우 실제 IdP 로그아웃에 실패했어도 내부 충돌 정보는 삭제 됩니다.
delegate void hive.AuthV4.onAuthV4Setup | ( | ResultAPI | result, |
Boolean | isAutoSignIn, | ||
String | did, | ||
List< ProviderType > | providerTypeList | ||
) |
AuthV4 초기화 결과 통지 result : 최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 실패한다.
그 외 성공.
isAutoSignIn : 로컬에 이전 세션이 남아있는지 여부. true 일 경우 SignIn(ProviderType.AUTO) 을 호출 한다.
그 외의 경우 providerTypeList 중 하나로 SignIn 을 요청이 가능 하다.
providerTypeList : 현재 단말에서 사인-인 가능한 Provider List 이다.
단말의 현재 지역 (IP) 에 따라 다르게 보여질 수 있다.
GUEST 를 포함하고 있으며 일부 지역 혹은 환경에서는 GUEST 도 불가능 할 수 있다. (분산서버)
delegate void hive.AuthV4.onAuthV4ShowChatbotInquiry | ( | ResultAPI | result | ) |
AuthV4 챗봇 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.
result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.
delegate void hive.AuthV4.onAuthV4ShowDeviceManagement | ( | ResultAPI | result | ) |
showDeviceManagement(AuthV4ShowDeviceManagementListener)
호출 결과 통지 AuthV4.showDeviceManagement() 에서 사용
기기 관리 서비스를 이용하면서 등록이 안된 기기는 로그인이 불가능 하다.
따라서, 이런 경우 AuthV4NotRegisteredDevice 에러를 받게 된다.
delegate void hive.AuthV4.onAuthV4ShowInquiry | ( | ResultAPI | result | ) |
AuthV4 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.
result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.
delegate void hive.AuthV4.onAuthV4ShowMyInquiry | ( | ResultAPI | result | ) |
AuthV4 내 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.
delegate void hive.AuthV4.onAuthV4ShowProfile | ( | ResultAPI | result | ) |
AuthV4 Profile UI 요청 결과 통지 UI 창이 닫히면 호출 된다.
result : 입력된 playerId 가 잘못된 형태가 아니면 성공
delegate void hive.AuthV4.onAuthV4ShowTerms | ( | ResultAPI | result | ) |
AuthV4 약관 다시보기 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.
result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.
delegate void hive.AuthV4.onAuthV4SignIn | ( | ResultAPI | result, |
PlayerInfo | playerInfo | ||
) |
AuthV4 사인-인 결과 통지 result : SUCCESS 가 아닐 경우 다시 로그인 화면으로 돌아가야한다.
세션이 만료되었거나 정상적이지 않은 정보 일 경우 INVALID_SESSION 이 올 수 있으며
유저가 외부 로그인 창을 취소 하였을 경우 CANCELED,
서버 응답 지연 등에 의해 NETWORK 나 TIMEOUT 이 올 수 있다.
그 외 실패에 대한 상황은 RESPONSE_FAIL 이다.
playerInfo : result 가 SUCCESS 일 경우 playerInfo 에 사인-인에 성공한 유저의 정보가 담겨져 있다.
providerInfoData 에는 연결되어있는 Provider 의 정보가 들어있다. 없는 Provider 는 연결되어있지 않은 상태.
delegate void hive.AuthV4.onAuthV4SignOut | ( | ResultAPI | result | ) |
AuthV4 사인-아웃 결과 통지 result : setup 이 되지 않았거나 (NEED_INITIALIZE) SignIn 혹은 SignOut 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다.
그 외 성공
delegate void hive.AuthV4.onAuthV4StorePlayerId | ( | ResultAPI | result | ) |
현재 로그인된 세션을 저장하는 콜백 타입 정의 현재 로그인된 세션을 저장하는 기능에 대한 콜백 함수 타입을 정의한다.
result | : API 호출 결과 |
delegate void hive.AuthV4.onDeviceProviderInfo | ( | ResultAPI | result, |
ProviderInfo | providerInfo | ||
) |
AuthV4 Provider 상태 조회 결과 통지 요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다.
현재 playerId 와 connect 를 요청하지는 않는다.
result : SUCCESS 는 조회에 성공했다는 뜻이며 providerInfo 에 providerUserId 여부로 로그인된 유저를 판단해야 한다.
providerInfo : 실제 provider 에 로그인 되어있다면 providerUserId 가 존재한다. 그 외 providerType 만 존재.
delegate void hive.AuthV4.onGetProviderFriendsList | ( | ResultAPI | result, |
ProviderType | providerType, | ||
Dictionary< String, Int64 > | providerUserIdList | ||
) |
HIVE SDK 사용자 Provider 친구목록의 profile 요청 결과 통지.
result : API 호출 결과.
실패일 경우 providerUserIdList는 비어있다.
providerType : API 호출시 요청한 ProviderType.
providerUserIdList : 요청한 providerUserId들에 대한 id 정보.
|
static |
서버에 계정 삭제를 요청하고 연동된 모든 Provider 들을 해제 한다.
성공 시 로그인 된 모든 Provider 들을 로그아웃 시키며 로컬 세션을 제거하고 성공 콜백을 준다.
signIn/Out 이 진행중일 경우 IN_PROGRESS 가 발생할 수 있다.
listener | onAuthV4SignOut 계정 삭제 결과 통지 |
|
static |
refreshAccessToken(onAuthV4RefreshAccessToken)
호출 결과 통지 AuthV4.refreshAccessToken() 에서 사용
accessToken을 갱신한다.
|
static |
권한고지 팝업을 구성하기 위한 데이터를 얻습니다.
ResultAPI의 result가 success이며, result의 code가 AuthV4SkipPermissionView 가 아닐 경우 권한고지 데이터를 이용하여 권한고지를 출력 할 수 있습니다. PermissionViewData를 참조하여 UI를 구성하세요. 이 함수를 호출하여 권한고지팝업을 구성할 시 AuthV4.setup 을 호출하였을때 HIVE SDK의 권한고지 팝업은 나오지 않습니다.
listener | onAuthV4RequestPermissionViewData |
|
static |
connect 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다.
connect 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 에서 자체 UI 를 구성하였을 경우에 사용
충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다.
호출시 해당하는 IdP (Provider) 를 로그아웃하게 된다.
앱 내에서 로그아웃 할 수 없는 IdP (Apple GameCenter)의 경우 로그아웃은 불가능하고,
내부 충돌 정보만 삭제 된다.
listener | AuthV4ResolveConflictListener 실제 IdP 로그아웃에 실패했어도 내부 충돌 정보는 삭제 된다. |
|
static |
connect 로 인한 계정 충돌 상황 (CONFLICT_PLAYER) 일 때 유저를 선택 한다.
conncet 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 에서 자체 UI 를 구성하였을 경우
선택한 유저를 SDK에 통보해 주기 위해 호출 한다.
SDK 상태가 충돌 상태가 아니거나 signIn 이 진행중, 혹은 잘못된 playerId 일 경우 INVALID_PARAM 이 발생 할 수 있다.
충돌 상태가 되었다고 해도 selectConflict() 가 호출 되어 signIn 되기 전까지는 기존 유저가 signIn 된 상태로 본다.
showConflictSelection() 을 사용하였을 경우 호출할 필요가 없다.
selectedPlayerId | 선택한 유저의 playerId |
listener | onAuthV4SignIn SUCCESS 가 되기 전까지는 기존 유저가 signIn 된 상태이다. 주의. |
|
static |
연동된 Provider 의 정보가 바뀌었는지 통보 받는다.
Google Play Games, Apple Game Center 의 경우 앱 외에서 계정 정보가 변경 될 수 있다.
그렇기 때문에 앱이 resume (onStart) 될 때 유저 정보가 바뀌었는지 체크하게 되고,
바뀌었다면 해당 콜백이 불리게 된다.
콜백은 checkProvider() 이후나 connect 등으로 직접 연동 시도 된 이후부터 동작하게 된다.
묵시적 사인-인 방식으로 구현할 경우 signIn() 완료 시점에서 checkProvider() 를 통해 직접 비교 체크 하여야 한다.
listener | onDeviceProviderInfo |
|
static |
AuthV4 초기화를 수행한다.
Configuration 영역을 제외한 모든 API 중 가장 먼저 호출되어야 하며
선 호출이 되지 않을시 일부 API 에서는 NEED_INITIALIZE 에러가 발생할 수 있다.
이후 약관 동의, 다운로드 체크, DID 설정, config.xml 설정, ProviderList 설정 등이 진행 된다.
최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 listener 결과로 실패가 내려간다.
listener 에 포함된 providerTypeList 를 통해 signIn 에 필요한 UI 를 구성해야 한다.
직접 UI 를 구현하지 않을 시 showSignIn() 을 이용한다.
listener | onAuthV4Setup AuthV4 초기화 결과 통지 result : 최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 실패한다. 그 외 성공. isAutoSignIn : 로컬에 이전 세션이 남아있는지 여부. true 일 경우 SignIn(ProviderType.AUTO) 을 호출 한다. 그 외의 경우 providerTypeList 중 하나로 SignIn 을 요청이 가능 하다. providerTypeList : 현재 단말에서 사인-인 가능한 Provider List 이다. 단말의 현재 지역 (IP) 에 따라 다르게 보여질 수 있다. GUEST 를 포함하고 있으며 일부 지역 혹은 환경에서는 GUEST 도 불가능 할 수 있다. (분산서버) |
|
static |
성인 인증을 요청한다.
고스톱 / 포커류와 같이 성인 인증이 필요한 일부 게임의 경우 성인 인증 기능을 제공한다.
listener | onAuthV4AdultConfirm result : 사인-인 이 필요하기 때문에 사인-인 이 되어있지 않을 경우 INVALID_SESSION 이 올 수 있다. 성인인증에 정상적으로 진행되었을 경우 SUCCESS 가 된다. |
|
static |
HIVE 챗봇 1:1 문의 화면 호출
additionalInfo | 챗봇 페이지 바로가기 호출시 전달받기로한 약속된 JSON 형식의 String 데이터 |
listener | API 호출 결과 통지 |
|
static |
충돌상태에서 유저를 선택하는 UI 를 띄운다.
connect 시 CONFLICT_PLAYER 에러가 발생한 경우에 호출 하여 유저 선택이 가능한 UI 를 띄운다.
충돌난 playerId 에 해당하는 유저가 인식할 수 있는 정보 (닉네임, 레벨 등) 들을 포함하여 호출 하여야 한다.
playerData 에는 "player_id" 를 키로 playerId 를 넣어주어야 한다.
그 외의 정보는 "game_data" 를 키로 Map<String, Object> 형태 값을 넣어 주면 된다.
"player_id" 와 "game_data" 의 키는 필수이며 변경하면 안된다.
ex) {"player_id":123, "game_data":{"Name":"CurrentPlayer", "Level":52}}
충돌난 유저로 선택 된 경우 다시 게임데이터를 불러와야 한다.
currentPlayerData | 현재 사인-인 되어있는 유저의 정보 |
conflictPlayerData | connect 시 받은 conflictPlayer 정보 |
listener | onAuthV4SignIn |
|
static |
기기 관리 서비스를 호출한다.
서비스를 이용하지 않는 유저는 가입 안내가 표시되고
서비스를 이용하는 유저는 기기 관리 목록이 표시된다.
listener | onAuthV4ShowDeviceManagement |
|
static |
1:1 문의 UI 를 띄운다.
HIVE Membership 연동 여부와 상관없이 사용할 수 있으며
연동되어 있다면 e-mail 부분이 자동으로 기입되어 있다.
listener | onAuthV4ShowInquiry |
|
static |
내 문의 UI 를 띄운다.
listener | onAuthV4ShowMyInquiry |
|
static |
요청한 playerId 의 프로필 UI 를 표시한다.
playerId 가 사인-인 된 자신이면 UI 에서 프로필 사진과 닉네임을 변경할 수 있다.
이 경우 창이 닫히면 playerName 과 playerImageUrl 를 로컬 정보와 동기화 한다.
playerId | 프로필 UI 를 띄울 playerId |
listener | onAuthV4ShowProfile |
|
static |
사인-인 을 할 수 있는 Provider 목록이 있는 UI 를 띄운다.
setup 에서 받은 ProviderList 와 동일한 목록을 가진 사인-인 가능한 UI 를 띄운다.
네트워크 지연 등으로 인해 GUEST 버튼이 노출되지 않을 수 있다.
isAutoSignIn() 의 응답값이 true라면 showSignIn() 을 호출하지 않고 signIn(AUTO) 를 호출 해 주면 된다.
listener | onAuthV4SignIn |
|
static |
약관 정보를 표시한다.
이후 게임에서는 설정 창 등에서 개인 정보 처리 방침 및 이용 약관 정보를 확인할 수 있는 웹뷰를 노출하도록 구성해야 한다.
listener | onAuthV4ShowTerms API 호출 결과 통지 |
|
static |
주어진 providerType 에 따라 signIn 을 요청 한다.
isAutoSignIn() 응답값으로 AUTO 타입을 사용할 수 있는지 체크할 수 있다.
이미 sign 이 진행중이면 IN_PROGRESS 가 발생하며,
GUEST 가 아닌 다른 ProviderType 의 경우 외부 인증창이 한번 더 노출 될 수 있다.
signIn 에 성공하게 되면 listener 에 포함되어있는 playerInfo 를 통해 유저 정보를 얻고
연동된 provider 상태를 UI 에 표시해 주면 된다.
signIn(AUTO) 의 경우 저장된 playerId 의 세션만으로 sign-in 되기 때문에
묵시적 로그인을 수행하는 Provider가 실제 단말에도 로그인 되어있는지의 여부를 체크하고 계정을 동기화 하려면 checkProvider() 를 호출 하여야 한다.
다를 경우 signOut() 후 signIn(Provider) 로 계정 전환을 할 수 있다.
BLACKLIST 일 경우 SDK에서 제재 팝업을 띄우고 BLACKLIST 에러를 내려 준다.
providerType | signIn 요청할 ProviderType |
listener | onAuthV4SignIn AuthV4 사인-인 결과 통지 |
|
static |
자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 signIn을 요청 한다.
signIn 에 성공하게 되면 listener 에 포함되어있는 playerInfo 를 통해 유저 정보를 얻는다.
listener | onAuthV4SignIn AuthV4 사인-인 결과 통지 |
|
static |
PlayerID를 이용하여 로그인 요청을 수행한다.
주어진 playerId를 사용하여 로그인 요청을 수행한다.
playerId | 로그인에 사용할 PlayerID |
useAutoSignIn | 자동 로그인 사용 여부 |
signInListener | onSignIn AuthV4 사인-인 결과 통지 |
|
static |
현재 세션을 제거 한다.
로그인 된 모든 Provider 들을 로그아웃 시키며 결과와 상관 없이 세션을 제거하고 성공 콜백을 준다.
signIn/Out 이 진행중일 경우 IN_PROGRESS 가 발생할 수 있다.
게스트 상태인 player 의 경우 (연동된 Provider 가 하나도 없는 상태) 다시 사인-인 할 수 없게 되니 주의.
listener | onAuthV4SignOut 사인-아웃 결과 통지 |
|
static |
현재 로그인된 세션을 저장한다.
현재 로그인된 세션 정보를 저장한다.
storeListener | onStorePlayeerId 세션 저장 결과 통지 |