HIVE SDK for Unreal Engine

함수
FHiveAuthV4Helper
FHiveAuthV4

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

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

함수

static void FHiveAuthV4::Helper::SyncAccount (const EHiveProviderType &ProviderType, const FHiveAuthV4HelperDelegate &Delegate)
 제공된 API 외 경우에 계정의 충돌 여부를 확인할 수 있다. 더 자세히 ...
 
static void FHiveAuthV4::Helper::SignIn (const FHiveAuthV4HelperDelegate &Delegate)
 사용자 로그인
더 자세히 ...
 
static void FHiveAuthV4::Helper::SignOut (const FHiveAuthV4HelperDelegate &Delegate)
 사용자 로그아웃
더 자세히 ...
 
static void FHiveAuthV4::Helper::PlayerDelete (const FHiveAuthV4HelperDelegate &Delegate)
 사용자 삭제
더 자세히 ...
 
static void FHiveAuthV4::Helper::Connect (const EHiveProviderType &ProviderType, const FHiveAuthV4HelperDelegate &Delegate)
 Provider 연결
더 자세히 ...
 
static void FHiveAuthV4::Helper::Disconnect (const EHiveProviderType &ProviderType, const FHiveAuthV4HelperDelegate &Delegate)
 Provider 연결 해제
더 자세히 ...
 
static void FHiveAuthV4::Helper::ShowAchievements (const FHiveAuthV4HelperDelegate &Delegate)
 업적 조회
더 자세히 ...
 
static void FHiveAuthV4::Helper::ShowLeaderboard (const FHiveAuthV4HelperDelegate &Delegate)
 리더보드 조회
더 자세히 ...
 
static void FHiveAuthV4::Helper::AchievementsReveal (const FString &achievementId, const FHiveAuthV4HelperDelegate &Delegate)
 숨겨진 업적 공개. 더 자세히 ...
 
static void FHiveAuthV4::Helper::AchievementsUnlock (const FString &achievementId, const FHiveAuthV4HelperDelegate &Delegate)
 업적 달성. 더 자세히 ...
 
static void FHiveAuthV4::Helper::AchievementsIncrement (const FString &AchievementId, int64 value, const FHiveAuthV4HelperDelegate &Delegate)
 업적 수치 증가. 더 자세히 ...
 
static void FHiveAuthV4::Helper::LeaderboardsSubmitScore (const FString &LeaderboardId, int64 value, const FHiveAuthV4HelperDelegate &Delegate)
 리더보드 점수를 갱신. 더 자세히 ...
 
static void FHiveAuthV4::Helper::ShowConflict (const FHiveAuthV4HelperDelegate &Delegate)
 충돌 상태를 알려주고 사용할 계정을 선택하는 HIVE UI 를 보여준다. 더 자세히 ...
 
static void FHiveAuthV4::Helper::ShowConflict (const FHiveConflictSingleViewData &ViewData, const FHiveAuthV4HelperDelegate &Delegate)
 충돌 상태를 알려주고 사용할 계정을 선택할 수 있고, 게임 정보를 같이 표현할 수 있는 HIVE UI 를 보여준다. 더 자세히 ...
 
static void FHiveAuthV4::Helper::SwitchAccount (const FHiveAuthV4HelperDelegate &Delegate)
 계정 Conflict가 발생한 경우 현재 로그인 된 사용자를 로그아웃 시키고,
기기에 연결된 계정으로 로그인을 시도한다. 더 자세히 ...
 
static void FHiveAuthV4::Helper::ResolveConflict (const FHiveAuthV4HelperDelegate &Delegate)
 계정 Conflict가 발생한 경우 기존 사용자를 유지하는 경우 사용한다. 더 자세히 ...
 
static TArray< EHiveProviderType > FHiveAuthV4::Helper::GetIDPList ()
 SDK에서 제공하는 Provider의 목록을 받는다. 더 자세히 ...
 
static void FHiveAuthV4::Helper::ShowGameCenterLoginCancelDialog (const FHiveAuthV4HelperOnDialogDismissDelegate &Delegate)
 Game Center 로그인창을 표시할 수 없는 경우, 해당 상태를 보여주고,
Game Center 로그인 방법을 안내하는 UI를 띄운다. 더 자세히 ...
 

상세한 설명

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

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


함수 문서화

◆ AchievementsIncrement()

static void FHiveAuthV4::Helper::AchievementsIncrement ( const FString &  AchievementId,
int64  value,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

업적 수치 증가.


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

사용 조건

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

특이 사항

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

주요 결과 코드

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

◆ AchievementsReveal()

static void FHiveAuthV4::Helper::AchievementsReveal ( const FString &  achievementId,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

숨겨진 업적 공개.

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

사용 조건

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

특이 사항

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

주요 결과 코드

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

◆ AchievementsUnlock()

static void FHiveAuthV4::Helper::AchievementsUnlock ( const FString &  achievementId,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

업적 달성.

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

사용 조건

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

특이 사항

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

주요 결과 코드

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

◆ Connect()

static void FHiveAuthV4::Helper::Connect ( const EHiveProviderType &  ProviderType,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

Provider 연결

사용 조건

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

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success Provider 연결 성공
-
NEED_INITIALIZE AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CANCELED AuthV4AppleLoginCancel Apple GameCenter 로그인창을 표시할 수 없거나 사용자가 GameCenter 로그인을 취소한 경우 AuthV4.helper.showGameCenterLoginCancelDialog() API로 게임센터 로그인 안내 팝업을 표시하거나,
직접 구현하여 사용자에게 GameCenter 로그인 방법을 안내
CONFLICT_PLAYER AuthV4ConflictPlayer Connect를 시도한 Provider의 Player ID가 이미 있는 경우
playerInfo: 충돌 계정 정보 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Connect 결과 통지

◆ Disconnect()

static void FHiveAuthV4::Helper::Disconnect ( const EHiveProviderType &  ProviderType,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

Provider 연결 해제

사용 조건

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

주요 결과 코드

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

◆ GetIDPList()

static TArray< EHiveProviderType > FHiveAuthV4::Helper::GetIDPList ( )
static

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



◆ LeaderboardsSubmitScore()

static void FHiveAuthV4::Helper::LeaderboardsSubmitScore ( const FString &  LeaderboardId,
int64  value,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

리더보드 점수를 갱신.


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

사용 조건

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

특이 사항

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

주요 결과 코드

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

◆ PlayerDelete()

static void FHiveAuthV4::Helper::PlayerDelete ( const FHiveAuthV4HelperDelegate &  Delegate)
static

사용자 삭제 

\~korean

사용 조건

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

주요 결과 코드

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

◆ ResolveConflict()

static void FHiveAuthV4::Helper::ResolveConflict ( const FHiveAuthV4HelperDelegate &  Delegate)
static

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


주요 결과 코드

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

◆ ShowAchievements()

static void FHiveAuthV4::Helper::ShowAchievements ( const FHiveAuthV4HelperDelegate &  Delegate)
static

업적 조회

사용 조건

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

특이 사항

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

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 업적 조회 요청 성공
-
NEED_INITIALIZE AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CANCELED AuthV4AppleLoginCancel Apple GameCenter 로그인창을 표시할 수 없거나 사용자가 GameCenter 로그인을 취소한 경우 AuthV4.helper.showGameCenterLoginCancelDialog() API로 게임센터 로그인 안내 팝업을 표시하거나,
직접 구현하여 사용자에게 GameCenter 로그인 방법을 안내
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나
Connect를 시도한 Provider의 Player ID가 이미 있는 경우 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Show achievements 결과 통지

◆ ShowConflict() [1/2]

static void FHiveAuthV4::Helper::ShowConflict ( const FHiveAuthV4HelperDelegate &  Delegate)
static

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


주요 결과 코드

ErrorCode Code Description
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
CANCELED AuthV4PlayerResolved 계정 충돌이 발생한 후 현재 로그인 된 계정을 유지하는 경우
INVALID_PARAM AuthV4InvalidConflictInfo 계정 충돌이 발생하지 않은 상태에서 계정 충돌 해결을 요청한 경우
매개변수
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Show Conflict 결과 통지

◆ ShowConflict() [2/2]

static void FHiveAuthV4::Helper::ShowConflict ( const FHiveConflictSingleViewData &  ViewData,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

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


주요 결과 코드

ErrorCode Code Description
PLAYER_CHANGE AuthV4PlayerChange 계정 충돌이 발생한 후 계정 전환에 성공한 경우
CANCELED AuthV4PlayerResolved 계정 충돌이 발생한 후 현재 로그인 된 계정을 유지하는 경우
INVALID_PARAM AuthV4InvalidConflictInfo 계정 충돌이 발생하지 않은 상태에서 계정 충돌 해결을 요청한 경우
매개변수
ViewDataConflictSingleViewInfo 충돌이 발생한 사용자의 게임 데이터
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Show Conflict 결과 통지

◆ ShowGameCenterLoginCancelDialog()

static void FHiveAuthV4::Helper::ShowGameCenterLoginCancelDialog ( const FHiveAuthV4HelperOnDialogDismissDelegate &  Delegate)
static

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

매개변수
DelegateFHiveAuthV4HelperOnDialogDismissDelegate 계정 안내 팝업 Close 여부 통지

◆ ShowLeaderboard()

static void FHiveAuthV4::Helper::ShowLeaderboard ( const FHiveAuthV4HelperDelegate &  Delegate)
static

리더보드 조회

사용 조건

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

특이 사항

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

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 리더보드 조회 요청 성공
-
NEED_INITIALIZE AuthV4NotInitialized HIVE SDK가 초기화되지 않은 경우 AuthV4.setup() API로 HIVE SDK 초기화
CANCELED AuthV4AppleLoginCancel Apple GameCenter 로그인창을 표시할 수 없거나 사용자가 GameCenter 로그인을 취소한 경우 AuthV4.helper.showGameCenterLoginCancelDialog() API로 게임센터 로그인 안내 팝업을 표시하거나,
직접 구현하여 사용자에게 GameCenter 로그인 방법을 안내
CONFLICT_PLAYER AuthV4ConflictPlayer Device에 로그인 된 계정과 현재 로그인 된 계정의 PGS/GameCenter 정보가 다르거나
Connect를 시도한 Provider의 Player ID가 이미 있는 경우 		계정 충돌 상황 해결 방법 안내에 따라 해결
매개변수
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Show leaderboard 결과 통지

◆ SignIn()

static void FHiveAuthV4::Helper::SignIn ( const FHiveAuthV4HelperDelegate &  Delegate)
static

사용자 로그인

사용 조건

  1. HIVE SDK 초기화

주요 결과 코드

ErrorCode Code Description Solution
SUCCESS Success 로그인 성공
playerInfo: 로그인 성공한 사용자의 정보 		-
NEED_INITIALIZE 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를 이용하여 명시적 로그인 동작 수행
매개변수
DelegateFHiveAuthV4HelperDelegate AuthV4Helper Sign In 결과 통지

◆ SignOut()

static void FHiveAuthV4::Helper::SignOut ( const FHiveAuthV4HelperDelegate &  Delegate)
static

사용자 로그아웃

사용 조건

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

주요 결과 코드

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

◆ SwitchAccount()

static void FHiveAuthV4::Helper::SwitchAccount ( const FHiveAuthV4HelperDelegate &  Delegate)
static

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


주요 결과 코드

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

◆ SyncAccount()

static void FHiveAuthV4::Helper::SyncAccount ( const EHiveProviderType &  ProviderType,
const FHiveAuthV4HelperDelegate &  Delegate 
)
static

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


사용 조건

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

주요 결과 코드

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