ゲームの名前空間を作成する
注釈:本資料はAI技術を用いて翻訳されています。
Overview
AccelByte Gaming Services (AGS) では、AGS 管理者ポータルで名前空間を使用して、機能、属性、アクセシビリティを管理します。パブリッシャー名前空間はスタジオがゲームのポートフォリオ全体に特定の設定を適用するために使用するものですが、ゲーム名前空間は特定の1つのゲームに対する設定を行うために使用されます。スタジオの各ゲームには、ゲーム名前空間が必要です。
すでに AGS アカウントを登録している場合、そのプロセスの一部として最初のゲーム名前空間が作成されているはずです。この How-to では、AGS 管理者ポータルまたは AGS CLI で追加のゲーム名前空間を作成する方法を説明します。
前提条件
AGS 管理者ポータルにアクセスするには、AGS アカウントが必要です。アカウントをお持ちでない場合は、無料の Public Cloud アカウントを作成するか、AccelByte のアカウント担当者にお問い合わせください。
AGS CLI の手順に従うには、AGS CLI をインストールし、これらの機能へのアクセス権があるアカウントでサインインしてください。インストールとサインイン を参照してください。例では Bash シェルを使用しています。
ゲーム名前空間を作成する
AGS の設定をゲームごとに行うには、AGS を使用する各ゲームにゲーム名前空間が必要です。ゲーム名前空間を作成するには、以下の手順に従います。
- Admin Portal
- AGS CLI
- AGS 管理者ポータルにログインします。
- すべての名前空間(YOUR STUDIO と GAMES、サイドバーなし)が表示される Your Titles ページにいることを確認します。
- Your Titles ページではなく名前空間の中にいる場合(サイドバーが表示されている場合)は、左上の NAMESPACE の下にあるドロップダウンをクリックします。
- View All をクリックして Your Titles ページに移動します。
- Your Titles ページで、+ CREATE をクリックします。
- New Game Setup ページで、ゲームに関する以下の情報を入力します。
- Game Name: ゲームの正式名称。
- Game Title ID: データや設定の目的(例: URL 名やコードの実装)で使用するゲームの ID。Game Name から互換性のある形式(例: スペースの削除)に自動的に生成されます。
警告
後で Game Name を変更することはできますが、このフォームを完了した後は、生成された Game Title ID を変更することはできません。
ゲーム名前空間が作成され、管理者ポータル内のその名前空間にリダイレクトされます。
-
ゲーム名前空間を作成します。
<GameName>をゲームの正式名称に、<GameTitleId>をゲームの ID に置き換えます。ags basic namespaces create --json '{"displayName": "<GameName>", "namespace": "<GameTitleId>"}'名前にアポストロフィ(
')が含まれる場合は、JSON をファイルに記述し、代わりに--json @<FileName>.jsonで渡します。displayName: Game Name。namespace: Game Title ID。英字と数字のみを使用してください。ID は AGS によって小文字に変換されます。管理者ポータルでは、Game Name から英字と数字以外の文字をすべて取り除いてこの ID を生成します。AGS Public Cloud では、AGS がスタジオの名前空間とハイフンを先頭に追加するため、新しい名前空間の ID は<YourStudioNamespace>-<GameTitleId>になります。
コマンドを実行すると、新しい名前空間が出力されます。出力の
namespaceフィールドの値が、他のコマンドで使用する ID です。 -
AGS Public Cloud を使用している場合は、アクセストークンを更新して、新しい名前空間でのロールがトークンに含まれるようにします。
ags auth refresh
名前空間の Display Name はスタジオまたはゲームの名前であり、いつでも変更できます。これは、データや設定の目的(例: URL 名やコードの実装)で使用される識別子である Title ID とは異なります。ゲーム名前空間の Title ID は、作成後は変更できません。
次のステップ
名前空間の詳細については、名前空間を参照してください。