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

Last updated on July 14, 2026

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

概要​

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 IAM Clients をクリックします。

  3. 新しいページで、以下の設定を使用して新しいサーバーIAMクライアントを作成します。

    • Create Options: 新しいIAMクライアントを作成するための利用可能なオプションです。テンプレートから新しいIAMクライアントを作成するには、Create from Template オプションを選択します。
    • Select Template: 新しいIAMクライアントを作成するためのテンプレートです。新しいサーバーIAMクライアントを作成するには、Dedicated Server オプションを選択します。このオプションは、ゲームサーバーに必要な権限を付与します。
    • Client Name: IAMクライアントの名前です。ByteWars-GameServer に設定します。
    • Client Type: IAMクライアントの機密性です。サーバーIAMクライアントは秘密にする必要があるため、Confidential に設定します。
    • Secret: IAMクライアントのシークレット (パスワード) です。独自のシークレットを使用することも、Generate ボタンをクリックしてランダムなシークレットを生成することもできます。必ずこれをコピーしてください。
    • Redirect URI: IAMクライアントの認証が成功した後にリダイレクトするために使用されるURIです。http://127.0.0.1 に設定します。
    warning

    Secret は、IAMクライアントを作成した後は再表示されません。次のステップに進む前に、必ずコピーして保存してください。

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

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

  5. Create をクリックしてサーバーIAMクライアントを作成します。作成が完了すると、設定は完了です。

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

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

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

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

  3. 新しいページで、以下の設定を使用して新しいAMS CLI IAMクライアントを作成します。

    • Create Options: 新しいIAMクライアントを作成するための利用可能なオプションです。テンプレートから新しいIAMクライアントを作成するには、Create from Template オプションを選択します。
    • Select Template: 新しいIAMクライアントを作成するためのテンプレートです。新しいAMS CLI IAMクライアントを作成するには、Dedicated Server Tools オプションを選択します。このオプションは、AMS CLIを実行するために必要な権限を付与します。
    • Client Name: IAMクライアントの名前です。ByteWars-AMSCLI に設定します。
    • Client Type: IAMクライアントの機密性です。AMS CLI IAMクライアントは秘密にする必要があるため、Confidential に設定します。
    • Secret: IAMクライアントのシークレット (パスワード) です。独自のシークレットを使用することも、Generate ボタンをクリックしてランダムなシークレットを生成することもできます。必ずこれをコピーしてください。
    • Redirect URI: IAMクライアントの認証が成功した後にリダイレクトするために使用されるURIです。http://127.0.0.1 に設定します。
    warning

    Secret は、IAMクライアントを作成した後は再表示されません。次のステップに進む前に、必ずコピーして保存してください。

  4. Permissions タブで、以下の権限があることを確認します。この権限により、AMS CLIを使用してサーバーイメージをAMSにアップロードできます。

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

  5. Create をクリックしてAMS CLI IAMクライアントを作成すると、設定は完了です。

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