HIVE SDK for Unity3D

클래스 | 열거형 타입 | 함수
AuthV4

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 설정 파일을 기반으로 초기화를 수행한다.


열거형 타입 문서화

◆ AuthV4MaintenanceActionType

점검 화면에서 버튼을 눌렀을때 동작될 행동 OPEN_URL : 외부 브라우저로 전달된 URL 을 실행
EXIT : 앱 종료
DONE : 아무 처리 하지 않고 점검 팝업 종료

◆ ProviderType

Provider 형태 정의 여기서 AUTO 는 자동로그인의 용도로 쓰이며
isAutoSignIn() 이 true 일 경우 SignIn 시 AUTO 로 입력해 주면 된다.


함수 문서화

◆ checkBlacklist()

static void hive.AuthV4.checkBlacklist ( Boolean  isShow,
onAuthV4Maintenance  listener 
)
static

현재 유저의 제재 상태를 체크한다.

기본적으로 signIn, connect 시에 자동으로 체크되며 제재 팝업을 띄운다.
앱 내에서 필요한 시점에 실시간으로 체크가 필요할 때 사용할 수 있다.

요청시 isShow 가 true 였을 경우 팝업 UI 가 노출된다.

결과가 SUCCESS 이지만 제재 내용이 없다면 listener 의 maintenanceInfo 는 비어있게 된다.
요청시 isShow 를 false 로 주었다면 listener 의 maintenanceInfo 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.

매개변수
isShowHIVE UI 를 사용할 지 여부
listeneronAuthV4Maintenance

◆ checkMaintenance()

static void hive.AuthV4.checkMaintenance ( Boolean  isShow,
onAuthV4Maintenance  listener 
)
static

점검 상태 표시 및 데이터 반환한다.

Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다.

SDK 의 초기화가 완료되면 서버 점검 및 업데이트 상태를 확인해야 한다.
서버 점검 및 업데이트는 게임 클라이언트의 업데이트 후에 하위 버전을 차단하거나, 게임 서버의 점검 시간 동안 게임 접속을 차단할 수 있다.
HIVE 콘솔에 설정된 정보에 따라 서버 점검 혹은 공지 팝업을 노출하는 기능을 제공한다.

요청시 isShow 가 true 였을 경우 점검 팝업 UI 가 노출된다.

결과가 SUCCESS 이지만 점검 공지 내용이 없다면 listener 의 maintenanceInfo 는 비어있게 된다.
요청시 isShow 를 false 로 주었다면 listener 의 maintenanceInfo 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.

매개변수
isShowHIVE UI 를 사용할 지 여부
listeneronAuthV4Maintenance

◆ checkProvider()

static void hive.AuthV4.checkProvider ( ProviderType  providerType,
onDeviceProviderInfo  listener 
)
static

요청한 Provider 의 상태를 체크 한다.

요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다.
Login 에 성공하면 providerUserId 까지 얻어 온다.

현재 playerId 와 connect 를 요청하지는 않는다.

SUCCESS 는 조회에 성공했다는 뜻이며 providerInfo 에 providerUserId 여부로 로그인된 유저를 판단해야 한다.
실제 provider 에 로그인 되어있다면 providerUserId 가 존재한다. 그 외 providerType 만 존재.

Google Play Games, Apple Game Center 등 묵시적 사인-인 방식을 사용할 경우

매개변수
providerType상태를 체크할 ProviderType
listeneronDeviceProviderInfo

◆ connect()

static void hive.AuthV4.connect ( ProviderType  providerType,
onAuthV4Connect  listener 
)
static

현재 사인-인 된 유저에 요청한 provider 와 연동 한다.

요청한 Provider 로 로그인을 시도 한 뒤, 로그인에 성공하면 인증서버에 연동 요청을 보낸다.
해당 Provider 의 UserId 에 이미 매칭된 playerId 가 있을 경우 listener 의 result 에 CONFLICT_PLAYER 에러를 내려준다.
이 경우 listener 에 포함되어 있는 conflictPlayer 객체의 충돌 유저 정보를 가지고 유저에게 계정 선택을 위한 UI 를 구성 해야한다.
유저가 선택을 하면 선택된 유저 정보로 selectConflict() 를 호출해 주면 된다.

직접 UI 를 구성하지 않을 경우 showConflictSelection() 을 이용할 수 있다.
이 경우 selectConflict() 까지 진행되며 사인-인 완료된 결과까지 받을 수 있다.

연동이 완료되면 해당 상태를 앱 내 UI 에 갱신해 준다.

BLACKLIST 일 경우 SDK에서 제재 팝업을 띄우고 BLACKLIST 에러를 내려 준다.

매개변수
providerTypeconnect 요청할 ProviderType.
AUTO 나 GUEST 는 INVALID_PARAM 에러를 발생시킨다.
listeneronAuthV4Connect

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 은 비어 있음.

◆ connectWithAuthKey()

static void hive.AuthV4.connectWithAuthKey ( String  authKey,
onAuthV4Connect  listener 
)
static

자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 connect를 요청 한다.

connect 에 성공하게 되면 handler 에 포함되어있는 playerInfo 를 통해 유저 정보를 얻는다.

매개변수
authKeyAuthKey to request connect
listeneronAuthV4Connect AuthV4 connect result callback

◆ deleteStoredPlayerId()

static void hive.AuthV4.deleteStoredPlayerId ( Int64  playerId,
onAuthV4DeletePlayerId  listener 
)
static

저장된 세션 정보를 삭제한다.

storeCurrentPlayerId에서 저장된 세션 정보를 playerId를 이용하여 찾아서 삭제한다.

매개변수
deleteListeneronDeletePlayerId 세션 정보 삭제 결과 통지
playerId삭제할 세션 정보를 찾기 위한 PlayerID

◆ disconnect()

static void hive.AuthV4.disconnect ( ProviderType  providerType,
onAuthV4Disconnect  listener 
)
static

현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.

인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.
인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다.

모든 연동이 해제될 경우 게스트 상태가 될 수 있으니 주의.

매개변수
providerTypedisconnect 요청할 ProviderType.
listeneronAuthV4Disconnect result : 인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다.
그 외 성공.

◆ disconnectWithName()

static void hive.AuthV4.disconnectWithName ( String  providerName,
onAuthV4Disconnect  listener 
)
static

현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.

인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.
인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnected 된 Provider 일 경우 실패가 될 수 있다.

disconnect 로 인해 연동이 모두 해제될 경우 게스트 상태가 될 수 있으니 주의.

매개변수
providerNamedisconnect to ProviderName.
listeneronAuthV4Disconnect 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.

◆ getAgeGateU13()

static Boolean hive.AuthV4.getAgeGateU13 ( )
static

COPPA 13세 나이 제한 여부를 반환한다.


기본값은 false이며, AuthV4.setup() 나 로그인 시 COPPA 약관 동의에 따라 결정된다.
정상적인 값을 받으려면 약관동의 이후에 호출하여야 한다.

반환값
boolean COPPA 13세 나이 제한 여부

◆ getParentalConsentInfo()

static ParentalConsentInfo hive.AuthV4.getParentalConsentInfo ( )
static

보호자 동의 정보를 반환한다.


이용자의 생년월일과 보호자 이메일 주소가 포함된다.
보호자 동의 이후에 호출하여야 한다.
해당 정보는 보호자 동의 이후 앱 종료 이전까지만 유지된다.

반환값
ParentalConsentInfo 보호자 동의 정보

◆ getPlayerInfo()

static PlayerInfo hive.AuthV4.getPlayerInfo ( )
static

현재 사인-인 된 유저의 정보를 반환 한다.

PlayerInfo 에는 playerToken 을 포함하고 있으며
프로필 정보 (playerName, playerImageUrl) 까지 포함하고 있으나,
요청시 실시간으로 서버에 요청하지 않고 로컬에 캐쉬되어 있는 프로필 정보를 반환 한다.

getProfile 이나 showProfile 에서 사인-인 된 유저 자신일 경우 자동으로 캐쉬를 갱신한다.

반환값
PlayerInfo 현재 사인-인 된 유저의 정보. 사인-인 되어있지 않을 경우 null.

◆ getProfile()

static void hive.AuthV4.getProfile ( List< Int64 >  playerIdList,
onAuthV4GetProfile  listener 
)
static

요청한 playerId 들의 프로필 정보를 반환한다.

playerId 중 사인-인 된 자신이 있을 경우 playerName 과 playerImageUrl 을 동기화 한다.

매개변수
playerIdListArrayList<Long>
listeneronAuthV4GetProfile

◆ getProviderFriendsList()

static void hive.AuthV4.getProviderFriendsList ( ProviderType  providerType,
onGetProviderFriendsList  listener 
)
static

입력받은 providerType 에 해당하는 연결된 사용자의 친구들의 playerId 목록 정보를 얻어온다.

요청한 providerType의 providerId와 연결된 사용자의 playerId를 페어로 얻어온다.
FACEBOOK 의 경우 최대 5000명.

getProfile 을 사용하여 친구의 PlayerInfo 를 조회할 수 있다.

매개변수
providerType친구목록을 조회할 연결된 ProviderType 값.
listenerAuthV4ProviderFriendsListener

◆ getStoredPlayerIdList()

static void hive.AuthV4.getStoredPlayerIdList ( onAuthV4GetAccountPlayerIdList  listener)
static

저장된 플레이어 ID 리스트를 반환한다.

signOut 시 저장된 플레이어 ID 리스트를 반환한다.

매개변수
playerIdListeneronPlayerId 플레이어 ID 리스트 반환 결과 통지

◆ isAutoSignIn()

static Boolean hive.AuthV4.isAutoSignIn ( )
static

signIn(AUTO) 가 가능한지 여부를 반환한다.

AuthV4.setup() 호출 시 알려주는 값과 동일 하며,
로컬에 저장된 기존 세션만 체크 하기때문에 세션이 실제로 만료되지 않은 유효한 토큰인지는 알 수 없다.
true 일 경우 'TOUCH TO START' 등의 UI 를 통해 signIn(AUTO) 를 호출하고
여기서 실패할 경우 다시 초기 사인-인 씬으로 돌아가야 한다.

false 일 경우 AuthV4.setup() 호출 시 받은 providerList 를 통해 UI 를 구성하여 signIn 을 시도 하거나
showSignIn() 을 통해 HIVE 에서 제공하는 UI 를 사용하여도 된다.

앱 중간에 signOut 등 사인-인 씬으로 돌아왔을 경우 이 API 를 통해 UI 구성여부를 체크할 수 있다.

반환값
boolean signIn(AUTO) 가 가능한지 여부

◆ onAuthV4AdultConfirm()

delegate void hive.AuthV4.onAuthV4AdultConfirm ( ResultAPI  result)

AuthV4 성인인증 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.



result : 사인-인 이 필요하기 때문에 사인-인 이 되어있지 않을 경우 INVALID_SESSION 이 올 수 있다.
성인인증에 정상적으로 진행되었을 경우 SUCCESS 가 된다.

◆ onAuthV4Connect()

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 은 비어 있음.

◆ onAuthV4DeletePlayerId()

delegate void hive.AuthV4.onAuthV4DeletePlayerId ( ResultAPI  result)

세션 정보 삭제 콜백 타입 정의 세션 정보 삭제 결과를 처리하는 콜백 함수 타입을 정의한다.

매개변수
result: API 호출 결과

◆ onAuthV4Disconnect()

delegate void hive.AuthV4.onAuthV4Disconnect ( ResultAPI  result)

AuthV4 Provider 연동 해지 결과 통지 인증 서버에 disconnect 상황을 전달하고 이후 요청한 Provider 를 Logout 시킨다.



result : 인증 서버에 전달이 실패할 경우와 Sign 이 진행중이거나 setup 이 되지 않은 상황,
또는 이미 disconnect 된 Provider 일 경우 실패가 될 수 있다.
그 외 성공.

◆ onAuthV4GetAccountPlayerIdList()

delegate void hive.AuthV4.onAuthV4GetAccountPlayerIdList ( ResultAPI  result,
List< Int64 >  playerId 
)

플레이어 ID 반환 콜백 타입 정의 플레이어 ID 반환 결과를 처리하는 콜백 함수 타입을 정의한다.

매개변수
result: API 호출 결과
playerIdList: 반환된 플레이어 ID 리스트

◆ onAuthV4GetProfile()

delegate void hive.AuthV4.onAuthV4GetProfile ( ResultAPI  result,
List< ProfileInfo profileInfoList 
)

AuthV4 Profile Profile 정보 요청 결과 통지 프로필 서버에 요청한 playerId 들에 대한 profile 정보를 전달한다.



result : 요청에 대한 결과. 실패일 경우 profileInfoList 는 비어있다.
profileInfoList : 요청한 playerId 들에 대한 profile 정보.
각각 playerId, playerName, playerImageUrl 이 포함되어 있다.

◆ onAuthV4Maintenance()

delegate void hive.AuthV4.onAuthV4Maintenance ( ResultAPI  result,
List< AuthV4MaintenanceInfo maintenanceInfoList 
)

AuthV4 서버 점검 조회 결과 통지 Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다.


요청시 isShow 가 true 였을 경우 점검 팝업이 노출되고 닫힌 이후에 불리게 된다.

result : 서버에 조회 요청이 성공하면 SUCCESS 가 된다.
SUCCESS 이지만 점검 공지 내용이 없다면 maintenanceInfo 는 비어있게 된다.
maintenanceInfo : 점검 공지 팝업에 노출되는 동작에 대한 정보 이다.
요청시 isShow 를 false 로 주었다면 이 정보를 가지고 직접 UI 를 구성하여 노출하여야 한다.

◆ onAuthV4RefreshAccessToken()

delegate void hive.AuthV4.onAuthV4RefreshAccessToken ( ResultAPI  result,
string  accessToken 
)

◆ onAuthV4ResolveConflict()

delegate void hive.AuthV4.onAuthV4ResolveConflict ( ResultAPI  result)

resolveConflict(AuthV4ResolveConflictListener) 호출 결과 통지 AuthV4.resolveConflict() 에서 사용
앱 내에서 로그아웃 할 수 없는 IdP (Apple GameCenter)의 경우 로그아웃은 불가능 하다.


따라서, 이런경우 실제 IdP 로그아웃에 실패했어도 내부 충돌 정보는 삭제 됩니다.

참고
#resolveConflict(AuthV4ResolveConflictListener)

◆ onAuthV4Setup()

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 도 불가능 할 수 있다. (분산서버)

◆ onAuthV4ShowChatbotInquiry()

delegate void hive.AuthV4.onAuthV4ShowChatbotInquiry ( ResultAPI  result)

AuthV4 챗봇 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.



result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.

◆ onAuthV4ShowDeviceManagement()

delegate void hive.AuthV4.onAuthV4ShowDeviceManagement ( ResultAPI  result)

showDeviceManagement(AuthV4ShowDeviceManagementListener) 호출 결과 통지 AuthV4.showDeviceManagement() 에서 사용
기기 관리 서비스를 이용하면서 등록이 안된 기기는 로그인이 불가능 하다.


따라서, 이런 경우 AuthV4NotRegisteredDevice 에러를 받게 된다.

참고
#showDeviceManagement(AuthV4ShowDeviceManagementListener)

◆ onAuthV4ShowInquiry()

delegate void hive.AuthV4.onAuthV4ShowInquiry ( ResultAPI  result)

AuthV4 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.



result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.

◆ onAuthV4ShowMyInquiry()

delegate void hive.AuthV4.onAuthV4ShowMyInquiry ( ResultAPI  result)

AuthV4 내 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.



◆ onAuthV4ShowProfile()

delegate void hive.AuthV4.onAuthV4ShowProfile ( ResultAPI  result)

AuthV4 Profile UI 요청 결과 통지 UI 창이 닫히면 호출 된다.



result : 입력된 playerId 가 잘못된 형태가 아니면 성공

◆ onAuthV4ShowTerms()

delegate void hive.AuthV4.onAuthV4ShowTerms ( ResultAPI  result)

AuthV4 약관 다시보기 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.



result : setup 이 되어있지 않을 경우 NEED_INITIALIZE 가 발생할 수 있다. 그 외 성공.

◆ onAuthV4SignIn()

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 는 연결되어있지 않은 상태.

◆ onAuthV4SignOut()

delegate void hive.AuthV4.onAuthV4SignOut ( ResultAPI  result)

AuthV4 사인-아웃 결과 통지 result : setup 이 되지 않았거나 (NEED_INITIALIZE) SignIn 혹은 SignOut 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다.


그 외 성공

◆ onAuthV4StorePlayerId()

delegate void hive.AuthV4.onAuthV4StorePlayerId ( ResultAPI  result)

현재 로그인된 세션을 저장하는 콜백 타입 정의 현재 로그인된 세션을 저장하는 기능에 대한 콜백 함수 타입을 정의한다.

매개변수
result: API 호출 결과

◆ onDeviceProviderInfo()

delegate void hive.AuthV4.onDeviceProviderInfo ( ResultAPI  result,
ProviderInfo  providerInfo 
)

AuthV4 Provider 상태 조회 결과 통지 요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다.


현재 playerId 와 connect 를 요청하지는 않는다.

result : SUCCESS 는 조회에 성공했다는 뜻이며 providerInfo 에 providerUserId 여부로 로그인된 유저를 판단해야 한다.
providerInfo : 실제 provider 에 로그인 되어있다면 providerUserId 가 존재한다. 그 외 providerType 만 존재.

◆ onGetProviderFriendsList()

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 정보.

◆ playerDelete()

static void hive.AuthV4.playerDelete ( onAuthV4SignOut  listener)
static

서버에 계정 삭제를 요청하고 연동된 모든 Provider 들을 해제 한다.

성공 시 로그인 된 모든 Provider 들을 로그아웃 시키며 로컬 세션을 제거하고 성공 콜백을 준다.
signIn/Out 이 진행중일 경우 IN_PROGRESS 가 발생할 수 있다.

매개변수
listeneronAuthV4SignOut 계정 삭제 결과 통지

◆ refreshAccessToken()

static void hive.AuthV4.refreshAccessToken ( onAuthV4RefreshAccessToken  listener)
static

◆ requestPermissionViewData()

static void hive.AuthV4.requestPermissionViewData ( onAuthV4RequestPermissionViewData  listener)
static

권한고지 팝업을 구성하기 위한 데이터를 얻습니다.


ResultAPI의 result가 success이며, result의 code가 AuthV4SkipPermissionView 가 아닐 경우 권한고지 데이터를 이용하여 권한고지를 출력 할 수 있습니다. PermissionViewData를 참조하여 UI를 구성하세요. 이 함수를 호출하여 권한고지팝업을 구성할 시 AuthV4.setup 을 호출하였을때 HIVE SDK의 권한고지 팝업은 나오지 않습니다.

경고
code가 AuthV4SkipPermissionView 가 왔을 경우 PermissionViewData에는 빈값이 오게됩니다. 값을 참조할 경우 예기치못한 오류가 발생할 수 있으므로 주의 해주세요. 또한 위 코드는 ResultAPI Success일 경우만 오게됩니다.
참고
PermissionViewData
ResultAPI
매개변수
listeneronAuthV4RequestPermissionViewData

◆ resolveConflict()

static void hive.AuthV4.resolveConflict ( onAuthV4ResolveConflict  listener)
static

connect 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다.

connect 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 에서 자체 UI 를 구성하였을 경우에 사용
충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다.
호출시 해당하는 IdP (Provider) 를 로그아웃하게 된다.
앱 내에서 로그아웃 할 수 없는 IdP (Apple GameCenter)의 경우 로그아웃은 불가능하고,
내부 충돌 정보만 삭제 된다.

매개변수
listenerAuthV4ResolveConflictListener
실제 IdP 로그아웃에 실패했어도 내부 충돌 정보는 삭제 된다.
참고
AuthV4.AuthV4ResolveConflictListener

◆ selectConflict()

static void hive.AuthV4.selectConflict ( Int64  selectedPlayerId,
onAuthV4SignIn  listener 
)
static

connect 로 인한 계정 충돌 상황 (CONFLICT_PLAYER) 일 때 유저를 선택 한다.

conncet 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 에서 자체 UI 를 구성하였을 경우
선택한 유저를 SDK에 통보해 주기 위해 호출 한다.
SDK 상태가 충돌 상태가 아니거나 signIn 이 진행중, 혹은 잘못된 playerId 일 경우 INVALID_PARAM 이 발생 할 수 있다.
충돌 상태가 되었다고 해도 selectConflict() 가 호출 되어 signIn 되기 전까지는 기존 유저가 signIn 된 상태로 본다.

showConflictSelection() 을 사용하였을 경우 호출할 필요가 없다.

매개변수
selectedPlayerId선택한 유저의 playerId
listeneronAuthV4SignIn
SUCCESS 가 되기 전까지는 기존 유저가 signIn 된 상태이다. 주의.

◆ setProviderChangedListener()

static void hive.AuthV4.setProviderChangedListener ( onDeviceProviderInfo  listener)
static

연동된 Provider 의 정보가 바뀌었는지 통보 받는다.

Google Play Games, Apple Game Center 의 경우 앱 외에서 계정 정보가 변경 될 수 있다.
그렇기 때문에 앱이 resume (onStart) 될 때 유저 정보가 바뀌었는지 체크하게 되고,
바뀌었다면 해당 콜백이 불리게 된다.

콜백은 checkProvider() 이후나 connect 등으로 직접 연동 시도 된 이후부터 동작하게 된다.

묵시적 사인-인 방식으로 구현할 경우 signIn() 완료 시점에서 checkProvider() 를 통해 직접 비교 체크 하여야 한다.

매개변수
listeneronDeviceProviderInfo

◆ setup()

static void hive.AuthV4.setup ( onAuthV4Setup  listener)
static

AuthV4 초기화를 수행한다.

Configuration 영역을 제외한 모든 API 중 가장 먼저 호출되어야 하며
선 호출이 되지 않을시 일부 API 에서는 NEED_INITIALIZE 에러가 발생할 수 있다.

이후 약관 동의, 다운로드 체크, DID 설정, config.xml 설정, ProviderList 설정 등이 진행 된다.
최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 listener 결과로 실패가 내려간다.
listener 에 포함된 providerTypeList 를 통해 signIn 에 필요한 UI 를 구성해야 한다.
직접 UI 를 구현하지 않을 시 showSignIn() 을 이용한다.

매개변수
listeneronAuthV4Setup AuthV4 초기화 결과 통지
result : 최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 실패한다. 그 외 성공.
isAutoSignIn : 로컬에 이전 세션이 남아있는지 여부. true 일 경우 SignIn(ProviderType.AUTO) 을 호출 한다.
그 외의 경우 providerTypeList 중 하나로 SignIn 을 요청이 가능 하다.
providerTypeList : 현재 단말에서 사인-인 가능한 Provider List 이다.
단말의 현재 지역 (IP) 에 따라 다르게 보여질 수 있다.
GUEST 를 포함하고 있으며 일부 지역 혹은 환경에서는 GUEST 도 불가능 할 수 있다. (분산서버)

◆ showAdultConfirm()

static void hive.AuthV4.showAdultConfirm ( onAuthV4AdultConfirm  listener)
static

성인 인증을 요청한다.

고스톱 / 포커류와 같이 성인 인증이 필요한 일부 게임의 경우 성인 인증 기능을 제공한다.

매개변수
listeneronAuthV4AdultConfirm
result : 사인-인 이 필요하기 때문에 사인-인 이 되어있지 않을 경우 INVALID_SESSION 이 올 수 있다.
성인인증에 정상적으로 진행되었을 경우 SUCCESS 가 된다.

◆ showChatbotInquiry()

static void hive.AuthV4.showChatbotInquiry ( String  additionalInfo,
onAuthV4ShowChatbotInquiry  listener 
)
static

HIVE 챗봇 1:1 문의 화면 호출

매개변수
additionalInfo챗봇 페이지 바로가기 호출시 전달받기로한 약속된 JSON 형식의 String 데이터
listenerAPI 호출 결과 통지

◆ showConflictSelection()

static void hive.AuthV4.showConflictSelection ( JSONObject  currentPlayerData,
JSONObject  conflictPlayerData,
onAuthV4SignIn  listener 
)
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현재 사인-인 되어있는 유저의 정보
conflictPlayerDataconnect 시 받은 conflictPlayer 정보
listeneronAuthV4SignIn

◆ showDeviceManagement()

static void hive.AuthV4.showDeviceManagement ( onAuthV4ShowDeviceManagement  listener)
static

기기 관리 서비스를 호출한다.

서비스를 이용하지 않는 유저는 가입 안내가 표시되고
서비스를 이용하는 유저는 기기 관리 목록이 표시된다.

매개변수
listeneronAuthV4ShowDeviceManagement
참고
AuthV4.onAuthV4ShowDeviceManagement

◆ showInquiry()

static void hive.AuthV4.showInquiry ( onAuthV4ShowInquiry  listener)
static

1:1 문의 UI 를 띄운다.

HIVE Membership 연동 여부와 상관없이 사용할 수 있으며
연동되어 있다면 e-mail 부분이 자동으로 기입되어 있다.

매개변수
listeneronAuthV4ShowInquiry

◆ showMyInquiry()

static void hive.AuthV4.showMyInquiry ( onAuthV4ShowMyInquiry  listener)
static

내 문의 UI 를 띄운다.

매개변수
listeneronAuthV4ShowMyInquiry

◆ showProfile()

static void hive.AuthV4.showProfile ( Int64  playerId,
onAuthV4ShowProfile  listener 
)
static

요청한 playerId 의 프로필 UI 를 표시한다.

playerId 가 사인-인 된 자신이면 UI 에서 프로필 사진과 닉네임을 변경할 수 있다.
이 경우 창이 닫히면 playerName 과 playerImageUrl 를 로컬 정보와 동기화 한다.

매개변수
playerId프로필 UI 를 띄울 playerId
listeneronAuthV4ShowProfile

◆ showSignIn()

static void hive.AuthV4.showSignIn ( onAuthV4SignIn  listener)
static

사인-인 을 할 수 있는 Provider 목록이 있는 UI 를 띄운다.

setup 에서 받은 ProviderList 와 동일한 목록을 가진 사인-인 가능한 UI 를 띄운다.
네트워크 지연 등으로 인해 GUEST 버튼이 노출되지 않을 수 있다.
isAutoSignIn() 의 응답값이 true라면 showSignIn() 을 호출하지 않고 signIn(AUTO) 를 호출 해 주면 된다.

매개변수
listeneronAuthV4SignIn

◆ showTerms()

static void hive.AuthV4.showTerms ( onAuthV4ShowTerms  listener)
static

약관 정보를 표시한다.


이후 게임에서는 설정 창 등에서 개인 정보 처리 방침 및 이용 약관 정보를 확인할 수 있는 웹뷰를 노출하도록 구성해야 한다.

매개변수
listeneronAuthV4ShowTerms
API 호출 결과 통지

◆ signIn()

static void hive.AuthV4.signIn ( ProviderType  providerType,
onAuthV4SignIn  listener 
)
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 에러를 내려 준다.

매개변수
providerTypesignIn 요청할 ProviderType
listeneronAuthV4SignIn AuthV4 사인-인 결과 통지

◆ signInWithAuthKey()

static void hive.AuthV4.signInWithAuthKey ( String  authKey,
onAuthV4SignIn  listener 
)
static

자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 signIn을 요청 한다.


signIn 에 성공하게 되면 listener 에 포함되어있는 playerInfo 를 통해 유저 정보를 얻는다.

매개변수
listeneronAuthV4SignIn AuthV4 사인-인 결과 통지

◆ signInWithStoredPlayerId()

static void hive.AuthV4.signInWithStoredPlayerId ( Int64  playerId,
Boolean  useAutoSignIn,
onAuthV4SignIn  listener 
)
static

PlayerID를 이용하여 로그인 요청을 수행한다.

주어진 playerId를 사용하여 로그인 요청을 수행한다.

매개변수
playerId로그인에 사용할 PlayerID
useAutoSignIn자동 로그인 사용 여부
signInListeneronSignIn AuthV4 사인-인 결과 통지

◆ signOut()

static void hive.AuthV4.signOut ( onAuthV4SignOut  listener)
static

현재 세션을 제거 한다.

로그인 된 모든 Provider 들을 로그아웃 시키며 결과와 상관 없이 세션을 제거하고 성공 콜백을 준다.
signIn/Out 이 진행중일 경우 IN_PROGRESS 가 발생할 수 있다.

게스트 상태인 player 의 경우 (연동된 Provider 가 하나도 없는 상태) 다시 사인-인 할 수 없게 되니 주의.

매개변수
listeneronAuthV4SignOut 사인-아웃 결과 통지

◆ storeCurrentPlayerId()

static void hive.AuthV4.storeCurrentPlayerId ( onAuthV4StorePlayerId  listener)
static

현재 로그인된 세션을 저장한다.

현재 로그인된 세션 정보를 저장한다.

매개변수
storeListeneronStorePlayeerId 세션 저장 결과 통지
Copyright © Com2uS Platform Corporation. All Right Reserved. 이용약관 개인정보 처리방침