HIVE SDK for Android

클래스 | 함수 | 변수
AuthV4Helper

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

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

클래스

interface  com.hive.AuthV4.Helper.AuthV4HelperListener
 AuthV4Helper API 요청 결과 통지 더 자세히 ...
 
class  com.hive.AuthV4.Helper.ConflictSingleViewInfo
 계정 충돌시 충돌 유저의 게임 정보를 같이 보여주기 위한 클래스
더 자세히 ...
 

함수

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

사용 조건

  1. HIVE SDK 초기화

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.signOut (final AuthV4.Helper.AuthV4HelperListener listener)
 사용자 로그아웃

사용 조건

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

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.connect (AuthV4.ProviderType providerType, final AuthV4.Helper.AuthV4HelperListener listener)
 Provider 연결

사용 조건

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

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.disconnect (AuthV4.ProviderType providerType, final AuthV4.Helper.AuthV4HelperListener listener)
 Provider 연결

사용 조건

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

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.showLeaderboard (final AuthV4.Helper.AuthV4HelperListener listener)
 리더보드 조회

사용 조건

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

    특이 사항

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

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.leaderboardsSubmitScore (String leaderboardId, long score)
 리더보드 점수를 갱신. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.leaderboardsSubmitScore (String leaderboardId, long score, final AuthV4.Helper.AuthV4HelperListener listener)
 리더보드 점수를 갱신. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.showAchievements (final AuthV4.Helper.AuthV4HelperListener listener)
 업적 조회

사용 조건

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

    특이 사항

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

    주요 결과 코드

더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsReveal (String achievementId)
 숨겨진 업적 공개. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsReveal (String achievementId, final AuthV4.Helper.AuthV4HelperListener listener)
 숨겨진 업적 공개
더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsUnlock (String achievementId)
 업적 달성. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsUnlock (String achievementId, final AuthV4.Helper.AuthV4HelperListener listener)
 업적 달성. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsIncrement (String incrementalAchievementId, int value)
 업적 수치 증가. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.achievementsIncrement (String incrementalAchievementId, int value, final AuthV4.Helper.AuthV4HelperListener listener)
 업적 수치 증가. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.showConflict (final AuthV4.Helper.AuthV4HelperListener listener)
 충돌 상태를 알려주고 사용할 계정을 선택하는 HIVE UI 를 보여준다. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.showConflict (ConflictSingleViewInfo conflictData, final AuthV4.Helper.AuthV4HelperListener listener)
 충돌 상태를 알려주고 사용할 계정을 선택할 수 있고, 게임 정보를 같이 표현할 수 있는 HIVE UI 를 보여준다. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.switchAccount (final AuthV4.Helper.AuthV4HelperListener listener)
 계정 Conflict가 발생한 경우 현재 로그인 된 사용자를 로그아웃 시키고,
기기에 연결된 계정으로 로그인을 시도한다. 더 자세히 ...
 
static void com.hive.AuthV4.Helper.resolveConflict (final AuthV4.Helper.AuthV4HelperListener listener)
 계정 Conflict가 발생한 경우 기존 사용자를 유지하는 경우 사용한다. 더 자세히 ...
 
static ArrayList< AuthV4.ProviderType > com.hive.AuthV4.Helper.getIDPList ()
 SDK에서 제공하는 Provider의 목록을 받는다. 더 자세히 ...
 

변수

 com.hive.AuthV4.AuthV4MaintenanceActionType.OPEN_URL =(1)
 외부 브라우저로 전달된 url 을 실행
 
 com.hive.AuthV4.AuthV4MaintenanceActionType.EXIT =(2)
 앱 종료
 
 com.hive.AuthV4.AuthV4MaintenanceActionType.DONE =(3)
 아무 처리도 하지 않음.
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.title
 점검 제목
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.message
 점검 내용
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.button
 버튼의 Text 문구 ex) 확인
 
AuthV4MaintenanceActionType com.hive.AuthV4.AuthV4MaintenanceInfo.action
 버튼을 눌렀을때 동작될 행동
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.url
 action 이 OPEN_URL 일 경우에 브라우징 될 URL
 
int com.hive.AuthV4.AuthV4MaintenanceInfo.remainingTime
 EXIT 일 경우 점검 완료까지 남은 초단위 시간. 시간은 실시간 갱신되며 0초가 되면 앱 종료
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.startDate
 점검시작일 YYYY-mm-dd HH:ii
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.endDate
 점검종료일 YYYY-mm-dd HH:ii
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.customerButton
 고객센터 문구
 
String com.hive.AuthV4.AuthV4MaintenanceInfo.customerLink
 고객센터 링크
 

상세한 설명

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

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


함수 문서화

§ achievementsIncrement() [1/2]

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

업적 수치 증가.


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

사용 조건

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

    특이 사항

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

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

§ achievementsIncrement() [2/2]

static void com.hive.AuthV4.Helper.achievementsIncrement ( String  incrementalAchievementId,
int  value,
final AuthV4.Helper.AuthV4HelperListener  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증가 값
listenerAuthV4Helper achievementsIncrement 결과 통지

§ achievementsReveal() [1/2]

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

숨겨진 업적 공개.

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

사용 조건

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

    특이 사항

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

매개변수
achievementId업적 키 값

§ achievementsReveal() [2/2]

static void com.hive.AuthV4.Helper.achievementsReveal ( String  achievementId,
final AuthV4.Helper.AuthV4HelperListener  listener 
)
static

숨겨진 업적 공개

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

사용 조건

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

    특이 사항

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

    주요 결과 코드

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

§ achievementsUnlock() [1/2]

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

업적 달성.

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

사용 조건

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

    특이 사항

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

매개변수
achievementId업적 키 값

§ achievementsUnlock() [2/2]

static void com.hive.AuthV4.Helper.achievementsUnlock ( String  achievementId,
final AuthV4.Helper.AuthV4HelperListener  listener 
)
static

업적 달성.

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

사용 조건

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

    특이 사항

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

    주요 결과 코드

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

§ connect()

static void com.hive.AuthV4.Helper.connect ( AuthV4.ProviderType  providerType,
final AuthV4.Helper.AuthV4HelperListener  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 com.hive.AuthV4.Helper.disconnect ( AuthV4.ProviderType  providerType,
final AuthV4.Helper.AuthV4HelperListener  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 ArrayList<AuthV4.ProviderType> com.hive.AuthV4.Helper.getIDPList ( )
static

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



§ leaderboardsSubmitScore() [1/2]

static void com.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 com.hive.AuthV4.Helper.leaderboardsSubmitScore ( String  leaderboardId,
long  score,
final AuthV4.Helper.AuthV4HelperListener  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리더보드 점수
listenerAuthV4Helper LeaderboardsSubmitScore 결과 통지

§ resolveConflict()

static void com.hive.AuthV4.Helper.resolveConflict ( final AuthV4.Helper.AuthV4HelperListener  listener)
static

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


주요 결과 코드

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

§ showAchievements()

static void com.hive.AuthV4.Helper.showAchievements ( final AuthV4.Helper.AuthV4HelperListener  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 com.hive.AuthV4.Helper.showConflict ( final AuthV4.Helper.AuthV4HelperListener  listener)
static

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


주요 결과 코드

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

§ showConflict() [2/2]

static void com.hive.AuthV4.Helper.showConflict ( ConflictSingleViewInfo  conflictData,
final AuthV4.Helper.AuthV4HelperListener  listener 
)
static

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


주요 결과 코드

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

§ showLeaderboard()

static void com.hive.AuthV4.Helper.showLeaderboard ( final AuthV4.Helper.AuthV4HelperListener  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 com.hive.AuthV4.Helper.signIn ( final AuthV4.Helper.AuthV4HelperListener  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 com.hive.AuthV4.Helper.signOut ( final AuthV4.Helper.AuthV4HelperListener  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 com.hive.AuthV4.Helper.switchAccount ( final AuthV4.Helper.AuthV4HelperListener  listener)
static

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


주요 결과 코드

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

§ syncAccount()

static void com.hive.AuthV4.Helper.syncAccount ( ProviderType  providerType,
AuthV4HelperListener  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 © GAMEVIL COM2US PLATFORM Inc. All Right Reserved. 이용약관 개인정보 처리방침