Unity
사용할 Hive SDK 기능을 외부 라이브러리 형태로 추가합니다. Hive SDK는 인증, 결제, 푸시 알림, 광고 배너 등 다양한 기능을 제공하며, 개발자는 이중에서 사용할 기능만을 골라 설치해야 합니다. 여기에서는 가장 기본적인 기능인 인증과 결제 기능을 사용하는 예시를 안내합니다.
Hive SDK는 UnityPackage 버전에 External-Dependency-Manager for Unity(EDM4U) 패키지를 포함하여 배포하며, EDM4U 설정으로 빌드에 필요한 라이브러리를 자동 설치/배포하도록 구성되어 있습니다. EDM4U가 동작할 수 있는 빌드 환경이 마련되지 않았다면 이를 구축해야 합니다. EDM4U에서 제공하는 GUI를 이용하거나 Unix 셸인 Bash, 다시 말해 명령줄 인터페이스(CLI, Command Line Interface)를 통해서도 가능합니다.
수동 설치/업데이트 시 유의 사항¶
Hive SDK v4 24.3.0부터 Hive SDK Manager가 아니라 Unity 패키지로 Hive SDK Unity를 설치 또는 업데이트하는 경우, 앱을 빌드하기 전에 아래 경로에 있는 HIVESDK_{라이브러리_이름}Dependencies.xml 파일을 모두 삭제해야 합니다.
- Assets/Hive_SDK_v4/Dependencies
- Assets/Hive_SDK_v4/Editor
삭제해야할 파일들은 다음과 같습니다.
- HIVESDK_DefaultDependencies.xml
- HIVESDK_HerculesDependencies.xml
- HIVESDK_HiveAnalyticsConsentModeDependencies.xml
- HIVESDK_HiveDataStoreDependencies.xml
- HIVESDK_HiveDeviceManagementDependencies.xml
- HIVESDK_HiveGoogleInAppReviewDependencies.xml
- HIVESDK_HiveGoogleInAppUpdateDependencies.xml
- HIVESDK_HivePromotionDependencies.xml
- HIVESDK_HiveRealNameVerificationDependencies.xml
- HIVESDK_MarketAmazonDependencies.xml
- HIVESDK_MarketAppleDependencies.xml
- HIVESDK_MarketGoogleDependencies.xml
- HIVESDK_MarketHiveStoreDependencies.xml
- HIVESDK_MarketHuaweiDependencies.xml
- HIVESDK_MarketLebiDependencies.xml
- HIVESDK_MarketOneStoreDependencies.xml
- HIVESDK_MarketSamsungDependencies.xml
- HIVESDK_ProviderAdjustDependencies.xml
- HIVESDK_ProviderAppleDependencies.xml
- HIVESDK_ProviderAppleSignInDependencies.xml
- HIVESDK_ProviderAppsFlyerDependencies.xml
- HIVESDK_ProviderFacebookDependencies.xml
- HIVESDK_ProviderFirebaseDependencies.xml
- HIVESDK_ProviderGoogleDependencies.xml
- HIVESDK_ProviderGooglePlayGamesDependencies.xml
- HIVESDK_ProviderHiveMembershipDependencies.xml
- HIVESDK_ProviderHuaweiDependencies.xml
- HIVESDK_ProviderLineDependencies.xml
- HIVESDK_ProviderQQDependencies.xml
- HIVESDK_ProviderRecaptchaDependencies.xml
- HIVESDK_ProviderSingularDependencies.xml
- HIVESDK_ProviderVKDependencies.xml
- HIVESDK_ProviderWechatDependencies.xml
- HIVESDK_ProviderWeverseDependencies.xml
- HIVESDK_PushAmazonAdmDependencies.xml
- HIVESDK_PushGoogleFcmDependencies.xml
Android¶
Unity Android에서 Hive SDK 각 제품을 설치하는 방법을 안내합니다.
Android Resolver 설정¶
Unity를 실행해 Asset > External Dependency Manager > Android Resolver > Settings 메뉴를 클릭합니다.
Android Resolver Settings 창이 나타나면 빨간색으로 표시한 항목을 기본 설정으로 체크합니다.
Copy and patch settingsTempalte.gradle from 2022.2 항목은 Unity 2022.2 이상 버전에서만 체크하세요. Use Jetifier 기능은 Hive SDK에서 자동 지원하므로 선택 해제를 권장합니다.
Unity 최신 버전에서 Use Jetifier를 선택하면 Unity 가이드에 따라 Custom Gradle Properties Template을 생성해야 합니다.
Hive Dependencies 설정¶
Hive Dependencies에서 Hive SDK가 제공하는 서비스를 활성화 또는 비활성화할 수 있습니다. Hive > Hive Dependencies (ExternalDependency)를 선택합니다.
설정 창이 나타나면 사용하려는 Hive 기능을 선택하세요. 예를 들어, Google 인증과 Google Play Store 결제 기능을 사용하려면 Auth Settings에서 Google Signin을, Market Settings에서 Google PlayStore를 선택합니다. 사용할 기능 선택 후 Save를 누르면 기능 선택을 완료합니다.
Hive Module Settings
| 기능 | 설명 |
|---|---|
| Promotion | 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공합니다. |
| Google InAppReview | Google Play 리뷰를 남길 수 있는 기능을 제공합니다. (Android) |
| Device Management | 유저가 등록한 기기에 한하여 게임 진입을 허용하게 하는 서비스 입니다. |
| Real Name Verification | 중국에서 접속한 유저가 실명 인증을 할 수 있는 기능을 제공합니다. |
| Hercules | Hive 플랫폼 게임을 대상으로한 게임 어뷰징 탐지 및 추적 기능 서비스를 제공합니다. |
| reCAPTCHA | Google reCAPTCHA를 사용하여 로봇인지 여부를 판단하여 계정 생성을 제어하는 기능을 제공합니다. |
| DataStore | 게임에서 발생하는 데이터를 key-value 형식으로 간단하게 저장 및 읽기 가능한 저장소를 제공하는 서비스 입니다. |
| Google InAppUpdate | 앱을 종료하지 않고 백그라운드에서 앱을 업데이트할 수 있는 기능을 제공합니다. (Android) |
| Analytics Consent-Mode | 개인정보 수집 동의 여부를 체크할 수 있는 동의 배너 노출 기능을 제공합니다. |
| Match Making | 게임 사용자들이 함께 게임을 할 수 있도록 연결해주는 매칭 기능을 제공합니다. |
| Chat | 실시간 채팅, 그룹 채팅, 1:1 채팅 등 사용자 간 채팅 기능을 제공합니다. |
Auth Settings
| 기능 | 설명 |
|---|---|
| Hive Membership | 'Hive로 로그인' IdP를 제공합니다. |
| Google SignIn | 'Google로 로그인' IdP를 제공합니다. |
| Google Play Games | 'Google Play로 로그인' IdP를 제공합니다. (Android) |
| 'Facebook으로 로그인' IdP를 제공합니다. | |
| Apple GameCenter | 'Game Center로 로그인' IdP를 제공합니다. (iOS) |
| Apple SignIn | 'Apple로 로그인' IdP를 제공합니다. |
| Line | 'LINE으로 로그인' IdP를 제공합니다. |
| VK | 'VK로 로그인' IdP를 제공합니다. |
| 'QQ로 로그인' IdP를 제공합니다. | |
| 'Wechat으로 로그인' IdP를 제공합니다. | |
| Weverse | 'Weverse로 로그인' IdP를 제공합니다. |
| Steam | 'Steam으로 로그인' IdP를 제공합니다. |
| X | 'X로 로그인' IdP를 제공합니다. |
| Telegram | 'Telegram으로 로그인' IdP를 제공합니다. |
| Huawei | 'Huawei로 로그인' IdP를 제공합니다. (Android) |
Push Settings
| 기능 | 설명 |
|---|---|
| Google FCM | Firebase Cloud Messaging 노티피케이션 기능을 제공합니다. (Android) |
| Apple APNs | Apple Push Notification Service 기능을 제공합니다. (iOS) |
| Amazon ADM | Amazon Device Messaging 노티피케이션 기능을 제공합니다. (Android) |
Market Settings
| 기능 | 설명 |
|---|---|
| Google PlayStore | Google PlayStore 빌링 기능을 제공합니다. (Android) |
| Apple AppStore | Apple AppStore 빌링 기능을 제공합니다. (iOS) |
| OneStore | OneStore 빌링 기능을 제공합니다. (Android) |
| Amazon ADM | Amazon AppStore 빌링 기능을 제공합니다. (Android) |
| Lebi | Lebi 빌링(중국) 기능을 제공합니다. (Android) |
| Hive Store | PG 결제 기능을 제공합니다. (Android) |
| Samsung GalaxyStore | Samsung GalaxyStore 빌링 기능을 제공합니다. (Android) |
| Huawei AppGallery | Huawei AppGallery 빌링 기능을 제공합니다. (Android) |
Analytics Settings
| 기능 | 설명 |
|---|---|
| Adjust | Adjust를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Airbridge | Airbridge를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| AppsFlyer | AppsFlyer를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Singular | Singular를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Firebase | Firebase를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
iOS¶
Unity iOS에서 Hive SDK 각 제품을 설치하는 방법을 안내합니다.
CocoaPods 설치¶
먼저 CocoaPods을 설치합니다. Unity를 실행해 Asset > External Dependency Manager > iOS Resolver > Install CocoaPods 메뉴를 클릭합니다.
CLI(Bash-shell)로도 설치할 수 있습니다.
실행 결과가 아래와 같이 나타나면 설치 완료입니다.
iOS Resolver 설정¶
다음으로, CocoaPods 설정을 합니다. CocoaPods으로 iOS에서 사용하는 외부 라이브러리를 제공받을 경우 기존 .xcodeproj 파일의 확장자를 .xcworkspace로 변경해 제공합니다. .xcworkspace 형태로 빌드를 진행할 수 없다면 GUI를 이용해 설정을 변경해보세요. 빌드할 PC의 Unity에서 수행하는 CocoaPods 적용 방식이 변경되어 실행할 수 있습니다.
-
Unity를 실행해 Asset > External Dependency Manager > iOS Resolver > Settings 메뉴를 클릭합니다.
2. iOS Resolver Settings 창이 나타나면 Cocoapods Integration 항목을 .xcworkspace로 설정하고, 프레임워크를 강제로 정적 방식으로 참조하지 않도록 Link framework statically를 체크 해제합니다.
Hive Dependencies 설정¶
Hive Dependencies에서 Hive SDK가 제공하는 서비스를 활성화 또는 비활성화할 수 있습니다. Hive > Hive Dependencies (ExternalDependency)를 선택합니다.
설정 창이 나타나면 사용하려는 Hive 기능을 선택하세요. 예를 들어, Google 인증과 Apple AppStore 결제 기능을 사용하려면 Auth Settings에서 Google Signin을, Market Settings에서 Apple AppStore를 선택합니다. 사용할 기능 선택 후 Save를 누르면 기능 선택을 완료합니다.
Hive Module Settings
| 기능 | 설명 |
|---|---|
| Promotion | 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공합니다. |
| Google InAppReview | Google Play 리뷰를 남길 수 있는 기능을 제공합니다. (Android) |
| Device Management | 유저가 등록한 기기에 한하여 게임 진입을 허용하게 하는 서비스 입니다. |
| Real Name Verification | 중국에서 접속한 유저가 실명 인증을 할 수 있는 기능을 제공합니다. |
| Hercules | Hive 플랫폼 게임을 대상으로한 게임 어뷰징 탐지 및 추적 기능 서비스를 제공합니다. |
| reCAPTCHA | Google reCAPTCHA를 사용하여 로봇인지 여부를 판단하여 계정 생성을 제어하는 기능을 제공합니다. |
| DataStore | 게임에서 발생하는 데이터를 key-value 형식으로 간단하게 저장 및 읽기 가능한 저장소를 제공하는 서비스 입니다. |
| Google InAppUpdate | 앱을 종료하지 않고 백그라운드에서 앱을 업데이트할 수 있는 기능을 제공합니다. (Android) |
| Analytics Consent-Mode | 개인정보 수집 동의 여부를 체크할 수 있는 동의 배너 노출 기능을 제공합니다. |
| Match Making | 게임 사용자들이 함께 게임을 할 수 있도록 연결해주는 매칭 기능을 제공합니다. |
| Chat | 실시간 채팅, 그룹 채팅, 1:1 채팅 등 사용자 간 채팅 기능을 제공합니다. |
Auth Settings
| 기능 | 설명 |
|---|---|
| Hive Membership | 'Hive로 로그인' IdP를 제공합니다. |
| Google SignIn | 'Google로 로그인' IdP를 제공합니다. |
| Google Play Games | 'Google Play로 로그인' IdP를 제공합니다. (Android) |
| 'Facebook으로 로그인' IdP를 제공합니다. | |
| Apple GameCenter | 'Game Center로 로그인' IdP를 제공합니다. (iOS) |
| Apple SignIn | 'Apple로 로그인' IdP를 제공합니다. |
| Line | 'LINE으로 로그인' IdP를 제공합니다. |
| VK | 'VK로 로그인' IdP를 제공합니다. |
| 'QQ로 로그인' IdP를 제공합니다. | |
| 'Wechat으로 로그인' IdP를 제공합니다. | |
| Weverse | 'Weverse로 로그인' IdP를 제공합니다. |
| Steam | 'Steam으로 로그인' IdP를 제공합니다. |
| X | 'X로 로그인' IdP를 제공합니다. |
| Telegram | 'Telegram으로 로그인' IdP를 제공합니다. |
| Huawei | 'Huawei로 로그인' IdP를 제공합니다. (Android) |
Push Settings
| 기능 | 설명 |
|---|---|
| Google FCM | Firebase Cloud Messaging 노티피케이션 기능을 제공합니다. (Android) |
| Apple APNs | Apple Push Notification Service 기능을 제공합니다. (iOS) |
| Amazon ADM | Amazon Device Messaging 노티피케이션 기능을 제공합니다. (Android) |
Market Settings
| 기능 | 설명 |
|---|---|
| Google PlayStore | Google PlayStore 빌링 기능을 제공합니다. (Android) |
| Apple AppStore | Apple AppStore 빌링 기능을 제공합니다. (iOS) |
| OneStore | OneStore 빌링 기능을 제공합니다. (Android) |
| Amazon ADM | Amazon AppStore 빌링 기능을 제공합니다. (Android) |
| Lebi | Lebi 빌링(중국) 기능을 제공합니다. (Android) |
| Hive Store | PG 결제 기능을 제공합니다. (Android) |
| Samsung GalaxyStore | Samsung GalaxyStore 빌링 기능을 제공합니다. (Android) |
| Huawei AppGallery | Huawei AppGallery 빌링 기능을 제공합니다. (Android) |
Analytics Settings
| 기능 | 설명 |
|---|---|
| Adjust | Adjust를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Airbridge | Airbridge를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| AppsFlyer | AppsFlyer를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Singular | Singular를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
| Firebase | Firebase를 통한 마케팅 어트리뷰션 기능을 제공합니다. |
Windows¶
Windows 패키지를 불러온 후에는 별도 설정이 필요하지 않습니다.
Info
Hive SDK 각 기능(인증, 빌링, 노티피케이션, ...)에 관한 자세한 내용은 각 기능 가이드를 참고하세요.