Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

この記事では、ゲーム統合に使用するベストプラクティスについて説明します。これらのゲーム統合ベストプラクティスは、問題の発生を防ぎ、発生した問題の影響を最小限に抑え、プレイヤーにより良いユーザーエクスペリエンスを提供するのに役立ちます。

基本

ドキュメントリンク

ベストプラクティスドキュメントのコピーはこちらから入手できます。

---

• AGS API を呼び出す前にログインを実装します。
  Details

  ログイン認証トークンなしで API を呼び出すとエラーが発生します。

  
  

  確認手順:

  1. AGS Game SDK ログを有効にします。
  2. ゲームログを開きます。
  3. 他の API 呼び出しの前にログインが呼び出されることを確認します。
  

  参考資料:

  認証の概要
  Byte Wars - Access - (Unreal Engine モジュール)
  
• ログインキューを実装します。
  • ログインキューを有効にします。
  Details

  ログインキューは、スペースが利用可能な場合にのみプレイヤーがゲームに入ることを許可し、ピーク時間中にプレイヤーの流入がサーバーを過負荷にすることを防ぎます。

  
  

  確認手順:

  1. ゲーム名前空間の AGS 管理ポータルで、Live Service Utilities > Login Queue に移動します。
  2. ページタイトル下の機能ステータスが Active になっていることを確認します。
  3. Inactive の場合は、右側の Activate ボタンを押します。
  4. プロダクトバージョンが Activate Login Queue ポップアップに表示されているものと一致することを確認します。
  5. Confirm をクリックします。
  6. 機能ステータスが Active に更新されたことを確認します。
  

  参考資料:

  Login Queue
  Byte Wars - Login Queue (Unreal Engine module)
  
  • 適切なログインキュー制限を設定します。
  Details

  サーバーの能力を超えて設定されたログインキュー制限は、サーバーが過負荷になるリスクを高めます。

  
  

  確認手順:

  1. ゲーム名前空間の AGS 管理ポータルで、Live Service Utilities > Login Queue に移動します。
  2. Max Concurrency、Max Login Rate per Second、および Advanced Configuration オプションが適切に設定されていることを確認します。
  3. 変更したい場合は Edit をクリックし、Save をクリックします。
  

  参考資料:

  Login Queue
  Byte Wars - Login Queue (Unreal Engine module)
  
• ログイン後に AGS Lobby に接続します。
  Details

  通知の配信およびソーシャル機能とマッチメイキング機能にアクセスするには、AGS Lobby 接続が必要です。

  
  

  確認手順:

  1. AGS Game SDK ログを有効にします。
  2. ゲームログを開きます。
  3. ログイン成功後の AGS Lobby 接続を確認します。
  

  参考資料:

  Configure Lobby with the SDK
• パーティー保持を確保します。
  • ゲーム起動時にパーティーを作成または復元します。
  Details

  プレイヤーを最初から（一人または以前のパーティーの一部として）パーティーに配置することで、パーティー機能とのシームレスなやり取りを確保します。

  
  

  確認手順:

  1. ゲーム起動時にプレイヤーのパーティー情報がチェックされることを確認します。
  2. チェックでパーティー情報が返される場合は、そのパーティーを復元するか解散して、プレイヤーを新しいパーティーに参加させます。
  3. チェックでパーティー情報が返されない場合は、プレイヤーを新しいパーティーに参加させます。
  

  参考資料:

  Byte Wars - Implement party utilities - Implement a party session (Unreal Engine module)
  Byte Wars - Implement party creation - Implement a party session (Unreal Engine module)
  Create a party - Integrate Party into your game
  
  • プレイヤーがパーティーを離脱またはキックされた時に新しいパーティーを作成します。
  Details

  プレイヤーは常にパーティーに所属している必要があります（一人だけのパーティーでも）。これにより、パーティー機能とのシームレスなやり取りを確保します。

  
  

  確認手順:

  1. プレイヤーがゲームをプレイする際にパーティーに配置されることを確認します。
  2. プレイヤーがパーティーを離脱またはキックされた後に新しいパーティーに配置されることを確認します。
  

  参考資料:

  Byte Wars - Implement party creation - Implement a party session (Unreal Engine module)
  Byte Wars - Implement leave party - Implement a party session (Unreal Engine module)
  Create a party - Integrate Party into your game
  Leave a party - Integrate Party into your game
  Kick a player from a party
  
• WebSocket（Lobby および Chat）接続エラーと再接続条件を処理します。
  • インターネット接続喪失エラーを処理します。
  Details

  接続問題時のプレイヤーのフラストレーションを軽減します。

  
  

  確認手順:

  1. Lobby 接続が確立されるまでゲームを実行します。
  2. デバイスをインターネットから切断します。
  3. Lobby がエラー信号を出したら、コールバックをメモします。
  4. デバイスをインターネットに再接続します。
  5. 接続が再確立された時の適切なフローを確認します。
  

  参考資料:

  Handle connect and disconnect events - Configure Lobby with the SDK
  Websocket Reconnection Strategy
  
  • ゲームがバックグラウンドで実行されることによる接続エラーを処理します。
  Details

  プレイヤーがゲーム、アプリケーション、プロセス間を切り替える際の継続的なゲーム体験を提供します。

  
  

  確認手順:

  1. Lobby 接続が確立されるまでゲームを実行します。
  2. 新しいゲームまたはプロセスに切り替えます（コンソールで別のゲームを起動するか、PC で Alt + Tab を押します）。
  3. 元のゲームに戻ります。
  4. Lobby がエラー信号を出したら、コールバックをメモします。
  5. デバイスをインターネットに再接続します。
  6. 接続が再確立された時の適切なフローを確認します。
  

  参考資料:

  Handle connect and disconnect events - Configure Lobby with the SDK
  Websocket Reconnection Strategy
  
  • マッチメイキング接続エラーを処理します。
  Details

  接続喪失後にプレイヤーがマッチメイキングプロセスで立ち往生することを防ぎます。

  
  

  確認手順:

  1. Lobby 接続が確立されるまでゲームを実行します。
  2. マッチメイキングを開始します。
  3. マッチメイキングプロセス中にデバイスをインターネットから切断します。
  4. Lobby がエラー信号を出したら、コールバックをメモします。
  5. デバイスをインターネットに再接続します。
  6. 接続が再確立された時の適切なフローを確認します。
  

  参考資料:

  Handle connect and disconnect events - Configure Lobby with the SDK
  Websocket Reconnection Strategy
  
  • マルチプレイヤーマッチ接続エラーを処理します。
  Details

  接続喪失後にプレイヤーがプレイしていたマッチに戻ることを可能にします。

  
  

  確認手順:

  1. Lobby 接続が確立されるまでゲームを実行します。
  2. マッチメイキングを開始してマルチプレイヤーマッチに参加します。
  3. デバイスをインターネットから切断します。
  4. Lobby がエラー信号を出したら、コールバックをメモします。
  5. デバイスをインターネットに再接続します。
  6. 接続が再確立された時の適切なフローを確認します。
  

  参考資料:

  Handle connect and disconnect events - Configure Lobby with the SDK
  Websocket Reconnection Strategy
  
  • 同一アカウントの同時 Lobby 接続試行エラー（シングルポイントオブプレゼンス）を処理します。
  Details

  プレイヤーが複数のデバイスまたはクライアントで同じアカウントにログインすることを防ぎます。

  
  

  確認手順:

  1. Lobby 接続が確立されるまでゲームを実行します。
  2. 同じアカウントを使用して別のデバイスまたはクライアントで繰り返します。
  3. デバイスまたはクライアントでトリガーされたエラーをメモします。
  4. エラーを処理し、アカウントが既にログインしていることをクライアントに通知します。
  

  参考資料:

  Handle connect and disconnect events - Configure Lobby with the SDK
  Websocket Reconnection Strategy
  
• ゲーム終了時のログアウトを実装します。
  • クライアントウィンドウで Close が押された時のログアウトを実装します。
  Details

  プレイヤーがウィンドウを閉じた時にプレイヤーがログアウトされることを確認します。

  
  

  確認手順:

  1. AGS Game SDK ログを有効にします。
  2. ゲームを実行します。
  3. ログインしてメインメニューに到達します。
  4. ウィンドウの Close ボタンを使用してゲームを閉じます。
  5. ゲームログを開きます。
  6. ゲーム終了前にログアウトが呼び出されることを確認します。
  

  参考資料:

  Logout - Authentication using the Unreal Engine SDK
  
  • ゲームメニューに Exit オプションがある場合のログアウトを実装します。
  Details

  プレイヤーがユーザーインターフェースを使用してログアウトできることを確認します。

  
  

  確認手順:

  1. AGS Game SDK ログを有効にします。
  2. ゲームを実行します。
  3. ログインしてメインメニューに到達します。
  4. ゲームメニューの Exit または Close オプションを使用してゲームを閉じます。
  5. ゲームログを開きます。
  6. ゲーム終了前にログアウトが呼び出されることを確認します。
  

  参考資料:

  Logout - Authentication using the Unreal Engine SDK
  
• フレンド同期を実装します。
  • ゲーム起動時にフレンドを同期します。
  Details

  プレイヤーがゲームを開始する際にフレンドリストが最新であることを確認します。

  
  

  確認手順:

  1. 2つの別々のクライアントでゲームを実行します。
  2. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持ち、互いをフレンドとして持っていることを確認します。
  3. ゲーム内の各クライアントのフレンドリストをチェックし、互いのリストに載っていることを確認します。
  4. AGS 管理ポータルの Lookup Users で各プレイヤーを検索し、互いのフレンドリストに載っていることを確認します。
  

  参考資料:

  Synchronize platform friends
  
  • プレイヤーがプラットフォームインターフェースでフレンド追加を試行した後にフレンドを同期します。
  Details

  ゲーム実行中にプレイヤーがプラットフォームインターフェース（Steam、PSN、Xbox など）経由でフレンド追加を試行した後に、プレイヤーのフレンドリストが更新されることを確認します。

  
  

  確認手順:

  1. AGS Game SDK ログを有効にします。
  2. 2つの別々のクライアントでゲームを実行します。
  3. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持っていることを確認します。
  4. 一方のアカウントを使用してプラットフォームインターフェース経由で他方をフレンドとして追加します。
  5. ゲームに戻ります。
  6. ゲームログを開きます。
  7. フレンド同期が呼び出されたことを確認します。
  

  参考資料:

  Synchronize platform friends
  
  • プレイヤーがプラットフォームインターフェースでフレンドリクエストを承認した後にフレンドを同期します。
  Details

  ゲーム実行中にプレイヤーがプラットフォームインターフェース（Steam、PSN、Xbox など）経由でフレンドリクエストを承認した後に、プレイヤーのフレンドリストが更新されることを確認します。

  
  

  確認手順:

  1. 2つの別々のクライアントでゲームを実行します。
  2. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持っていることを確認します。
  3. 一方のアカウントを使用してプラットフォームインターフェース経由で他方をフレンドとして追加します。
  4. 他方のクライアントでプラットフォームインターフェース経由でフレンドリクエストを承認します。
  5. ゲームとプラットフォームインターフェースで各クライアントのフレンドリストをチェックし、互いのリストに載っていることを確認します。
  6. AGS 管理ポータルの Lookup Users で各プレイヤーを検索し、互いのフレンドリストに載っていることを確認します。
  

  参考資料:

  Synchronize platform friends
  
  • フレンド削除後にフレンドを同期します。
  Details

  プレイヤーがフレンドリストからフレンドを削除した後に、プレイヤーのフレンドリストが更新されることを確認します。

  
  

  確認手順:

  1. 2つの別々のクライアントでゲームを実行します。
  2. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持ち、互いをフレンドとして持っていることを確認します。
  3. 一方のアカウントを使用してフレンド削除 AGS API を使用して他方をフレンドリストから削除します。
  4. ゲームとプラットフォームインターフェース（Steam、PSN、Xbox など）で更新されたフレンドリストを確認します。
  

  参考資料:

  Synchronize platform friends
  
• ブロックリスト同期を実装します。
  • プレイヤーブロック後にブロックされたプレイヤーを同期します。
  Details

  プラットフォームインターフェース（Steam、PSN、Xbox など）でブロックされたプレイヤー機能を使用する際に、プレイヤーのブロックされたプレイヤーリストが最新であることを確認します。

  
  

  確認手順:

  1. 2つの別々のクライアントでゲームを実行します。
  2. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持っていることを確認します。
  3. 一方のアカウントを使用してプラットフォームインターフェース経由で他方をブロックします。
  4. ゲームとプラットフォームインターフェースで更新されたブロックリストを確認します。
  

  参考資料:

  Synchronize blocklist data with native platforms - Implement player blocking
  
  • ゲーム起動時にブロックされたプレイヤーを同期します。
  Details

  プレイヤーがゲームを開始する際にブロックされたプレイヤーのリストが最新であることを確認します。

  
  

  確認手順:

  1. 2つの別々のクライアントでゲームを実行します。
  2. 各クライアントに別々のアカウントでログインし、各アカウントが同じ環境と名前空間にプロフィールを持っていることを確認します。
  3. 一方のクライアントを閉じます。
  4. 開いているクライアントを使用して他方のアカウントをブロックします。
  5. 残りのクライアントを閉じます。
  6. 同じ2つのアカウントを使用してゲームを再起動します。
  7. ゲームとプラットフォームインターフェースで更新されたブロックリストを確認します。
  8. AGS 管理ポータルの Lookup Users で各プレイヤーを検索し、互いのフレンドリストに載っていないことを確認します。
  

  参考資料:

  Synchronize blocklist data with native platforms - Implement player blocking
  
• サードパーティストアを設定します。
  • サードパーティストアを構成します。
  Details

  サードパーティプラットフォームストアが AGS Ecommerce と適切に同期されていることを確認します。

  
  

  確認手順:

  1. AGS 管理ポータルで、Game Setup > 3rd Party Configuration > Store に移動します。
  2. 希望するサードパーティストアのタブ（PlayStation Store など）をクリックします。
  3. Add Configuration をクリックします。
  4. フォームを完成させて Add をクリックします。
  

  参考資料:

  Manage third-party store integrations
  
  • 消費可能アイテムを確認します。
  Details

  消費可能アイテムが適切に動作し、返金がサードパーティプラットフォームストアと同期されていることを確認します。同じバンドルに消費可能アイテムと耐久アイテムの両方を含めることは避けてください。

  
  

  確認手順:

  1. AGS 管理ポータルで、Commerce > In App Purchase > Item Mapping に移動します。
  2. ここにリストされているアイテムが Consumable に設定されていることを確認します。
  

  参考資料:

  Set up and sell consumables
  
  • 耐久アイテムを確認します。
  Details

  耐久アイテムが適切に動作し、返金がサードパーティプラットフォームストアと同期されていることを確認します。同じバンドルに消費可能アイテムと耐久アイテムの両方を含めることは避けてください。

  
  

  確認手順:

  1. AGS 管理ポータルで、Commerce > In App Purchase > DLC Setting に移動します。
  2. ここにリストされているアイテムが Durable に設定されていることを確認します。
  

  参考資料:

  Set up and sell DLCs
  
• 接続中断処理。
  • WebSocket 接続中断を処理します。
  Details

  WebSocket 接続中断がある場合に、ゲームクライアントとゲームサーバーが影響を適切に処理することを確認します。

  
  

  確認手順:

  AGS プライベートクラウドのお客様は、カスタマーサポートポータル経由で AccelByte サポートに接続中断のシミュレーションを依頼できます。
  

  参考資料:

  ロビーWebSocketリカバリー：中断と再接続の処理
  
  • HTTP 接続中断を処理します。
  Details

  HTTP 接続中断がある場合に、ゲームクライアントとゲームサーバーが影響を適切に処理することを確認します。HTTP エラーコードは：429、449、500、502、503、504 です。

  
  

  確認手順:

  AGS プライベートクラウドのお客様は、カスタマーサポートポータル経由で AccelByte サポートに接続中断のシミュレーションを依頼できます。
  

  参考資料:

  API Call Recovery: Handling Failed Requests Gracefully