AMS設定のセットアップ - AccelByte Multiplayer Servers (AMS) を使用した専用サーバー - (Unityモジュール)

Last updated on September 28, 2026

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

注記

AGS CLI は AGS 向けの統一コマンドラインツールであり、Extend と AMS のツールも含まれるようになりました。このページの手順は現在も有効です。統合ツールの詳細は AGS CLI のドキュメント を参照してください。

概要​

IAMクライアントは、AccelByte Gaming Services (AGS) の特定のリソースに対する権限を付与するために使用されます。ゲームの専用サーバー (デディケーテッドサーバー) がAccelByte Multiplayer Servers (AMS) と通信できるようにするには、正しいIAMクライアントの権限を設定し、さらにプロジェクトにインストールされているAGS Game SDKを設定して、ゲームのAMS機能を有効にする必要があります。

サーバーIAMクライアントを作成する​

サーバーID・アクセス管理 (IAM) クライアントは、ゲームサーバーに権限を付与するIAMクライアントです。ゲームサーバーがAMSと通信できるようにするには、十分な権限が必要です。

  1. Admin Portalにログインし、ゲームのネームスペースダッシュボードに移動します。

  2. Foundations > Identity & Access > IAM Clients に移動し、Create New をクリックします。

  3. What is this client for? ウィンドウで Dedicated Server を選択し、Continue をクリックします。New IAM Client ページが表示されます。

    IAMクライアントテンプレートが表示されたWhat is this client forウィンドウを示す画像

  4. Basic Info および Client Settings セクションで、以下の設定を使用して新しいサーバーIAMクライアントを作成します。

    • Client Name: IAMクライアントの名前です。ByteWars-GameServer に設定します。
    • Secret: IAMクライアントのシークレット (パスワード) です。独自のシークレットを使用することも、Generate をクリックしてランダムなシークレットを生成することもできます。
    • Redirect URI: IAMクライアントの認証が成功した後にリダイレクトするために使用されるURIです。Localhost を選択すると、http://127.0.0.1 に設定されます。

  5. Permissions セクションで、クライアントに以下の権限があることを確認します。これらの権限により、サーバーはゲームセッションの管理、統計情報の更新、プレイヤー情報の読み取り、AMS設定の管理を行うことができます。

    リソース権限
    AMS > Dedicated ServerCreate, Read, Update, Delete
    IAM > UsersRead
    Session > Game SessionCreate, Read
    Statistics > User’s Statistics ValueCreate, Read, Update

  6. Continue をクリックします。Save your client secret ウィンドウが表示されます。Copy secret をクリックし、シークレットを安全な場所に保存します。次に、I have copied and stored this client secret securely にチェックを入れ、Create をクリックしてIAMクライアントを作成します。

    warning

    Secret は、IAMクライアントを作成した後は再表示されません。Create をクリックする前に、必ずコピーして保存してください。

    Copy secretボタンがあるSave your client secretウィンドウを示す画像

AMS CLI IAMクライアントを作成する​

AMSコマンドラインインターフェース (CLI) IAMクライアントは、サーバーをAMSにアップロードするための権限を付与するIAMクライアントです。

  1. Admin Portalにログインし、ゲームのネームスペースダッシュボードに移動します。

  2. Foundations > Identity & Access > IAM Clients に移動し、Create New をクリックします。

  3. What is this client for? ウィンドウで Build and Deploy Tool を選択し、Continue をクリックします。New IAM Client ページが表示されます。

    IAMクライアントテンプレートが表示されたWhat is this client forウィンドウを示す画像

  4. Basic Info および Client Settings セクションで、以下の設定を使用して新しいAMS CLI IAMクライアントを作成します。

    • Client Name: IAMクライアントの名前です。ByteWars-AMSCLI に設定します。
    • Secret: IAMクライアントのシークレット (パスワード) です。独自のシークレットを使用することも、Generate をクリックしてランダムなシークレットを生成することもできます。
    • Redirect URI: IAMクライアントの認証が成功した後にリダイレクトするために使用されるURIです。Localhost を選択すると、http://127.0.0.1 に設定されます。

  5. Permissions セクションで、クライアントに以下の権限があることを確認します。この権限により、AMS CLIを使用してサーバーイメージをAMSにアップロードできます。

    リソース権限
    AMS > Dedicated Server ToolkitCreate, Read, Update

  6. Continue をクリックします。Save your client secret ウィンドウが表示されます。Copy secret をクリックし、シークレットを安全な場所に保存します。次に、I have copied and stored this client secret securely にチェックを入れ、Create をクリックしてIAMクライアントを作成します。

    warning

    Secret は、IAMクライアントを作成した後は再表示されません。Create をクリックする前に、必ずコピーして保存してください。

    Copy secretボタンがあるSave your client secretウィンドウを示す画像

Server SDKを設定する​

Admin PortalでサーバーIAMクライアントを設定したら、ゲームプロジェクトでServer SDKを設定する必要があります。

  1. UnityでByte Warsを開きます。

  2. Resources フォルダ内に、AccelByteServerSDKConfig.json という名前の新しいJSONファイルを作成します。以下のコードをコピーしてファイルに貼り付けます。次に、値をご自身の認証情報に置き換えます。

    {
        "Default": {
            "Namespace": "<game_namespace_id>",
            "PublisherNamespace": "",
            "BaseUrl": "https://<game_namespace_id>.prod.gamingservices.accelbyte.io",
            "RedirectUri": "http://127.0.0.1"
        }
    }
    備考
    • Namespace はゲームのネームスペースのネームスペースIDです。
    • BaseUrl は、ゲームのネームスペースIDとAdmin Portalの環境を組み合わせて作成されるベースURLです。
    ヒント

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

    • 同様に、パブリッシャーのネームスペースIDを確認するには、Admin Portalに移動し、ゲームのネームスペースが一覧表示されている Namespace ページに移動します。次に、PUBLISHER セクションでパブリッシャーのネームスペースを探し、gear アイコンをクリックします。新しいページで Namespace ID プロパティを探すと、パブリッシャーのネームスペースID値を確認できます。

  3. Resources フォルダ内に、AccelByteServerSDKOAuthConfig.json という名前の別のJSONファイルを作成します。次に、以下のコードをコピーしてファイルに貼り付け、値をご自身の認証情報に置き換えます。

    {
    	"Default": {
    		"ClientId": "<server_iam_client_id>",
    		"ClientSecret": "<server_iam_client_secret>"
    	}
    }
    備考
    • ClientId はランダムに生成され、サーバーIAMクライアントを一意に識別するために使用されます。
    • ClientSecret はサーバーIAMクライアントのシークレット (パスワード) です。

  4. ファイルを保存すると、サーバーSDKの設定は完了です。

AGS Game SDKでAMSを有効にする​

このセクションでは、プロジェクトにインストールされているAGS Game SDKでAMSを有効にし、ゲームサーバーがAMS機能を使用し、AMSと通信するための認可を得られるようにします。以下のいずれかの方法を使用できます。

備考

将来的には、AGS Game SDKでAMSがデフォルトで有効になる予定です。

  1. AccelByteServerSDKConfig.json ファイルを任意のテキストエディタで開きます。

  2. AGS Game SDKでAMSを有効にするには、以下のように EnableAmsServerQos 設定を AccelByteServerSDKConfig.json ファイルに追加して有効化します。

    {
        "Default": {
            ...
            "EnableAmsServerQos": true
        }
    }

  3. ファイルを保存して設定を有効にします。

スターターモードを有効にする​

モジュールの残りの部分に進むには、スターターモードを有効にする必要があります。これを行うには、Unityでプロジェクトを開きます。Projectウィンドウから Assets\Resources\Modules\MultiplayerDSEssentials\MultiplayerDSEssentialsAssetConfig.asset を開き、Inspectorで Is Starter Active 設定を有効にします。この設定により、チュートリアルを進めるために使用するスターターファイルが有効になります。

に最終更新
On this page