Hive SDK 튜토리얼은 게임에 적용된 Hive SDK의 각 기능들이 어떻게 동작하는지 보여 주는 샘플 앱입니다. Hive SDK 튜토리얼을 통해 게임 구성에 필요한 Hive SDK 필수 기능들의 동작과 소스 코드를 확인해보세요.

  • 튜토리얼 시작하기에서는 Hive SDK 필수 기능들을 순서대로 확인할 수 있습니다.
  • 튜토리얼 항목별 확인하기에서는 확인하고자 하는 기능을 선택하여 확인할 수 있습니다.

[튜토리얼 앱 화면 예시] 튜토리얼 앱 화면 예시

[튜토리얼 소스코드 예시]
튜토리얼 소스코드 예시

최신 다운로드

아래의 파일을 클릭하여 튜토리얼 앱과 소스코드를 다운로드하세요.

  • 최소 지원 버전: Hive SDK v4.16.4.0
  • 게임 엔진: Unity®

 

튜토리얼 소개

Hive SDK 튜토리얼에서 구현하는 Hive의 기능은 다음과 같습니다. 각 기능에 관한 자세한 내용은 관련 개발가이드를 참고하세요.

인증

  • SDK 초기화
    • Hive 기능을 이용하려면 반드시 Hive SDK를 초기화해야 합니다. 튜토리얼에서는 SDK 초기화 후 권한고지 및 약관동의 팝업 노출 단계까지만 구현합니다. SDK 초기화에 관한 자세한 내용은 Hive SDK 초기화를 참고하세요.
  • 로그인
    • Hive는 자동 로그인 및 묵시적 로그인, 명시적 로그인을 모두 지원합니다. 튜토리얼에서는 명시적 로그인이 구현된 동작을 확인할 수 있습니다. 로그인에 관한 자세한 내용은 로그인·로그아웃하기를 참고하세요.

프로모션

  • 새소식
    • 새소식 기능을 이용하여 게임 공지사항이나 이벤트 배너를 게시할 수 있습니다. 새소식에 관한 자세한 내용은 새소식 페이지 띄우기를 참고하세요.
  • 리뷰 팝업
    • Hive 프로모션은 마켓으로 이동하지 않고 게임 내에서 바로 리뷰를 남길 수 있는 네이티브 리뷰 팝업과 원하는 이미지와 문구로 구성할 수 있는 Hive 리뷰 팝업을 제공합니다. 튜토리얼에서는 Hive 리뷰 팝업의 동작을 구현했습니다. 리뷰 팝업에 관한 자세한 내용은 리뷰·종료 팝업을 참고하세요.

빌링 (Hive IAP v4)

  • 상점 초기화 (Hive IAP v4 초기화)
    • Hive IAP v4는 간단하게 결제를 구현할 수 있도록 영수증 검증과 중복 지급 체크 및 결제 로그 전송 등의 일련의 과정을 지원하여 개발 시간을 줄이고, 마켓의 변화에 빠르게 대응할 수 있는 결제 모듈입니다.
      Hive IAP v4를 사용하기 위해서는 구매 전 한번 IAP 초기화를 요청해야 합니다. Hive IAP 초기화에 관한 자세한 내용은 Hive IAP v4 초기화를 참고하세요.
  • 상품 목록 조회
    • 게임 내 상점 진입 시 상품 목록 조회 API를 호출해야 합니다. 상품 목록 조회에 관한 자세한 내용은 상품 목록 조회를 참고하세요.
  • 상품 구매
    • Hive IAP v4에서 상품 구매는 App Store, Google Play 스토어에 등록된 marketPid를 매개변수로 구매를 요청합니다. 튜토리얼에서는 상품 구매를 구현하기는 하나 실제 구매를 진행할 수는 없습니다. 상품 구매에 관한 자세한 내용은 상품 구매를 참고하세요.

노티피케이션

  • 로컬 푸시 수신
    • Hive는 Hive 콘솔 및 Hive 서버 API를 통해 유저에 푸시를 발송하는 리모트 푸시와 게임 클라이언트가 직접 유저에게 푸시를 발송하는 로컬 푸시 수신을 지원합니다. 튜토리얼에서는 로컬 푸시 수신을 통한 테스트 푸시를 수신할 수 있습니다. 푸시 전송에 관한 자세한 내용은 노티피케이션을 참고하세요.
  • 수신 설정 변경
    • 푸시 알림 서비스를 원하지 않는 유저를 위해서 게임 설정 창에서 푸시 알림을 켜고 끌 수 있는 기능을 제공해야 합니다. 튜토리얼에서는 푸시 수신 설정 기능을 확인할 수 있습니다. 푸시 수신 설정 변경에 관한 자세한 내용은 푸시 설정을 참고하세요.

 

개발 환경

Hive SDK 튜토리얼 개발 환경은 Hive SDK 개발 환경과 동일합니다. 자세한 내용은 릴리즈 노트 또는 SDK 설정하기 > Unity를 확인하세요.

설정하기

Unity 프로젝트에 튜토리얼 앱을 적용하기 위해 아래의 설명에 따라 설정하세요. 자세한 설정 가이드는 개발 환경에 플러그인 추가하기를 참고하세요.

  1. Hive SDK Manager로 Hive SDK를 설치합니다. 자세한 가이드는 Hive SDK Manager 페이지를 참고하세요.
  2. Hive SDK 설치 완료 후, 튜토리얼 소스코드에 있는 Hive SDK Tutorial UnityPackage를 프로젝트에 Import 합니다.
  3. Unity 에디터의 Edit > Project Settings > Player 설정에서 다음과 같이 설정하세요.
    • Package Name을 com.hive.tutorial.android.google.global.normal으로 변경합니다.
    • Minimum API Level을 Android 5.1 (API level 22)로 변경합니다.

  4. Unity 에디터의 Hive > ExternalDependency 설정에서 Firebase 체크를 해제합니다.
  5. Unity 에디터의 Hive > Edit Config에서 다음과 같이 설정하고, Regenerate Android Manifest & Hive Config & Import HIVE SDK, Google Play Services (Game, etc) 버튼을 누르세요.
    • AppID: com.sample.tutorial.android.google.global.normal
    • Facebook App ID: com.sample.tutorial.android.google.global.normal
    • Zone: Real

Hive SDK 튜토리얼 앱을 빌드하기 위한 설정을 마쳤습니다. 빌드하는 방법에 관한 내용은 Android 빌드하기를 참고하세요.