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

Last updated on February 4, 2026

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

概要​

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

サーバーIAMクライアントの作成​

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

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

  2. Game Setup > Games and Apps > 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設定の管理が可能になります。

    ResourcePermission
    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. Game Setup > Games and Apps > 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にアップロードできます。

    ResourcePermission
    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 セクションでゲームネームスペースを見つけ、歯車 アイコンをクリックします。新しいページで、Namespace ID プロパティを見つけると、ゲームネームスペースIDの値を確認できます。

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

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

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

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

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

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

備考

将来的には、AMSはAGS Game SDKでデフォルトで有効になります。

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

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

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

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

Starter Modeを有効にする​

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

に最終更新
On this page