Unreal Engine 5

사용할 Hive SDK 기능을 외부 라이브러리 형태로 추가합니다. Hive SDK는 인증, 결제, 푸시 알림, 광고 배너 등 다양한 기능을 제공하며, 개발자는 이중에서 사용할 기능만을 골라 설치해야 합니다. 여기에서는 가장 기본적인 기능인 인증과 결제 기능을 사용하는 예시를 안내합니다.

사용할 기능 선택¶

사용할 기능만 선택하여 적용하려면, 다음 안내를 따르세요.

1. Unreal Editor의 메뉴에서 Edit > Project Settings을 클릭하세요. Project Settings 창이 나타납니다.

2. Project Settings 창의 좌측 패널에서 Hive SDK 하위의 Dependency – Android / Dependency – iOS를 각 클릭하세요.

   

3. 우측의 Hive SDK Dependency – Android / Dependency – iOS 각 화면에서 사용할 기능에 대한 라이브러리 의존성을 선택하세요. 예를 들어, Android 환경에서 Google 인증과 Google Play Store 결제만 사용하려면 Auth 항목에서 Enable Google Sign-in만을 체크하고, Market 항목에서 Market을 Google Play Store로 지정합니다. Unreal iOS 환경에서는 Market에서 Enable Apple AppStore를 체크합니다.

추가 설정¶

Hive SDK 기능 설치를 위해 추가로 필요한 설정을 안내합니다.

Android¶

각 Hive SDK 기능 사용을 위한 Android 환경 설정을 안내합니다.

Unreal Engine 내장 Google Billing 비활성화¶

Google Play Store 결제 사용 시, Hive SDK에서 사용하는 Google Billing Library 최신 버전과 언리얼 엔진에 내포된 Google Billing 기능 사이에 호환성 문제가 존재하여 빌드가 실패합니다. 정상 빌드를 위해 아래 코드를 수정하세요.

1. /Engine/Plugins/Online/Android/OnlineSubsystemGooglePlay/Source/OnlineSubsystemGooglePlay.Build.cs로 이동하세요.

2. 다음 코드를 주석 처리합니다.

   //string PluginPath = Utils.MakePathRelativeTo(ModuleDirectory, Target.RelativeEnginePath);
   //AdditionalPropertiesForReceipt.Add("AndroidPlugin", Path.Combine(PluginPath, "OnlineSubsystemGooglePlay_UPL.xml"));
   

3. Unreal Engine 5.4.4+ 버전을 사용하는 경우, 엔진 내 포함된 OnlineSubsystemGooglePlay 모듈이 제거되지 않는 현상이 있습니다. 따라서 아래와 같은 설정이 필요합니다.

4. Engine/Plugins/Online/Android/OnlineSubsystemGooglePlay/Source/Java/com/epicgames/unreal/GooglePlayGamesWrapper.java 파일 제거

5. Engine/Plugins/Online/Android/OnlineSubsystemGooglePlay/Source/OnlineSubsystemGooglePlay_UPL.xml 파일 내용 전체를 아래와 같이 수정

   xml <?xml version="1.0" encoding="utf-8"?> <root xmlns:android="http://schemas.android.com/apk/res/android"/>

iOS¶

Unreal iOS에서 Hive SDK 기능별 설치를 위한 별도 설정은 없습니다.

Windows¶

Unreal Windows에서 Hive SDK 기능별 설치를 위한 별도 설정은 없습니다.