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

Last updated on July 14, 2026

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

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

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

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

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

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

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

   AGS Public 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