HIVE SDK for Unity3D

클래스 | 함수 | 변수
AuthV4Helper

클래스

class  hive.AuthV4.Helper.ConflictSingleViewInfo
 계정 충돌시 충돌 유저의 게임 정보를 같이 보여주기 위한 클래스
더 자세히 ...
 

함수

static void hive.AuthV4.showGameCenterLoginCancelDialog (onAuthV4DialogDismiss listener)
 Game Center 로그인창을 표시할 수 없는 경우, 해당 상태를 보여주고,
Game Center 로그인 방법을 안내하는 UI를 띄운다.
 
delegate void hive.AuthV4.Helper.onAuthV4Helper (ResultAPI result, PlayerInfo playerInfo)
 AuthV4Helper API 요청 결과 통지
 
delegate void hive.AuthV4.Helper.onAuthV4DialogDismiss (bool isDismiss)
 AuthV4 Game Center 로그인 안내 팝업 결과 통지


 
static void hive.AuthV4.Helper.syncAccount (ProviderType providerType, onAuthV4Helper listener)
 제공된 API 외 경우에 계정의 충돌 여부를 확인할 수 있다.
 
static void hive.AuthV4.Helper.signIn (onAuthV4Helper listener)
 사용자 로그인

 
static void hive.AuthV4.Helper.signOut (onAuthV4Helper listener)
 사용자 로그아웃

 
static void hive.AuthV4.Helper.playerDelete (onAuthV4Helper listener)
 사용자 삭제

 
static void hive.AuthV4.Helper.connect (ProviderType providerType, onAuthV4Helper listener)
 Provider 연결

 
static void hive.AuthV4.Helper.disconnect (ProviderType providerType, onAuthV4Helper listener)
 Provider 연결

 
static void hive.AuthV4.Helper.showLeaderboard (onAuthV4Helper listener)
 리더보드 조회

 
static void hive.AuthV4.Helper.showAchievements (onAuthV4Helper listener)
 업적 조회

 
static void hive.AuthV4.Helper.showConflict (onAuthV4Helper listener)
 충돌 상태를 알려주고 사용할 계정을 선택하는 HIVE UI 를 보여준다.
 
static void hive.AuthV4.Helper.showConflict (ConflictSingleViewInfo viewInfo, onAuthV4Helper listener)
 충돌 상태를 알려주고 사용할 계정을 선택할 수 있고, 게임 정보를 같이 표현할 수 있는 HIVE UI 를 보여준다.
 
static void hive.AuthV4.Helper.switchAccount (onAuthV4Helper listener)
 계정 Conflict가 발생한 경우 현재 로그인 된 사용자를 로그아웃 시키고,
기기에 연결된 계정으로 로그인을 시도한다.
 
static void hive.AuthV4.Helper.resolveConflict (onAuthV4Helper listener)
 계정 Conflict가 발생한 경우 기존 사용자를 유지하는 경우 사용한다.
 
static List< ProviderType > hive.AuthV4.Helper.getIDPList ()
 SDK에서 제공하는 Provider의 목록을 받는다.
 
static void hive.AuthV4.Helper.showGameCenterLoginCancelDialog (onAuthV4DialogDismiss listener)
 Game Center 로그인창을 표시할 수 없는 경우, 해당 상태를 보여주고,
Game Center 로그인 방법을 안내하는 UI를 띄운다.
 
static void hive.AuthV4.Helper.leaderboardsSubmitScore (String leaderboardId, long score)
 리더보드 점수를 갱신.
 
static void hive.AuthV4.Helper.leaderboardsSubmitScore (String leaderboardId, long score, onAuthV4Helper listener)
 리더보드 점수를 갱신.
 
static void hive.AuthV4.Helper.achievementsReveal (String achievementId)
 숨겨진 업적 공개.
 
static void hive.AuthV4.Helper.achievementsReveal (String achievementId, onAuthV4Helper listener)
 숨겨진 업적 공개.
 
static void hive.AuthV4.Helper.achievementsUnlock (String achievementId)
 업적 달성.
 
static void hive.AuthV4.Helper.achievementsUnlock (String achievementId, onAuthV4Helper listener)
 업적 달성.
 
static void hive.AuthV4.Helper.achievementsIncrement (String achievementId, int value)
 업적 수치 증가.
 
static void hive.AuthV4.Helper.achievementsIncrement (String incrementalAchievementId, int value, onAuthV4Helper listener)
 업적 수치 증가.
 

변수

String hive.AuthV4.AuthV4MaintenanceInfo.title
 점검 제목
 
String hive.AuthV4.AuthV4MaintenanceInfo.message
 점검 내용
 
String hive.AuthV4.AuthV4MaintenanceInfo.button
 버튼의 Text 문구 ex) 확인
 
AuthV4MaintenanceActionType hive.AuthV4.AuthV4MaintenanceInfo.action
 버튼을 눌렀을때 동작될 행동
 
String hive.AuthV4.AuthV4MaintenanceInfo.url
 action 이 OPEN_URL 일 경우에 브라우징 될 URL
 
int hive.AuthV4.AuthV4MaintenanceInfo.remainingTime
 EXIT 일 경우 점검 완료까지 남은 초단위 시간. 시간은 실시간 갱신되며 0초가 되면 앱 종료
 
String hive.AuthV4.AuthV4MaintenanceInfo.startDate
 점검시작일 YYYY-mm-dd HH:ii
 
String hive.AuthV4.AuthV4MaintenanceInfo.endDate
 점검종료일 YYYY-mm-dd HH:ii
 
String hive.AuthV4.AuthV4MaintenanceInfo.customerButton
 고객센터 버튼의 Text 문구
 
String hive.AuthV4.AuthV4MaintenanceInfo.customerLink
 고객센터 버튼을 눌렀을때 이동할 URL
 
List< AuthV4MaintenanceExtraButton > hive.AuthV4.AuthV4MaintenanceInfo.exButtons = new List<AuthV4MaintenanceExtraButton>()
 점검 팝업 커스텀시 구성하기 위한 버튼 정보
 

상세한 설명

HIVE 인증의 고도화 된 기능을 제공한다

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

함수 문서화

◆ achievementsIncrement() [1/2]

static void hive.AuthV4.Helper.achievementsIncrement ( String achievementId,
int value )
static

업적 수치 증가.


숨겨져 있거나 공개된 여부와 상관없이 업적이 100% 로 달성 된다.
총 합산이 Max 가 될 경우 자동으로 업적이 달성되며, 계속 호출하여도 무방하다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

매개변수
achievementId업적 키 값
value증가 값

◆ achievementsIncrement() [2/2]

static void hive.AuthV4.Helper.achievementsIncrement ( String incrementalAchievementId,
int value,
onAuthV4Helper listener )
static

업적 수치 증가.


숨겨져 있거나 공개된 여부와 상관없이 업적이 100% 로 달성 된다.
총 합산이 Max 가 될 경우 자동으로 업적이 달성되며, 계속 호출하여도 무방하다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 업적 수치 증가 요청 성공
-
RESPONSE_FAIL AuthV4GoogleResponseFailAchievementsIncrement PGS API 함수 호출이 실패한 경우 -
매개변수
incrementalAchievementId업적 키 값
value증가 값
listeneronAuthV4Helper achievementsIncrement 결과 통지

◆ achievementsReveal() [1/2]

static void hive.AuthV4.Helper.achievementsReveal ( String achievementId)
static

숨겨진 업적 공개.

업적이 0% 로 공개만 될 뿐 달성 되지는 않는다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

매개변수
achievementId업적 키 값

◆ achievementsReveal() [2/2]

static void hive.AuthV4.Helper.achievementsReveal ( String achievementId,
onAuthV4Helper listener )
static

숨겨진 업적 공개.

업적이 0% 로 공개만 될 뿐 달성 되지는 않는다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 숨겨진 업적 공개 요청 성공
-
RESPONSE_FAIL AuthV4GoogleResponseFailAchievementsReveal PGS API 함수 호출이 실패한 경우 -
매개변수
achievementId업적 키 값
listeneronAuthV4Helper achievementsReveal 결과 통지

◆ achievementsUnlock() [1/2]

static void hive.AuthV4.Helper.achievementsUnlock ( String achievementId)
static

업적 달성.

숨겨져 있거나 공개된 여부와 상관없이 업적이 100% 로 달성 된다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

매개변수
achievementId업적 키 값

◆ achievementsUnlock() [2/2]

static void hive.AuthV4.Helper.achievementsUnlock ( String achievementId,
onAuthV4Helper listener )
static

업적 달성.

숨겨져 있거나 공개된 여부와 상관없이 업적이 100% 로 달성 된다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 업적 달성 요청 성공
-
RESPONSE_FAIL AuthV4GoogleResponseFailAchievementsUnlock PGS API 함수 호출이 실패한 경우 -
매개변수
achievementId업적 키 값
listeneronAuthV4Helper achievementsUnlock 결과 통지

◆ connect()

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

Provider 연결

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success Provider 연결 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CONFLICT_PLAYER AuthV4ConflictPlayer Connect를 시도한 Provider의 Player ID가 이미 있는 경우
playerInfo: 충돌 계정 정보 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
listenerAuthV4HelperListener AuthV4Helper Connect 결과 통지

◆ disconnect()

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

Provider 연결

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success Provider 연결 해제 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
INVALID_PARAM AuthV4ProviderAlreadtDisconnected 해제 요청받은 Provider가 해당 계정에 연결되지 않은 경우 -
매개변수
listenerAuthV4HelperListener AuthV4Helper Disconnect 결과 통지

◆ getIDPList()

static List< ProviderType > hive.AuthV4.Helper.getIDPList ( )
static

SDK에서 제공하는 Provider의 목록을 받는다.



◆ leaderboardsSubmitScore() [1/2]

static void hive.AuthV4.Helper.leaderboardsSubmitScore ( String leaderboardId,
long score )
static

리더보드 점수를 갱신.


leaderboardId 에 해당하는 기록에 score 수치로 갱신된다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

매개변수
leaderboardId리더보드 키 값
score리더보드 점수

◆ leaderboardsSubmitScore() [2/2]

static void hive.AuthV4.Helper.leaderboardsSubmitScore ( String leaderboardId,
long score,
onAuthV4Helper listener )
static

리더보드 점수를 갱신.


leaderboardId 에 해당하는 기록에 score 수치로 갱신된다.

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 리더보드 점수 갱신 요청 성공
-
RESPONSE_FAIL AuthV4GoogleResponseFailLeaderboardsSubmitScore PGS API 함수 호출이 실패한 경우 -
매개변수
leaderboardId리더보드 키 값
score리더보드 점수
listeneronAuthV4Helper LeaderboardsSubmitScore 결과 통지

◆ onAuthV4DialogDismiss()

delegate void hive.AuthV4.Helper.onAuthV4DialogDismiss ( bool isDismiss)

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

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

◆ onAuthV4Helper()

delegate void hive.AuthV4.Helper.onAuthV4Helper ( ResultAPI result,
PlayerInfo playerInfo )

AuthV4Helper API 요청 결과 통지

매개변수
resultresult에 올 수 있는 ErrorCode와 Code는 아래와 같다.
ErrorCode Code

Description

SUCCESS Success 계정 충돌이 없으며 요청한 작업이 정상적으로 수행됨
NEED_INITIALIZE AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우
INVALID_SESSION AuthV4SigninFirst 로그인 상태에서 사용 가능한 API를 로그인하지 않은 상태에서 호출한 경우
INVALID_PARAM AuthV4AlreadyAuthorized 로그인 상태에서 다시 로그인 API를 호출한 경우
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나 Connect를 시도한 Provider의 Player ID가 이미 있는 경우
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
CANCELED AuthV4PlayerResolved 계정 충돌이 발생한 후 현재 로그인 된 계정을 유지하는 경우
INVALID_SESSION AuthV4HelperImplifiedLoginFail 묵시적 로그인에 실패하여 명시적 로그인을 진행해야 하는 경우
IN_PROGRESS AuthV4InProgressSignIn
AuthV4InProgressConnect
AuthV4InProgressShowLeaderboard
AuthV4InProgressShowAchievements 		요청한 작업이 아직 처리중인 경우
playerInforesult에 따라 올 수 있는 사용자의 정보는 아래와 같다.
ErrorCode Code Player Info
SUCCESS Success 현재 로그인 된 유저의 정보
CONFLICT_PLAYER AuthV4ConflictPlayer 충돌이 발생한 유저의 정보
PLAYER_CHANGE AuthV4PlayerChange 계정 전환에 성공한 유저의 정보
CANCELED AuthV4PlayerResolved 현재 유저의 정보
참고
ResultAPI, PlayerInfo

<>

◆ playerDelete()

static void hive.AuthV4.Helper.playerDelete ( onAuthV4Helper listener)
static

사용자 삭제

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 로그아웃 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
매개변수
listenerAuthV4HelperListener AuthV4Helper Delete 결과 통지

◆ resolveConflict()

static void hive.AuthV4.Helper.resolveConflict ( onAuthV4Helper listener)
static

계정 Conflict가 발생한 경우 기존 사용자를 유지하는 경우 사용한다.


주요 결과 코드

ErrorCode Code Description
CANCELED AuthV4PlayerResolved 계정 충돌이 발생한 후 현재 로그인 된 계정을 유지하는 경우
매개변수
listenerAuthV4HelperListener AuthV4Helper Resolve Conflict결과 통지

◆ showAchievements()

static void hive.AuthV4.Helper.showAchievements ( onAuthV4Helper listener)
static

업적 조회

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 업적 조회 요청 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나
Connect를 시도한 Provider의 Player ID가 이미 있는 경우 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
listenerAuthV4HelperListener AuthV4Helper Show achievements 결과 통지

◆ showConflict() [1/2]

static void hive.AuthV4.Helper.showConflict ( ConflictSingleViewInfo viewInfo,
onAuthV4Helper listener )
static

충돌 상태를 알려주고 사용할 계정을 선택할 수 있고, 게임 정보를 같이 표현할 수 있는 HIVE UI 를 보여준다.


주요 결과 코드

ErrorCode Code Description
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
INVALID_PARAM AuthV4InvalidConflictInfo 계정 충돌이 발생하지 않은 상태에서 계정 충돌 해결을 요청한 경우
매개변수
conflictDataHIVEConflictSingleViewInfo 충돌이 발생한 사용자의 게임 데이터
listenerAuthV4HelperListener AuthV4Helper Show Conflict 결과 통지
참고
ConflictSingleViewInfo

◆ showConflict() [2/2]

static void hive.AuthV4.Helper.showConflict ( onAuthV4Helper listener)
static

충돌 상태를 알려주고 사용할 계정을 선택하는 HIVE UI 를 보여준다.


주요 결과 코드

ErrorCode Code Description
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
INVALID_PARAM AuthV4InvalidConflictInfo 계정 충돌이 발생하지 않은 상태에서 계정 충돌 해결을 요청한 경우
매개변수
listenerAuthV4HelperListener AuthV4Helper Show Conflict 결과 통지

◆ showLeaderboard()

static void hive.AuthV4.Helper.showLeaderboard ( onAuthV4Helper listener)
static

리더보드 조회

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

특이 사항

  1. 로그인 되어있는 계정이 PGS/GameCenter에 연결되어있지 않은 경우 자동으로 해당 서비스로 연결을 시도

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 리더보드 조회 요청 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나
Connect를 시도한 Provider의 Player ID가 이미 있는 경우 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
listenerAuthV4HelperListener AuthV4Helper Show leaderboard 결과 통지

◆ signIn()

static void hive.AuthV4.Helper.signIn ( onAuthV4Helper listener)
static

사용자 로그인

사용 조건

  1. HIVE SDK 초기화

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 로그인 성공
playerInfo: 로그인 성공한 사용자의 정보 		-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
IN_PROGRESS AuthV4InProgressSignIn
Sign In 처리 중 재요청이 들어온 경우 기존 SignIn 요청 결과 대기
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나
Connect를 시도한 Provider의 Player ID가 이미 있는 경우
playerInfo: 충돌 계정 정보 		계정 충돌 상황 해결 방법 안내에 따라 해결
INVALID_SESSION AuthV4HelperImplifiedLoginFail 묵시적 로그인에 실패하여 명시적 로그인을 진행해야 하는 경우 AuthV4.Helper.getIDPList()로 지원 Provider 목록 조회 후 명시적 로그인 UI를 구현하거나,
AuthV4.showSignIn() HIVE UI를 이용하여 명시적 로그인 동작 수행
매개변수
listenerAuthV4HelperListener AuthV4Helper Sign In 결과 통지

◆ signOut()

static void hive.AuthV4.Helper.signOut ( onAuthV4Helper listener)
static

사용자 로그아웃

사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 로그아웃 성공
-
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
매개변수
listenerAuthV4HelperListener AuthV4Helper Sign Out 결과 통지

◆ switchAccount()

static void hive.AuthV4.Helper.switchAccount ( onAuthV4Helper listener)
static

계정 Conflict가 발생한 경우 현재 로그인 된 사용자를 로그아웃 시키고,
기기에 연결된 계정으로 로그인을 시도한다.


주요 결과 코드

ErrorCode Code Description
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
매개변수
listenerAuthV4HelperListener AuthV4Helper Switch Account 결과 통지

◆ syncAccount()

static void hive.AuthV4.Helper.syncAccount ( ProviderType providerType,
onAuthV4Helper listener )
static

제공된 API 외 경우에 계정의 충돌 여부를 확인할 수 있다.


사용 조건

  1. HIVE SDK 초기화
  2. HIVE SignIn 완료

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 계정 상태 정상 -
NEED_INITIALIZED AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CONFLICT_PLAYER AuthV4ConflictPlayer 로그인한 계정과 기기에 로그인된 PGS/GameCenter 계정이 다른 경우 계정 충돌 상황 해결 방법 안내에 따라 해결
NOT_SUPPORTED AuthV4NotSupportedProviderType PGS/GameCenter 외 Provider Type으로 계정 상태를 조회한 경우 -
매개변수
providerType동기화를 요청할 ProviderType
listenerAuthV4HelperListener AuthV4Helper Sync Account 결과 통지
Copyright © Com2uS Platform Corporation. All Right Reserved. 이용약관 개인정보 처리방침