HIVE SDK 초기화 및 HIVE 인증 기능을 제공한다 HIVE SDK 는 xml 설정 파일을 기반으로 초기화를 수행한다. 더 자세히 ...

클래스
class	AuthV4MaintenanceExtraButton
	점검 팝업을 커스터마이징 하기 위한 버튼 정보 action : 버튼을 눌렀을때 동작될 행동 url : action 이 OPEN_URL 일 경우에 브라우징 될 URL button : 버튼의 Text 문구 ex) 확인 더 자세히 ...

class	AuthV4MaintenanceInfo
	서버 점검 및 업데이트 상태 표시 정보 title : 점검 제목 message : 점검 내용 button : 버튼의 Text 문구 ex) 확인 action : 버튼을 눌렀을때 동작될 행동 url : action 이 OPEN_URL 일 경우에 브라우징 될 URL remainingTime : EXIT 일 경우 점검 완료까지 남은 초단위 시간. 더 자세히 ...

class	PlayerInfo
	사인-인 유저의 정보 프로필 정보 (ProfileInfo) 와 함께 유저의 토큰과 DID 값이 포함되어 있다. 더 자세히 ...

class	ProfileInfo
	유저의 프로필 정보 playerID : 유저의 고유한 ID playerName : 외부에 보여질 유저의 닉네임, 처음 연결된 Provider 의 정보로 채워지며 HIVE 멤버쉽으로 연동한 사용자는 변경이 가능하다. 더 자세히 ...

class	ProviderInfo
	프로바이더 정보 연결된 프로바이더의 UserId 를 포함하고 있다. 더 자세히 ...

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

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

Public 멤버 함수
delegate void	onAuthV4Setup (ResultAPI result, Boolean isAutoSignIn, String did, List< ProviderType > providerTypeList)
	AuthV4 초기화 결과 통지 result : 최초 실행 시 DID 를 받아오지 못하거나, Provider List 를 받아오지 못하면 실패한다.

delegate void	onAuthV4SignIn (ResultAPI result, PlayerInfo playerInfo)
	AuthV4 사인-인 결과 통지 result : SUCCESS 가 아닐 경우 다시 로그인 화면으로 돌아가야한다.

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

delegate void	onAuthV4Connect (ResultAPI result, PlayerInfo conflictPlayer)
	AuthV4 Provider 연동 결과 통지 result : 지원하지 않는 ProviderType (INVALID_PARAM) 이거나 Sign 이 진행중일 경우 (IN_PROGRESS) 실패가 될 수 있다.

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

delegate void	onAuthV4GetProfile (ResultAPI result, List< ProfileInfo > profileInfoList)
	AuthV4 Profile Profile 정보 요청 결과 통지 프로필 서버에 요청한 playerId 들에 대한 profile 정보를 전달한다.

delegate void	onAuthV4ShowProfile (ResultAPI result)
	AuthV4 Profile UI 요청 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onAuthV4ShowInquiry (ResultAPI result)
	AuthV4 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onAuthV4ShowMyInquiry (ResultAPI result)
	AuthV4 내 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onAuthV4ShowChatbotInquiry (ResultAPI result)
	AuthV4 챗봇 1:1 문의 UI 요청 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onAuthV4ShowTerms (ResultAPI result)
	AuthV4 약관 다시보기 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onAuthV4AdultConfirm (ResultAPI result)
	AuthV4 성인인증 정보 표시 결과 통지 UI 창이 닫히면 호출 된다.

delegate void	onDeviceProviderInfo (ResultAPI result, ProviderInfo providerInfo)
	AuthV4 Provider 상태 조회 결과 통지 요청한 Provider 로 Login 이 되어있지 않으면 Login 까지 시도한다.

delegate void	onAuthV4Maintenance (ResultAPI result, List< AuthV4MaintenanceInfo > maintenanceInfoList)
	AuthV4 서버 점검 조회 결과 통지 Configuration 에 설정한 ServerId 로 점검상태 여부를 체크한다.

delegate void	onGetProviderFriendsList (ResultAPI result, ProviderType providerType, Dictionary< String, Int64 > providerUserIdList)
	HIVE SDK 사용자 Provider 친구목록의 profile 요청 결과 통지.

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

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

delegate void	onAuthV4GetHiveTalkPlusLoginToken (ResultAPI result, string loginToken)
	`getHiveTalkPlusLoginToken(AuthV4GetHiveTalkPlusLoginTokenListener)` 호출 결과 통지 AuthV4.getHiveTalkPlusLoginToken() 에서 사용 HiveTalkPlus 로그인시 필요한 로그인 토큰을 얻어온다.

delegate void	onAuthV4DialogDismiss (bool isDismiss)
	AuthV4 Game Center 로그인 안내 팝업 결과 통지

정적 Public 멤버 함수
static void	setup (onAuthV4Setup listener)
	AuthV4 초기화를 수행한다.

static void	signIn (ProviderType providerType, onAuthV4SignIn listener)
	주어진 providerType 에 따라 signIn 을 요청 한다.

static void	signInWithAuthKey (String authKey, onAuthV4SignIn listener)
	자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 signIn을 요청 한다.

static void	signOut (onAuthV4SignOut listener)
	로컬에 있는 세션을 제거 한다.

static void	playerDelete (onAuthV4SignOut listener)
	계정을 삭제하고 로컬에 있는 세션을 제거 한다.

static void	connect (ProviderType providerType, onAuthV4Connect listener)
	현재 사인-인 된 유저에 요청한 provider 와 연동 한다.

static void	connectWithAuthKey (String authKey, onAuthV4Connect listener)
	자체 구현한 커스텀 로그인 후 획득한 authKey 값으로 connect를 요청 한다.

static void	disconnect (ProviderType providerType, onAuthV4Disconnect listener)
	현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.

static void	disconnectWithName (String providerName, onAuthV4Disconnect listener)
	현재 사인-인 된 유저에 요청한 provider 와 연동을 해제 한다.

static void	selectConflict (Int64 selectedPlayerId, onAuthV4SignIn listener)
	connect 로 인한 계정 충돌 상황 (CONFLICT_PLAYER) 일 때 유저를 선택 한다.

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

static PlayerInfo	getPlayerInfo ()
	현재 사인-인 된 유저의 정보를 반환 한다.

static void	getProfile (List< Int64 > playerIdList, onAuthV4GetProfile listener)
	요청한 playerId 들의 프로필 정보를 반환한다.

static void	showSignIn (onAuthV4SignIn listener)
	사인-인 을 할 수 있는 Provider 목록이 있는 UI 를 띄운다.

static void	showConflictSelection (JSONObject currentPlayerData, JSONObject conflictPlayerData, onAuthV4SignIn listener)
	충돌상태에서 유저를 선택하는 UI 를 띄운다.

static void	showProfile (Int64 playerId, onAuthV4ShowProfile listener)
	요청한 playerId 의 프로필 UI 를 표시한다.

static void	showInquiry (onAuthV4ShowInquiry listener)
	1:1 문의 UI 를 띄운다.

static void	showMyInquiry (onAuthV4ShowMyInquiry listener)
	내 문의 UI 를 띄운다.

static void	showChatbotInquiry (String additionalInfo, onAuthV4ShowChatbotInquiry listener)
	HIVE 챗봇 1:1 문의 화면 호출

static void	showTerms (onAuthV4ShowTerms listener)
	HIVE 약관 정보를 표시한다.

static void	resetAgreement ()
	약관 동의 기록을 초기화한다.

static void	showAdultConfirm (onAuthV4AdultConfirm listener)
	성인 인증을 요청한다.

static void	checkProvider (ProviderType providerType, onDeviceProviderInfo listener)
	요청한 Provider 의 상태를 체크 한다.

static void	checkMaintenance (Boolean isShow, onAuthV4Maintenance listener)
	점검 상태 표시 및 데이터 반환한다.

static void	checkBlacklist (Boolean isShow, onAuthV4Maintenance listener)
	현재 유저의 제재 상태를 체크한다.

static void	setProviderChangedListener (onDeviceProviderInfo listener)
	연동된 Provider 의 정보가 바뀌었는지 통보 받는다.

static Boolean	getAgeGateU13 ()
	COPPA 13세 나이 제한 여부를 반환한다.

static void	reset ()
	인증 정보를 포함하여 SDK 에서 사용하는 모든 데이터 초기화 한다.

static void	getProviderFriendsList (ProviderType providerType, onGetProviderFriendsList listener)
	입력받은 providerType 에 해당하는 연결된 사용자의 친구들의 playerId 목록 정보를 얻어온다.

static void	resolveConflict (onAuthV4ResolveConflict listener)
	conncet 로 인해 계정이 충돌 된 상황 (CONFLICT_PLAYER) 을 해제 한다.

static void	showDeviceManagement (onAuthV4ShowDeviceManagement listener)
	기기 관리 서비스를 호출한다.

static void	getHiveTalkPlusLoginToken (onAuthV4GetHiveTalkPlusLoginToken listener)
	`getHiveTalkPlusLoginToken(AuthV4GetHiveTalkPlusLoginTokenListener)` 호출 결과 통지 AuthV4.getHiveTalkPlusLoginToken() 에서 사용 HiveTalkPlus 로그인시 필요한 로그인 토큰을 얻어온다.

static void	requestPermissionViewData (onAuthV4RequestPermissionViewData listener)
	권한고지 팝업을 구성하기 위한 데이터를 얻습니다.

static void	showGameCenterLoginCancelDialog (onAuthV4DialogDismiss listener)
	Game Center 로그인창을 표시할 수 없는 경우, 해당 상태를 보여주고, Game Center 로그인 방법을 안내하는 UI를 띄운다.

상세한 설명

HIVE SDK 초기화 및 HIVE 인증 기능을 제공한다 HIVE SDK 는 xml 설정 파일을 기반으로 초기화를 수행한다.

이 클래스에서 제공하는 상세 기능은 다음과 같다.

HIVE SDK 초기화
고객 정보 수집 및 이용 약관 동의
단말 고유 ID (DID : Device ID) 관리
User 다운로드 관리
버전과 서버 점검 및 업데이트 관리
사용자 제재
Guest / Provider 사인-인/아웃 수행
프로필, 카페, 1:1문의 수행
성인 인증 수행

Created by hife on 2017. 3. 22

작성자: hife

Since: 4.3.0

멤버 함수 문서화

◆ connectWithAuthKey()

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

static

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

Requests connect with authKey gained from customized provider login implementation.

korean

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

english

If connect succeeds, you can get the user information through the playerInfo contained in the handler

매개변수

authKey	AuthKey to request connect
listener	onAuthV4Connect AuthV4 connect result callback

◆ disconnectWithName()

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

static

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

Releases the currently signed-in user from the requested provider.

korean

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

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

english

It pass the disconnect status to the authentication server and then logout the requested provider.
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.

Note that if all account link are disconnected due to 'disconnect', it may become a guest state.

매개변수

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.

◆ onAuthV4DialogDismiss()

delegate void hive.AuthV4.onAuthV4DialogDismiss ( bool isDismiss )

AuthV4 Game Center 로그인 안내 팝업 결과 통지

매개변수

isDismiss : 팝업이 정상적으로 닫힌 경우 true가 전달된다.

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

AuthV4.cs

HIVE SDK for Unity3D

클래스

Public 타입

Public 멤버 함수

정적 Public 멤버 함수

상세한 설명

멤버 함수 문서화

◆ connectWithAuthKey()

korean

english

◆ disconnectWithName()

korean

english

◆ onAuthV4DialogDismiss()