AGS 3.80.0 リリースノート
This is an unsupported AGS version. AccelByte no longer provides any updates, bug fixes, security patches, or technical support for these versions. Please refer to the AGS Version Support Lifecycle document for more information.
注釈:本資料はAI技術を用いて翻訳されています。
リリース日: 2024年12月27日
バージョン
AccelByte Gaming Services (AGS) Game SDK
Extend SDK
AccelByte Multiplayer Servers (AMS) CLI
- AMS CLI: 0.245.31
ハイライト
-
Unreal Engine
-
🎉🎉 Play-In-Editor (PIE) サポートが導入されました 🎉🎉
AGS Unreal SDK アーキテクチャは、シングルインスタンスのシングルトンオブジェクトの集合から、独立した自己完結型の
AccelByteInstancesへと移行しました。複数の
AccelByteInstancesはオンデマンドで実体化でき、既存のアーキテクチャでのシングルインスタンスに限定されず、複数の Play-In-Editor (PIE) インスタンス、およびデバッグとテストのための多くの同時実行のヘッドレスインスタンスを実行するオプションが可能になりました。P2P サポートは 1 つのインスタンスのみに限定されており、改善予定です。auto AccelByteInstance = IAccelByteUe4SdkModuleInterface::Get().CreateAccelByteInstance();
if(!AccelByteInstance.IsValid())
{
return;
}FRegistryとFMultiRegistryは AGS バージョン 3.80 (2024.3.AGS) で非推奨としてマークされ、AGS バージョン 3.82 (2025.2.AGS) で削除される予定です。- AGS Unreal OSS ユーザーの場合、
AccelByteInstanceへの移行は舞台裏で行われます。 - AGS Unreal SDK ユーザーの場合、
FRegistryまたはFMultiRegistryからの移行パスを提供しており、ビルドの問題を回避するために開発者できるだけ早期にこれを採用することをお勧めします。
// OLD (3.79 以前)
auto ApiClient = FMultiRegistry::GetApiClient();
// NEW (3.80 以降)
auto ApiClient = AccelByteInstance->GetApiClient();Blueprint ユーザーの場合、
AccelByteInstanceおよびApiClientにAccelByteInstance経由でアクセスするための追加ノードを提供しています。開発者はできるだけ早期に Blueprint をレビューして更新することをお勧めします。そうしないとランタイムの問題が発生する可能性があります。 - AGS Unreal OSS ユーザーの場合、
-
オブジェクトライフタイムマネジメントを保証する新しい、堅牢で、スレッドセーフで、非同期に対応したAPI アクセスパターンが導入されています。
API アクセスを生ポインタから
WeakPtrに変更しました。コンパイル時の破損を回避するための一時的な緩和策を含めています。これらの緩和策は直ちに非推奨としてマークされ、AGS バージョン 3.82 (2025.2.AGS) で削除される予定です。開発者は新しいアクセスパターンへできるだけ早期に移行することをお勧めします。例:
// OLD (3.79 以前)
ApiClient->User.LoginWithDeviceId(...);
// NEW (3.80 以降)
auto User = ApiClient->GetUserApi().Pin();
if(User.IsValid())
{
User->LoginWithDeviceId(...);
} -
次の関数に新しいオプションの Team ID 変数が追加されました:
- ゲームセッション作成:
Session::CreateGameSession。 - ゲームセッション更新:
Session::UpdateGameSession。
- ゲームセッション作成:
-
セッション履歴:
SessionHistory::QueryGameSessionHistory。 -
Reporting::SubmitReportを呼び出すときの各レポートカテゴリに対する検証を改善しました。 -
新しいオンラインデリゲート
FOnlineChatAccelByte::OnSendChatCompleteWithErrorが追加されました。
-
-
Unity
-
次のインターフェイスが追加されました:
ServerApi.GetProfanityFilter()Api.GetUser().ValidateUserInput()interface詳細については、Profanity Filter ガイドを参照してください。
-
除外されたセッションをフィルタリングするサポートが追加されました。プレイヤーは、マッチメイキングチケットを作成するときに、再生されていない、または過去にプレイされたゲームセッションを除外することができます。この機能をサポートするために、
Api.GetSession().LeaveGameSession()のコールバックモデルを修正および設定しました。LeaveGameSession(string sessionId, ResultCallback callback)>LeaveGameSession(string sessionId, ResultCallback<SessionV2GameSession> callback);
詳細については、Record and exclude sessions ページを参照してください。
-
Api.GetChallenge().GetChallengeProgressレスポンスに新しいフィールドが追加されました:ChallengeRequirementProgressionResponse.MatcherChallengeRequirementProgressionResponse.ParameterNameChallengeRequirementProgressionResponse.ParameterTypeChallengeRequirementProgressionResponse.StatCycleId
-
-
Visual Debugger 用の Enhanced Service Logging が追加されました。
Enhanced Service Logging は、AGS との間の全受信および送信ネットワークトラフィックを含むようにログの詳細度を上げます。
- [Unreal Engine] コンソール変数
accelbyte.log.EnableServiceLogging経由でオン/オフを切り替えることができます。 - [Unity] この機能は、拡張サービスログ設定フラグから有効にできます。
注記この機能は 非配送ビルド でのみ利用可能です。
- [Unreal Engine] コンソール変数
-
GDPR準拠のサードパーティアカウント閉鎖が Xbox および Steam でサポートされるようになりました。
- GDPR に準拠するために、ユーザーアカウントがサードパーティプラットフォーム (Xbox や Steam など) で削除されると、ユーザーのデータは AGS 側でも削除されます。管理者は Xbox および Steam の設定を行うことで、AGS が上記プラットフォームで行われたアカウント閉鎖を同期させ、システム上で必要な削除を実行できるようになります。
- Admin Portal でこの機能にアクセスして使用する方法:
- Account Closures History: パブリッシャーまたはスタジオネームスペースで、Admin Tasks > GDPR > 3rd-Party Account Closure に移動します。
- Account Closure Configuration: パブリッシャーまたはスタジオネームスペースで、Game Setup > 3rd-Party Configuration > Account Closure に移動します。
-
Admin Portal に新しいタイムゾーン設定が追加されました。
- これにより、ローカルタイムゾーンまたは利用可能な UTC+ タイムゾーンのいずれかをアカウント用に選択できます。
- Admin Portal でこの機能にアクセスして使用する方法:
- My Account に移動して Preferences を選択します。
-
CPU 使用率に基づいて Extend アプリの水平自動スケーリングを構成します。
- CPU 使用率に基づいてスケーリングポリシーを構成して、リソース割り当てを微調整し、コストを削減できます。
- Admin Portal でこの機能にアクセスして使用する方法:
- パブリッシャーまたはスタジオネームスペースで、Extend アプリの詳細ページに移動します。詳細ページの右上で、3ドットメニューをクリックし、Settings > Auto Scaling Policy を選択します。
-
新しい使用可能な Extend アプリが導入されました: Vivox 認可サーバー。 詳細については、Sample - Vivox authentication service ページを参照してください。
-
チャレンジゴールに対して新しい 2 つの利用可能な要件が追加されました:
- チャレンジゴール用に 2 つの新しい要件が導入されました: Full Account および User Logs in with Third-party Account。
- Full Account 要件により、ゲーム管理者はプレイヤーがメールアドレスをアカウントに登録したかどうかを確認できます (フルアカウントにアップグレード)。
- User Login with 3rd Party Account により、ゲーム管理者はプレイヤーがサードパーティアカウントを使用してゲームにログインしたかどうかを確認できます。
- Admin Portal でこの機能にアクセスして使用する方法:
- Admin Portal サイドバーで、Engagement > Challenges > Configurations に移動します。
- 新しいチャレンジ構成を作成し、新しいチャレンジゴール要件を使用してゴールを作成します。
- REST API 経由でこの機能にアクセスする方法:
- Challenge/adminCreateGoal
- 必要な権限:
ADMIN:NAMESPACE:{namespace}:CHALLENGE [CREATE]
- 必要な権限:
- Challenge/adminUpdateGoals
- 必要な権限:
ADMIN:NAMESPACE:{namespace}:CHALLENGE [UPDATE]
- 必要な権限:
- Challenge/adminCreateGoal
- チャレンジゴール用に 2 つの新しい要件が導入されました: Full Account および User Logs in with Third-party Account。
重大な変更
- Unreal Engine
- [OSS] Unreal Engine 5.5 のサポートが追加されました。
Unreal Engine 5.5 のいくつかの変更には、AGS Unreal OSS への変更が必要です。これらの変更は、Unreal Engine 5.5 を使用している開発者のみに影響します。新しいデリゲート、パラメータ、メソッドの一覧は以下の通りです:
-
SessionInterface[BREAKING]
OnSessionParticipantsChangeおよびOnSessionParticipantRemovedデリゲートは Epic によって 5.2 で非推奨となり、5.5 で完全に削除されました。これらのデリゲートを使用するコードはOnSessionParticipantJoinedおよびOnSessionParticipantLeftを使用するように変換する必要があります。 -
IdentityInterface[BREAKING]
TokenTypeパラメータのないGetLinkedAccountAuthTokenは Epic によって 5.2 で非推奨となり、5.5 で削除されました。TokenTypeパラメータのあるオーバーロードを使用するように変換しました。 -
VoiceChat[BREAKING]
TransmitToSpecificChannelおよびGetTransmitChannelは Epic によって 5.3 で非推奨となり、5.5 で削除されました。TransmitToSpecificChannelsおよびGetTransmitChannelsメソッドを使用するように変換しました。
-
- [OSS] Unreal Engine 5.5 のサポートが追加されました。
Unreal Engine 5.5 のいくつかの変更には、AGS Unreal OSS への変更が必要です。これらの変更は、Unreal Engine 5.5 を使用している開発者のみに影響します。新しいデリゲート、パラメータ、メソッドの一覧は以下の通りです:
非推奨および廃止機能
-
Payment Callback Configuration
- Payment Callback Configuration 機能は、このリリースで非推奨となります。この機能の削除の期間については、利用可能になったら共有されます。
- この非推奨の結果:
- Commerce > Payment Callback Configuration ページは AGS Admin Portal から削除されました。
- 次のエンドポイントは非推奨ですが、機能し続けています。
-
Challenge Goal レスポンスモーダルの Schedule フィールド
- 最初に AGS バージョン 3.80 で計画された "Schedule" フィールドの非推奨化は、AGS バージョン 3.81 (2025.1) に延期されました。元のお知らせの詳細については、AGS バージョン 3.78 リリースノート を参照してください。
-
Unity SDK インターフェイス
-
AGS バージョン 3.77 リリースノート の以前の非推奨通知に続き、次のインターフェイスが削除されました:
SyncMobilePlatformPurchaseGoogle(syncRequest, callback)SyncMobilePlatformPurchaseApple(syncRequest, callback)
-
モバイル同期エンタイトルメントインターフェイスエクスペリエンスを改善するために作成された次のインターフェイスを使用してください:
SyncMobilePlatformPurchaseGoogle(orderId, packageName, productId, purchaseTime, purchaseToken, autoAck, optionalParameters, callback)SyncMobilePlatformPurchaseApple(transactionId, receiptData, optionalParameters, callback)
-
-
Unity
ServerApi.GetAgreement()API は AGS バージョン 3.80 (2024.3.AGS) で非推奨となり、AGS バージョン 3.84 (2025.4.AGS) で削除される予定です。契約および法務に関するすべての管理者サービスは Admin Portal からアクセスできます。詳細については、Manage legal documents ページを参照してください。
マイナー変更
Platform
- 新しい iapItemConfigUpdated API イベントが追加されました。これは、AGS 内課金 (IAP) アイテムのサードパーティプラットフォームとのマッピングが Admin Portal 経由で更新されたときに送信されます。
- deRevocation エンドポイントには、リクエストボディに requestId という新しいフィールドがあります。これは同じトランザクション ID の複数の失効を実行するときのべき等性をサポートするために使用されます。
IAM
- サードパーティサインアップオプションは、ワンタイムコードリンクフロー経由でサポートされるようになりました。また、ゲーム進行ピッカーへの UX 改善により、プレイヤーが正しい進行状況を識別および選択できるようになりました。
- Nonce は
idTokenクレームでサポートされるようになりました。
Admin Portal
- [AGS Private Cloud] ビジネスパートナー証明書の有効期限が Admin Portal の次のページの Business Partner Certificate フィールドの下または隣に表示されるようになりました:
- Foundations > 3rd Party Integraitons > Account Closure ページ
- Foundations > 3rd Party Integraitons > Store ページ
- Config Migration Error Handler を改善して、Import Confirmation ステップ中の依存関係に関連する問題を処理し、プロセスを再開する必要がないようにしました。
- ログイン許可リストに既に含まれているロールのチェックボックスが、Add Role フォームで (グレーアウトされているだけでなく) グレーアウトされてチェックされるようになり、選択できないことをより適切に示すようになりました。
- ネームスペース設定でゲーム名とステータスを更新するためのシステムパフォーマンスが改善されました。
- ネームスペースメニュー内の検索機能が改善されて、ネームスペース ID を使用した検索が可能になりました。
- Shared Cloud ユーザーの Usage & Billing ページの総残高の表示方法が改善され、小数点以下 2 桁のみが表示されるようになりました。
- Admin Portal がベーシックサービスからネームスペースリストをフェッチするキャッシュメカニズムが削除されました。
- Player Challenge Details ページおよび User Progression Detail モーダルにチャレンジゴール完了時刻およびリワード請求時刻の情報が追加されました。
- 最小 Stat サイクルオーバーライドと最大 Stat サイクルオーバーライドが正しく構成されていない場合に表示されるエラーメッセージが改善されました。
AMS
- ライブ専用サーバー (DS) からのログをダウンロードする機能が追加されました。
- フリート構成エクスペリエンスが簡潔化され、より直感的で改善されたインターフェイスが提供されるようになりました。
- 閲覧専用ユーザーの Admin Portal ユーザーエクスペリエンスが最適化されました。
App Editor
- Overlay Transparency フィールド名が、App Editor - Twitch Drop ページの Overlay Opacity に変更され、より明確になりました。
Challenges
- チャレンジおよびチャレンジゴールのスケジュールをチェックおよびリストするための新しいエンドポイントが導入されました。これらのエンドポイントは、ゴールレスポンス内の Schedule フィールドの廃止予定に対応するように設計されています。
- 2 つの新しい要件
userThirdPartyLoggedInおよびfullAccountがUSERACCOUNTパラメータ型に追加されました。
Cloud Save
- API エンドポイントの使用に関する推奨事項がAPI エンドポイントの説明に記載され、最適な利用とサービスパフォーマンスを確保するようになりました。
Inventory
- エンタイトルメントアイテムのスタッキングを管理するロジックが強化され、Inventory と Commerce サービス間の統合が改善されました。その結果、Inventory サービスはこれで将来の利用可能性を持つアイテムを処理し、期限切れアイテムを処理し、多様なソースからのエンタイトルメントを管理することがより適切に対応できるようになりました。
Login
- ログイン Web サイトは、Player Portal から独立してアカウントリンクロジックをサポートするようになりました。これには、ヘッドレスアカウントアップグレード、2FA、および既存または新規アカウントを使用したヘッドレスアカウントリンケージが含まれます。
Lobby
- メタデータキー属性への大文字と小文字を区別する検証が追加されました。他のプレイヤーへの友好招待リクエストを送信する際です。
Matchmaking
teamIDフィールドがゲームセッション構造に追加されました。
Player Portal
- Player Portal の URL での無効な言語コードの検出が改善されました。
Sessions
- Session サービスは
serverClaimed通知を カスタムソースの DS に送信するようになりました。 teamIDフィールドがゲームセッション構造に追加されました。OnSessionJoinedSecret通知が保存された通知に追加され、enableSecretオプションがtrueに設定されている DS 型セッションに参加するときにプレイヤーが受け取ります。- ゲームセッションを更新するときのゲームセッションバージョンの処理プロセスが改善されました。
- セッションが AMS のサーバー クレームに失敗したときに
OnSessionEnded通知が追加されました。 セッションを最後に離れたプレイヤーは、他のセッションメンバーのステータスの変更が通知されるようになりました。
TURN Manager
- TURN サーバーをスケールアップまたはスケールダウンするためのネットワークしきい値を設定するために、自動スケール構成に Bandwidth Threshold フィールドが追加されました。
Game SDK
- [Unreal Engine] マッチングをキャンセルした後、マッチメイキング キャンセル通知が受信されるまで、マッチメイキング検索ハンドルはリセットされません。
- [Unreal Engine]
FAccelBtyeModelsGameSessionExcludedSessionの誤字がFAccelByteModelsGameSessionExcludedSessionに修正されました。コンパイル時の破損を回避するため、Typedef が緩和策として含まれています。この緩和策は直ちに非推奨としてマークされ、AGS バージョン 3.82 (2025.2.AGS) で削除される予定です。 - [Unreal Engine]
FHttpRetryTaskデストラクタ内にバリデーション が追加され、バインドおよびアンバインドリクエストデリゲートが調整されました。
バグ修正
Platform
- 新しいアイテムを API 経由で作成された空のバンドルに追加できない問題が修正されました。
- Xbox および Microsoft Clawback サービス統合に時間がかかったり、失敗したりする問題が修正されました。
IAM
- Foundations > Users ページでの不正な Xbox プラットフォームユーザー ID が修正されました。
Admin Portal
- 新しいゲームネームスペース名を入力するとき、またはゲームネームスペース名を更新するときに表示されるツールチップに、正しい入力制限が表示されるようになりました。
- Agreement Records メニューが Shared Cloud ユーザーに対して正しく表示されるようになりました。
- Draft Store テーブルが Status フィルタを適用するときに 404 エラーを返す問題が修正されました。
- 検索履歴が LastPass エクステンション ドロップダウンによってブロックされる問題が修正されました。
- Custom Features の下でモジュールをクリックしても、その最初のサブモジュールが自動的に開かないという問題が修正されました。
- Admin Portal で使用される重要な NPM パッケージがセキュリティ脆弱性に対処するために更新されました。
- 週次チャレンジのチャレンジリセット日が誤って表示される問題が修正されました。
- 特定の入力フィールドで複数の文字を入力した後、Admin Portal がフリーズする問題が修正されました。この問題は、複雑な正規表現が壊滅的なバックトラッキングをトリガーしたためです。
- Delete Inventory ボタンの配置が修正されました。
- チャレンジゴール構成中に新しい Stat コードが選択された後、Stat cycle フィールドがリフレッシュされない問題が修正されました。
- Escape キーを使用するときに Challenge Preview ページが閉じられない問題が修正されました。
- Shared Cloud ユーザーの Admin Portal の User Management ページから Challenge タブが不足していた問題が修正されました。
- ゲーム管理者が開始時刻から 1 時間以上先のチャレンジリセット時刻を設定できない問題が修正されました。
Legal (Agreements)
- bulkAcceptVersionedPolicy エンドポイントが応答に長時間かかる問題が修正されました。
AMS
- AGS ドキュメントへの壊れたリンクが修正されました。
- フリート サーバーの設定リストの API レスポンスにファイル作成日付の情報が不足していた問題が修正されました。
- ステータスでフィルタリングされた場合、フリート サーバーの履歴が正確なデータを返さない問題が修正されました。
Analytics
- 複数のコネクタ (つまり
connector-v1およびconnector-v2) を使用する環境で S3 ファイルが破損する問題が修正されました。 - GameSight での JSON 解析エラーの問題が修正されました。
Challenges
- 固定チャレンジが、期間にセットゴールがない場合に次の回転期間に進めない問題が修正されました。チャレンジが前の期間に戻すことができました。現在、固定チャレンジは、セットゴールのない回転期間に進むことができます。
Extend
- 再展開された Extend アプリから環境変数がない問題が修正されました。
- イメージ脆弱性スキャン結果メッセージがスキャン結果に合わせられました。
Inventory
- Inventory サービスが大文字を含むスロット ID を生成する問題が修正されました。
Matchmaking
- ゲームセッションが大文字と小文字を区別する検証なしで同じキー属性を持つことができた問題が修正されました。
- マッチメイキングプロセスで、マッチメイキングレート (MMR) およびレイテンシウェイトが Match Ruleset で定義されていない問題が修正されました。
Player Portal
- プレイヤーが $ シンボルを含む表示名を更新できない問題が修正されました。
theuniqueDisplayNameenvar が有効な場合、Validation エンドポイントが Player Portal によって呼び出されない問題が修正されました。- Legal ページで、法的グループ内の別のドキュメントを選択するとつねに最初の国にリダイレクトされるという問題が修正されました。
- 新しいバージョンバナーがユーザーメール検証バナーで非表示にされた場合の表示バグが修正されました。
- プレイヤーが既に所有しているエンタイトルメント用のリディームコードを入力するときに不正なエラーメッセージが表示される問題が修正されました。
USERNAME_DISABLEDenvar がTRUEに設定されている場合に、My Profile ページの Save changes ボタンが常にグレーアウトされる問題が修正されました。- アカウント作成中に特定の言語が選択されたにもかかわらず、新しく作成されたアカウントがデフォルトで誤った言語に設定される問題が修正されました。
- コンテンツスクリーンおよびプロフィールアグリーメントレコードでネームスペース名の代わりにネームスペース ID が表示される問題が修正されました。
- Player Portal が法的ドキュメントページで HTML コンテンツをレンダリングできなかった表示の問題が修正されました。
- AccelByte Publishing Toolkit (APT) サービスで使用される重要な NPM パッケージがセキュリティ脆弱性に対処するために更新されました。
Sessions
- プレイヤーのステータスが DROPPED に変更されたときにネイティブセッション同期がトリガーされない問題が修正されました。
- ゲームセッションが大文字と小文字を区別する検証なしで同じキー属性を持つことができた問題が修正されました。
Game SDK
- [Unreal Engine] WebSocket 切断が再接続を試みる前に完了することを確認しました。
- [Unreal Engine][OSS] 再接続成功後、
FUserOnlineAccountAccelByteの Lobby 接続状態が正しいことを確認しました。 - [Unreal Engine] 高レベル WebSocket ティアダウン時に低レベル WebSocket ライブラリが閉じられることを確認しました。
- [Unreal Engine] Linux サーバービルドでのインクルードヘッダー不足によるコンパイルエラーが修正されました。
- [Unity]
Api.GetChallenge().GetChallengeProgressレスポンスのChallengeRequirementProgressionResponse.CurrentValueフィールドの不正な値が修正されました。