Unreal - NHN Cloud 使用ガイド

Game > Gamebase > リリースノート > Unreal

2.70.0 (2025. 3. 11.)

SDK Download

기능 추가

로그인 시 IdP 서버로부터 에러가 발생했음을 나타내는 신규 에러 코드가 추가되었습니다.
- AUTH_AUTHENTICATION_SERVER_ERROR(3012)
WebView에 네비게이션 바 title 컬러와 icon tint 컬러 설정 옵션을 추가했습니다.
- FGamebaseWebViewConfiguration::NavigationBarTitleColor
- FGamebaseWebViewConfiguration::NavigationBarIconTintColor
(Android) 'GPGS 자동 로그인' 기능 연동시 유저에게 GPGS 로그인을 앱 설치 후 한번만 물어보는 초기화 옵션을 추가했습니다.
- FGamebaseConfiguration::bEnableGPGSSignInCheck
- 기본 설정은 true로, 유저가 GPGS 로그인을 거부하더라도 Gamebase 초기화 때 GPGS 로그인 창을 다시 표시합니다.
- false로 설정하면 앱 최초 실행시에만 GPGS 로그인 창이 한번 표시됩니다.

기능 개선/변경

내부 로직을 개선하였습니다.

버그 수정

(Windows) 로그인 시 FGamebaseVariantMap로 추가 정보를 받는 경우 크래시가 발생하지 않도록 수정했습니다.

플랫폼별 변경 사항

2.69.1 (2025. 3. 4.)

SDK Download

기능 추가

런칭 정보에서 약관 정보를 확인할 수 있도록 추가했습니다.
- FGamebaseLaunchingInfo::FApp::FTermsService

기능 개선/변경

API 호출 시 매개변수로 전달받는 UGamebaseJsonObject를 FGamebaseVariantMap(TMap<FName, FVariant>)으로 변경했습니다.
내부 로직을 개선하였습니다.

버그 수정

(Windows) 게스트 로그인 시 UUID 발급 과정 오류로 인해 모두 동일한 값이 생성되는 문제를 수정했습니다.
(Windows) Line IDP 로그인 시 region 설정이 동작하지 않는 문제를 수정했습니다.
(Windows) 킥아웃 시 ServerPushAppKickOut 이벤트 발생과 팝업이 노출되지 않는 문제를 수정했습니다.
(Windows) 심볼 생성 시 엔진의 Build Configuration이 Development가 아닌 경우 오류가 발생하는 문제를 수정했습니다.
(Android) 환경에 따라 RegisterPush가 동작하지 않는 문제를 수정했습니다.

플랫폼별 변경 사항

2.69.0 (2025. 2. 11.)

SDK Download

機能追加

RequestLastLoggedInProvider非同期APIを追加しました。
- GetLastLoggedInProvider()同期APIがタイミング上、正常な値を返せない場合があります。
- (Android) GPGSのAuto Login機能を使用する場合、GPGSサーバーからデータを取得する時間が必要なため、Gamebase初期化直後にGetLastLoggedInProvider()同期APIを呼び出すと正常な値を取得できません。この時、RequestLastLoggedInProvider非同期(GamebaseDataCallback<String>)非同期APIは正確な値を保証します。 Auto Loginを使用しない場合は、GetLastLoggedInProvider()同期APIを使用しても構いません。
(Android) GPGS v2認証を追加しました。
- 詳細は以下のリンクを参照してください。
  - Game > Gamebase > Unreal SDK使用ガイド > はじめる > Android Settings
(Android) FGamebaseWebViewConfiguration::CutoutColorフィールドを追加しました。
- GamebaseWebViewの FGamebaseWebViewConfiguration::bRenderOutSideSafeAreaフィールドをfalseに設定した場合、cutout領域に自動的にpadding余白を追加します。
- CutoutColorフィールドは、このように追加されたpadding領域の色を設定できます。
- RenderOutsideSafeAreaフィールドをfalseに設定したが、CutoutColorフィールドは設定しない場合にはWebページ'body'の'background-color'値で自動的にpadding領域の色を決定します。

機能改善/変更

内部ロジックを改善しました。

バグ修正

約款照会結果APIであるFGamebaseQueryTermsResultを修正しました。
- TermsCountryTypeの値が設定されない問題を修正しました。
- bPushEnabled, bAdAgreement, bAdAgreementNightを削除しました。
(Android) Windows環境でビルド時、ポストビルドプロセスでエラーが発生しないように修正しました。

プラットフォーム別の変更事項

2.68.1 (2025. 01. 21.)

SDK Download

機能改善/変更

内部ロジックを改善しました。
(Windows) WebViewプラグインをオプションで選択できるように変更しました。
- 詳細は以下のリンクを参照してください。
  - Game > Gamebase > Unreal SDK使用ガイド > はじめる > Windows Settings > WebViewプラグイン案内
(Windows)クラッシュログを送信する際に、プロジェクトバイナリパスにシンボルファイルを圧縮したファイルが作成されるように追加されました。
- 詳細は以下のリンクを参照してください。
  - Game > Gamebase > Unreal SDK使用ガイド > Logger > Crash Reporter

バグ修正

(Windows)内部ログ送信時にクラッシュが発生する可能性があるロジックを修正しました。

プラットフォーム別の変更事項

2.68.0 (2024. 12. 10.)

SDK Download

機能改善/変更

内部ロジックを改善しました。
(Windows) Twitter認証方式をOAuth 2.0に変更し、以下の設定を変更しないとログインが動作しません。
- OAuth 2.0 Client ID及びClient Secret発行
  - Twitter Developer PortalでOAuth 2.0 Client IDとClient Secretを作成した後、 Gamebaseコンソールに登録します。
- Callback URL設定
  - GamebaseコンソールにCallback URL(https://id-gamebase.toast.com/oauth/callback)を設定します。
  - 同じCallback URLをTwitter Developer Portalに追加します。
- 詳細は次のリンクを参照してください。
  - Game > Gamebase > コンソール使用ガイド > アプリ > Authentication Information

バグ修正

(Windows)決済プロセスでクラッシュが発生しないように修正しました。
(Windows)Steam決済中にESCキーで決済を終了した場合、次の決済APIが動作しない問題を修正しました。

プラットフォーム別の変更事項

2.67.2 (2024. 11. 26.)

SDK Download

機能改善/変更

内部ロジックを改善しました。

バグ修正

(Windows) Apple IDのログインが正常に行われない問題を修正しました。

プラットフォーム別の変更事項

2.67.1 (2024. 11. 14.)

SDK Download

機能改善/変更

(Windows)Purchase設定時にストアを一つだけ選択できるように変更しました。
- ストア再設定が必要です。
(Windows) Epic Games Storeを使用する場合、EOS SDKのハンドルを登録するプロセスを変更しました。
- Online Subsystem EOSを使用する場合、Gamebase初期化時にStoreCodeがEpic Games Storeの該当する値であれば自動的にハンドルを登録します。
- Online Subsystem EOSを使用しない場合は、Windows Settingsガイドを参照してEOSのハンドルを登録する必要があります。
(Windows) Steamworks SDKサポートバージョンが1.59に変更されました。
- 詳細は以下のリンクを参照してください。
  - Game > Gamebase > Unreal SDK使用ガイド > はじめに > Windows Settings > Steamworksサービス

バグ修正

ヘッダファイルを正常に参照できるように修正しました。
(Windows)初初期化を複数回試行する際にクラッシュが発生しないように修正しました。
(Windows)初期化時にStoreCodeがSteamまたはEpic Games Storeに該当するコードを入力するとクラッシュが発生しないように修正しました。
(Windows)外部ブラウザでログインしようとするとクラッシュが発生する可能性があるロジックを修正しました。

プラットフォーム別の変更事項

2.67.0 (2024. 10. 30.)

SDK Download

機能追加

Steam認証を追加しました。
Stema決済を追加しました。
画像告知機能に新規タイプを追加しました。
- ローリングポップアップタイプを追加しました。
- 既存の画像告知はポップアップタイプで表示され、Windowsではサポートされません。
(Windows) LINE認証を追加しました。

機能改善/変更

エンジンのサポートバージョンを4.27〜5.4に変更しました。
内部ロジックを改善しました。

バグ修正

クラッシュログ発生時にクラッシュが発生する可能性があるロジックを修正しました。

プラットフォーム別の変更事項

2.66.1 (2024. 09. 10.)

SDK Download

機能改善/変更

内部ロジックを改善しました。

プラットフォーム別の変更事項

2.66.0 (2024. 08. 27.)

SDK Download

機能改善/変更

APIの使用方法を変更しました。
- IModuleInterfaceを継承したIGamebaseで提供していたAPIをUGameInstanceSubsystemを継承したUGamebaseSubsytemで提供するように変更しました。
- UGamebaseSubsytemはGameInstanceのサブシステムであるため、GameInstanceライフサイクルに従い、SDK API呼び出し時に使用するGameInstanceを通じて該当サブシステムを検索してAPIを使用する必要があります。
GamebaseInterfaceモジュールが削除されました。 Gamebaseプラグイン使用時GamebaseInterfaceモジュールを削除してから使用してください。
(Windows) GameInstanceが複数ある環境で使用できます。

プラットフォーム別の変更事項

2.64.0 (2024. 06. 11.)

SDK Download

機能改善/変更

内部ロジックを改善しました。

バグ修正

C++環境によって警告が発生し、ビルド時にエラーが発生するコードを修正しました。
(Android) ProGuard宣言が抜けていてAPI呼び出し時にエラーが発生する内容を修正しました。

プラットフォーム別の変更事項

2.63.0 (2024. 04. 23.)

SDK Download

機能追加

(Android) Firebase Notificationの設定方法が変更され、プラグイン内でgoogle-services-json.xmlファイルを修正するのではなく、Android設定ツールでgoogle-services.jsonファイルのパスを指定するように変更されました。
(iOS) Gamebase Unreal SDKにPrivacy manifestと署名を適用しました。

機能改善/変更

(iOS)ビルド時にエラーが発生しないように修正しました。

プラットフォーム別の変更事項

2.62.0 (2024. 03. 26.)

SDK Download

機能追加

(iOS) Gamebase SDK内部iOSフレームワークにPrivacy manifestと署名を適用しました。

機能改善/変更

内部ロジックを改善しました。

プラットフォーム別の変更事項

2.60.0 (2024. 02. 15.)

SDK Download

機能改善/変更

内部ロジックを改善しました。

プラットフォーム別の変更事項

2.58.0 (2023. 11. 28.)

SDK Download

バグ修正

(Windows)サーバープッシュが動作しない問題を修正しました。
初期化時にクラッシュが発生する可能性があるロジックを修正しました。

プラットフォーム別の変更点

2.57.0 (2023. 11. 14.)

SDK Download

機能追加

Windowsプラットフォームのサポートを追加
- Windows設定ツールが追加されました。
- プラットフォームでサポートするAPIは、各文書のUNREAL_WINDOWS項目をご確認ください。

プラットフォーム別の変更点

2.56.0 (2023. 10. 17.)

SDK Download

機能追加

Android設定ツールでストア設定が追加されました。
- Amazon Appstore、Huawei AppGallery、MyCardの選択が追加されました。
- ONE Storeを選択した場合、ストアのバージョン選択オプションが追加されました。
iOS設定ツールでNaver IdP設定が追加されました。
(Android) LoginForLastLoggedInProvider呼び出し中にローディングアニメーションを非表示にするオプションを指定できる新規APIが追加されました。
- LoginForLastLoggedInProvider(const UGamebaseJsonObject& additionalInfo、const FGamebaseAuthTokenDelegate& onCallback)
- API呼び出し方法は、次のガイド文書を参照してください。
  - Game > Gamebase > Unreal SDK使用ガイド > 認証 > Login > Login Flow > Login as the Latest Login IdP
(Android) Android 13以上のOSでRegisterPush APIを呼び出した時、Push権限リクエストポップアップが自動的に表示されないようにするFGamebasePushConfiguration.requestNotificationPermissionフィールドが追加されました。
(iOS)ユーザーがプッシュ権限を拒否してもトークンを登録できるようにFGamebasePushConfiguration.alwaysAllowTokenRegistrationフィールドが追加されました。

機能改善/変更

提供されるタイプがUSTRUCTから一般構造体に変更されました。
- 結果として受け取るタイプは基本的に提供されない値の場合、Toptional形式で提供されます。

バグ修正

ログイン後、退会猶予情報および決済アビューズ自動解除情報が正常に伝達されるように修正しました。

プラットフォーム別の変更事項

2.49.1 (2023. 04. 14.)

SDK Download

バグ修正

(iOS)決済商品照会APIを呼び出す際、クラッシュが発生しないように修正しました。

プラットフォーム別の変更事項

2.49.0 (2023. 04. 11.)

SDK Download

機能追加

未消費履歴照会APIが変更され、新規APIに変更する必要があります。

// Deprecated API
void RequestItemListOfNotConsumed(const FGamebasePurchasableReceiptListDelegate& onCallback);
// New API
void RequestItemListOfNotConsumed(const FGamebasePurchasableConfiguration& Configuration, const FGamebasePurchasableReceiptListDelegate& onCallback);

有効化購読照会APIが変更され、新規APIに変更する必要があります。

既存APIと同じ結果を得るにはFGamebasePurchasableConfiguration.allStoresをtrueに設定する必要があります。

// Deprecated API
void RequestActivatedPurchases(const FGamebasePurchasableReceiptListDelegate& onCallback);
// New API
void RequestActivatedPurchases(const FGamebasePurchasableConfiguration& Configuration, const FGamebasePurchasableReceiptListDelegate& onCallback);

(Android) IAP購読状態を照会できるRequestSubscriptionsStatus APIが追加されました。
(Android) Webビューで固定フォントサイズを使用するかどうかを設定するフィールドを再サポートします。
- GamebaseWebViewConfiguration.enableFixedFontSize
(Android) Webビューでカットアウト(ノッチ)領域を含むすべての利用可能なスクリーンスペースを使用してレンダリングできる設定が追加されました。
- GamebaseWebViewConfiguration.renderOutsideSafeArea

機能改善/変更

Unrealの最小サポートバージョンが4.26に変更されました。
(iOS) Xcode 14.1でビルド時にエラーが発生する問題を修正しました。

プラットフォーム別の変更事項

2.43.3 (2022. 10. 04.)

SDK Download

機能改善/変更

LINEログインを行う時、サービスを提供するRegionを入力するように変更されました。
- Game > Gamebase > Unreal SDK使用ガイド > 認証 > Login with IdP

プラットフォーム別変更事項

2.42.1 (2022. 08. 09.)

SDK Download

機能追加

FGamebaseForcingMappingTicketクラスにマッピングユーザー状態を表すmappedUserValidフィールドが追加されました。
iOS設定ツールでXcodeのパスを指定できるようにXcode Path設定が追加されました。

機能改善/変更

キックアウトポップアップウィンドウを表示するかどうかはGamebaseコンソールでキックアウト登録時に設定できるため、次のフィールドは今後は使用しません。
- FGamebaseConfiguration.bEnableKickoutPopup
FGamebaseConfiguration内の一部フィールドにデフォルト値が追加されました。
- bEnableLaunchingStatusPopupのデフォルト値がtrueに設定されました。
- bEnableBanPopupのデフォルト値がtrueに設定されました。
FWebViewで固定フォントサイズを使用するかどうかを設定するフィールドは、今後は使用しません。
- FGamebaseWebViewConfiguration.enableFixedFontSize
FGamebaseWebViewConfiguratio内の一部フィールドに基本値が追加されました。
- ナビゲーションバーの色相フィールドであるcolorR、colorG、colorB、colorAのデフォルト値が18、93、230、255に設定されました。
- ナビゲーションバーの有効/無効を指定するフィールドであるisNavigationBarVisibleのデフォルト値がtrueに設定されました。
- Webビュー内の戻るボタンの有効/無効を指定するフィールドであるisBackButtonVisibleのデフォルト値がtrueに設定されました。

プラットフォーム別の変更事項

2.41.0 (2022. 07. 05.)

SDK Download

機能追加

GamebaseEventHandlerのGamebaseEventCategoryにIdPRevokedタイプが追加されました。
- Game > Gamebase > Unreal SDK使用ガイド > ETC > Additional Features > Gamebase Event Handler > IdP Revoked

プラットフォーム別の変更事項

2.40.1 (2022. 06. 14.)

SDK Download

バグ修正

クラッシュが発生することがあるロジックが修正されました。
(iOS)同じAPIを連続して呼び出すとき、コールバックが正常に伝達されない問題が修正されました。

2.40.0 (2022. 05. 24.)

SDK Download

機能追加

iOS設定ツールを提供します。
- 既存プロジェクト設定でGamebaseと表示されましたがアップデート後はGamebase - Android、Gamebase - iOSと表示されます。
- iOS設定ツールを提供し、ビルド時に必要なフレームワークのみ含まれるように修正しました。
共通約款API呼び出し後に約款UIが表示されたかどうかを知ることができるVOクラスが追加されました。
- FGamebaseShowTermsViewResult
端末で通知を許可したかどうかを知ることができるAPIが追加されました。
- UGamebaseSubsystem* Subsystem = UGameInstance::GetSubsystem(GetGameInstance()); Subsystem->GetPush().QueryNotificationAllowed()
約款が表示されたかどうかを知ることができるAPIが追加されました。
- UGamebaseSubsystem* Subsystem = UGameInstance::GetSubsystem(GetGameInstance()); Subsystem->GetTerms().IsShowingTermsView()
Webビューでナビゲーションバーを隠すことができるオプションが追加されました。
- FGamebaseWebViewConfiguration.isNavigationBarVisible
(Android) Webビューでフォントサイズを固定することができるオプションが追加されました。
- FGamebaseTermsConfiguration.enableFixedFontSize
(Android)約款ウィンドウで文字サイズを固定することができるオプションが追加されました。
- FGamebaseTermsConfiguration.enableFixedFontSize
決済時にプロモーションかどうかを知ることができるisPromotionフィールドが追加されました。
- FGamebasePurchasableReceipt.isPromotion
決済時にテスト決済かどうかを知ることができるisTestPurchaseフィールドが追加されました。
- FGamebasePurchasableReceipt.isTestPurchase
サポートURLの後ろにパラメータを追加できるように次のフィールドが追加されました。
- FGamebaseContactConfiguration.additionalParameters

機能改善/変更

API結果コールバック呼び出し時にGameThreadに切り替えて呼び出すように修正しました。
RequestActivatedPurchases API呼び出し時に内部で2回呼び出される問題が修正されました。
一部APIの名前が変更されました。
- FGamebaseAnalyticesLevelUpData → FGamebaseAnalyticsLevelUpData
- FGambaseBanInfoPtr → FGamebaseBanInfoPtr
キックアウトポップアップウィンドウを表示するかどうかは、Gamebaseコンソールでキックアウト登録時に設定できるため、次のフィールドは使用しなくなりました。
- FGamebaseConfiguration.enableKickoutPopup

各プラットフォームの変更事項

2.33.1 (2022. 02. 22.)

SDK Download

バグ修正

iOSビルド時に発生するエラーを修正しました。

2.33.0 (2022.01.25)

SDK Download

機能追加

「決済アビューズ自動解除」機能が追加されました。
- Game > Gamebase > Unreal SDK使用ガイド > 認証 > GraceBan
- 決済アビューズ自動解除機能は、決済アビューズ自動制裁で利用停止になるべきユーザーが「利用停止猶予状態」の場合に、設定した期間内に決済アビューズ解除条件を全て満たすと正常にプレイできます。
- 利用停止猶予状態の場合、設定した期間内に解除条件を全て満たすと正常プレイが可能になります。
- 期間内に条件を満たさなかった場合は利用が停止されます。
決済アビューズ自動解除機能を使用するゲームは、ログイン後に常にAuthToken.member.graceBanInfo API値を確認し、nullではない有効なGraceBanInfoオブジェクトをリターンした場合、該当ユーザーに利用停止解除条件、期間などを案内する必要があります。
- 利用停止猶予状態のユーザーのゲーム内アクセス制御はゲームで処理する必要があります。
強制マッピング時にIdPログインをもう一度行わなければいけない不便さを改善した新しい強制マッピングAPIが追加されました。
- Game > Gamebase > Unreal SDK使用ガイド > 認証 > Mapping > Add Mapping Forcibly
Gamebase.AddMapping()呼び出し後にAUTH_ADD_MAPPING_ALREADY_MAPPED_TO_OTHER_MEMBER(3302)エラーが発生した時、該当アカウントにログインすることができるAPIが追加されました。
- Game > Gamebase > Unreal SDK使用ガイド > 認証 > Mapping > Change Login with ForcingMappingTicket
GamebaseEventHandlerのGamebaseEventCategoryにGamebaseEventCategory::ServerPushAppKickOutMessageReceivedタイプが追加されました。
- このイベントの活用方法は次の文書を参照してください。
- Game > Gamebase > Unreal SDK使用ガイド > ETC > Additional Features > Gamebase Event Handler > Server Push
GamebaseEventHandlerのGamebaseEventCategoryにGamebaseEventCategory::LoggedOutタイプが追加されました。
- Gamebase Access Tokenの有効期限が切れてログインが必要なときに動作します。
- Game > Gamebase > Unreal SDK使用ガイド > ETC > Additional Features > Gamebase Event Handler > Logged Out
共通約款ウィンドウの設定を変更できる新規APIが追加されました。
- Game > Gamebase > Unreal SDK使用ガイド > UI > Terms > showTermsView

機能改善/変更

エラーコードの追加と変更
- GamebaseErrorCode::UNKNOWN_ERRORエラーにマッピングされたエラーコードを999から9999に変更しました。
- エラーコード999にマッピングしたGamebaseErrorCode::SOCKET_UNKNOWN_ERRORエラーを新たに追加しました。

プラットフォーム別の変更事項

2.26.1 (2021.11.23)

SDK Download

バグ修正

GamebaseDisplayLanguageCodeフィンランド語の誤字を修正
- Finish → Finnish

2.26.0 (2021.09.28)

SDK Download

機能追加

共通約款機能の追加
- 約款WebViewを開くAPIの追加
- 約款リストおよびユーザー別同意有無を照会するAPIを追加
- ユーザー別の約款同意有無をGamebaseサーバーに保存するAPIを追加

機能改善/変更

サポートのタイプがTOAST組織商品(Online Contact)の場合、ログインを行わなくてもサポートが表示されるように変更
内部ローンチURLの変更
GamebaseからAndroid multidexの適用削除

2.19.2 (2021.06.29)

SDK Download

バグ修正

イメージ告知ShowImageNotices API呼び出し時にonEventCallbackを登録していない場合、閉じるボタンを押した時にクラッシュが発生する問題を修正
Android設定ツール - Enable Hangame、Enable Weiboが正常に動作しない問題を修正

2.19.1(2021.02.09)

SDK Download

バグ修正

Unityビルド中に除外されるファイルが生じた時に発生するコンパイルエラーを修正

2.19.0 (2021.01.26)

SDK Download

機能追加

SDK配布：2.16.0～2.19.0累積した内容を反映
- Android設定ツール提供：Gamebase_Android_UPL.xmlファイルを修正する代わりに設定ツールを使用してください。
- サポート機能を追加
- 認証追加：Hangame、Weibo
- Galaxyストアを追加
- 決済アイテム情報にローカライズされた商品情報を追加：localizedTitle、localizedDescription
- Android設定ツールを提供
- Unreal 4.26サポート

2.15.0 (2020.10.27)

SDK Download

機能追加

Unreal SDK機能追加：SDK 2.15.0
- 既存のすべてのイベントシステムを統合するGamebaseEventHandlerを追加
  - ServerPush、Observer機能が含まれており、プロモーション決済イベントおよびプッシュイベントを確認可能
- API追加
  - 商品IDで決済をリクエストし、追加情報(UserPayload)を入力して決済完了時に確認できる決済APIを追加
  - イメージ告知表示：showImageNotices
  - Pushトークン情報確認：queryTokenInfo
- プッシュトークン登録時、NotificationOption設定でアプリがフォアグラウンド(foreground)状態でもプッシュ通知を受け取れるように機能を追加
- WebViewConfiguration contentMode設定を追加