run-sample-matchmaking - エンドツーエンドテスト - (Unreal Engineモジュール)

Last updated on February 4, 2026

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

サンプルマッチメイキングバックエンドサービスをローカルで実行する

このチュートリアルセクションでは、サンプルマッチメイキングバックエンドサービスをコンピューター上でローカルに実行する方法を学びます。

1. まず、サンプルマッチメイキングバックエンドサービスプロジェクトがコンピューターにクローンされていることを確認します。クローン方法については、初期セットアップモジュールを参照してください。

2. サンプルマッチメイキングバックエンドサービスプロジェクトはPythonを使用して作成されています。まだインストールしていない場合は、Python 3.13.xをインストールしてください。

3. run.ps1という名前の新しいPowerShellスクリプトを作成し、クローンしたバックエンドサービスプロジェクトのmatchmaking-serverフォルダー内に配置します。

4. run.ps1ファイルを開き、以下のコードを追加します。このコードはserver.pyの環境変数を設定し、Pythonスクリプトを実行します。

   AGS Shared Cloud

   # Set env var
   $env:AB_BASE_URL = "https://<game_namespace_id>.prod.gamingservices.accelbyte.io"
   $env:AB_NAMESPACE = "<game_namespace_id>"
   $env:AB_CLIENT_ID = "<ams_cliam_client_id>"
   $env:AB_CLIENT_SECRET = "<ams_cliam_client_secret>"
   $env:CLAIM_KEYS = "<ams_fleet_claim_key>"
   $env:REGIONS = "<ams_fleet_active_regions>"
   
   # Run python
   & python ./server.py

   備考

   • AB_BASE_URLは、ゲームネームスペースIDとAdmin Portal環境を組み合わせて作成されるベースURLです。
   • AB_NAMESPACEは、ゲームネームスペースのネームスペースIDです。
   • AB_CLIENT_IDは、専用サーバーをクレームするためのIAMクライアントのクライアントIDです。IAMクライアントのセットアップで作成したByteWars-AMSClaim IAMクライアントを使用できます。
   • AB_CLIENT_SECRETは、専用サーバーをクレームするためのIAMクライアントのクライアントシークレットです。IAMクライアントのセットアップで作成したByteWars-AMSClaim IAMクライアントを使用できます。
   • CLAIM_KEYSは、AMSフリートに設定したクレームキーです。クレームキーはカンマで区切り、空白なしで指定する必要があります。例：claimkey1,claimkey2。詳細については、専用サーバーをAMSにアップロードを参照してください。
   • REGIONSは、AMSフリートのアクティブなリージョンです。リージョンはカンマで区切り、空白なしで指定する必要があります。例：ap-southeast-1,us-east-2。詳細については、専用サーバーをAMSにアップロードを参照してください。

   AGS Private Cloud

   # Set env var
   $env:AB_BASE_URL = "https://<studio_name>.accelbyte.io"
   $env:AB_NAMESPACE = "<game_namespace_id>"
   $env:AB_CLIENT_ID = "<ams_cliam_client_id>"
   $env:AB_CLIENT_SECRET = "<ams_cliam_client_secret>"
   $env:CLAIM_KEYS = "unreal-ds-ams"
   $env:REGIONS = "ap-southeast-1,us-east-2"
   
   # Run python
   & python ./server.py

   備考

   • AB_BASE_URLは、Admin Portal環境のURLです。
   • AB_NAMESPACEは、ゲームネームスペースのネームスペースIDです。
   • AB_CLIENT_IDは、専用サーバーをクレームするためのIAMクライアントのクライアントIDです。前のセクションで作成したByteWars-AMSClaim IAMクライアントを使用できます。
   • AB_CLIENT_SECRETは、専用サーバーをクレームするためのIAMクライアントのクライアントシークレットです。前のセクションで作成したByteWars-AMSClaim IAMクライアントを使用できます。
   • CLAIM_KEYSは、AMSフリートに設定したクレームキーです。クレームキーはカンマで区切り、空白なしで指定する必要があります。例：claimkey1,claimkey2。詳細については、専用サーバーをAMSにアップロードを参照してください。
   • REGIONSは、AMSフリートのアクティブなリージョンです。リージョンはカンマで区切り、空白なしで指定する必要があります。例：ap-southeast-1,us-east-2。詳細については、専用サーバーをAMSにアップロードを参照してください。
   ヒント

   ゲームネームスペースIDを見つけるには、Admin Portalに移動し、Namespaceページに移動してゲームネームスペースが一覧表示されます。次に、GAMESセクションでゲームネームスペースを見つけ、歯車アイコンをクリックします。新しいページで、Namespace IDプロパティを見つけると、ゲームネームスペースIDの値を確認できます。

5. クローンしたリポジトリのmatchmaking-serverフォルダー内からWindows Powershellを開き、以下のコマンドを入力してrun.ps1を実行します。

   ./run.ps1

6. これで、サンプルマッチメイキングバックエンドサービスがコンピューター上でws://127.0.0.1:8080でローカルに実行されています。以下のログが表示され、開始されたことが示されます。ログは、後でゲームクライアントを使用してマッチメイキングを実行する際に表示されます。

   Matchmaking started