Hive SDK 초기화

게임에 탑재한 Hive 기능을 이용하려면 반드시 Hive SDK를 초기화해야 합니다. Hive SDK 초기화를 진행하면 Hive 콘솔에 등록된 약관 및 업데이트·공지 팝업이 자동으로 노출됩니다.

Hive SDK 초기화 동작 방식

Hive SDK 초기화 시 다음 기능을 수행합니다.

• • Hive SDK는 초기화 함수 하나로 다음 항목을 초기화합니다.
    • 인증: Hive 클라이언트 초기화 및 유저 인증 기능을 제공
    • 프로모션: 광고 집행 및 쿠폰 발급
    • 노티피케이션: 유저에게 발송하는 푸시 메시지를 설정·관리
    • 마케팅 어트리뷰션: 광고 유입, 사용자 이벤트 분석 등 유저 정보를 추적하는 서드 파티 모듈의 통합 관리를 지원
  • 초기화 다이어그램
    

  Hive SDK 초기화 구현하기

  Hive 클라이언트를 초기화 하려면 Auth 클래스의 initialize() 메서드를 호출하세요. SDK 초기화를 수행하면 AuthInitResult 클래스에 결과를 담아서 전달합니다. AuthInitResult 클래스 필드는 다음과 같습니다.

  필드명	설명	예제
  isAuthorized	정식(계정) 로그인 가능 여부	true
  loginType	수행 가능한 Hive 로그인 타입	LoginType.GUEST
  did	Hive 로그인의 유효성을 확인하기 위해 Hive 인증 서버에서 발급하는 디바이스 고유 식별자	123456
  isPGSLogin	Google Play 게임을 이용한 로그인 가능 여부 (Android 전용)	true
  playerName	Google Play 게임의 사용자 프로필에 노출되는 이름 (Android 전용)	“i’m pgs user”
  playerId	Google Play 게임의 사용자 계정 (Android 전용)

  다음은 Hive 클라이언트를 초기화하는 예제 코드입니다.
  

  Unity®

  API Reference: hive.Auth.initialize

  using hive; Auth.initialize ((ResultAPI result, AuthInitResult authInitResult) => { if (result.isSuccess ()) { // 호출 성공 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요 // 예) Application.Quit(); } });

  1 2 3 4 5 6 7 8 9 10

  using hive;     Auth.initialize ((ResultAPI result, AuthInitResult authInitResult) => { if (result.isSuccess ()) {         // 호출 성공     } else if (result.needExit()) {         // TODO: 앱 종료 기능을 구현하세요         // 예) Application.Quit();     } });

  C++

  API Reference: Auth::initialize

  #include <HIVE_SDK_Plugin/HIVE_CPP.h> using namespace std; using namespace hive; Auth::initialize([=](ResultAPI result, AuthInitResult authInitResult) { if (result.isSuccess()) { // 호출 성공 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요 // Cocos2d-x 엔진 사용자 // 예) exit(0); // Unreal 엔진 사용자 // 예) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false); } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

  #include <HIVE_SDK_Plugin/HIVE_CPP.h> using namespace std; using namespace hive;   Auth::initialize([=](ResultAPI result, AuthInitResult authInitResult) { if (result.isSuccess()) { // 호출 성공 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요 // Cocos2d-x 엔진 사용자 // 예) exit(0); // Unreal 엔진 사용자 // 예) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false); } });

  Kotlin

  API Reference: com.hive.Auth.initialize

  import com.hive.Auth import com.hive.ResultAPI Auth.initialize(object : Auth.AuthInitializeListener { override fun onAuthInitialize(result: ResultAPI, authInitResult: Auth.AuthInitResult?) { if (result.isSuccess) { // 호출 성공 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요 // 예) exitProcess(0) } } })

  1 2 3 4 5 6 7 8 9 10 11 12 13

  import com.hive.Auth import com.hive.ResultAPI   Auth.initialize(object : Auth.AuthInitializeListener {     override fun onAuthInitialize(result: ResultAPI, authInitResult: Auth.AuthInitResult?) {         if (result.isSuccess) {             // 호출 성공         } else if (result.needExit()) {             // TODO: 앱 종료 기능을 구현하세요             // 예) exitProcess(0)         }     } })

  Java

  API Reference: com.hive.Auth.initialize

  import com.hive.Auth; import com.hive.ResultAPI; Auth.INSTANCE.initialize((result, authInitResult) -> { if (result.isSuccess()) { // 호출 성공 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요 // 예) System.exit(0); } });

  1 2 3 4 5 6 7 8 9 10 11

  import com.hive.Auth; import com.hive.ResultAPI;   Auth.INSTANCE.initialize((result, authInitResult) -> {     if (result.isSuccess()) {         // 호출 성공     } else if (result.needExit()) {         // TODO: 앱 종료 기능을 구현하세요         // 예) System.exit(0);     } });

  Swift

  API Reference: HIVEAuth::initialize:

  import HIVEService AuthInterface.initialize() { result, authInitResult in if result.isSuccess() { // 호출 성공 } else if result.needExit() { // TODO: 앱 종료 기능을 구현하세요 // 예) exit(0) } }

  1 2 3 4 5 6 7 8 9 10

  import HIVEService   AuthInterface.initialize() { result, authInitResult in     if result.isSuccess() {         // 호출 성공     } else if result.needExit() {         // TODO: 앱 종료 기능을 구현하세요         // 예) exit(0)     } }

  Objective-C

  API Reference: HIVEAuth::initialize:

  #import <HIVEService/HIVEService-Swift.h> [HIVEAuth initialize: ^(HIVEResultAPI *result, HIVEAuthInitResult *authInitResult) { if ([result isSuccess]) { // 호출 성공 } else if ([result needExit]) { // TODO: 앱 종료 기능을 구현하세요 // 예) exit(0); } }];

  1 2 3 4 5 6 7 8 9 10

  #import <HIVEService/HIVEService-Swift.h>     [HIVEAuth initialize: ^(HIVEResultAPI *result, HIVEAuthInitResult *authInitResult) {     if ([result isSuccess]) {         // 호출 성공     } else if ([result needExit]) {         // TODO: 앱 종료 기능을 구현하세요         // 예) exit(0);     } }];