管理ポータルからリーダーボードを管理する
注釈:本資料はAI技術を用いて翻訳されています。
概要
この記事では、AccelByte Gaming Services (AGS) 管理ポータルまたは AGS CLI でゲーム内のリーダーボードを管理する方法について説明します:
- リーダーボードの詳細とプレイヤーの表示
- リーダーボードの詳細、サイクル、全期間設定の更新
- リーダーボードのリセット
- リーダーボードからプレイヤーを非表示にする
- リーダーボードからプレイヤーを削除する
前提条件
- AGS 管理ポータルへのアクセス。
- AGS CLI の手順に従う場合は、AGS CLI をインストールし、これらの機能にアクセスできるアカウントでサインインしている必要があります。インストールとサインインを参照してください。例では Bash シェルを使用しています。
リーダーボードの表示
- Admin Portal
- AGS CLI
-
AGS 管理ポータルで、表示したいリーダーボードがあるゲーム名前空間に移動します。
-
サイドバーメニューで、Online > Leaderboards に移動します。ゲーム内のリーダーボードのリストを表示する Leaderboards ページが表示されます。
-
リーダーボードのリストから、表示したいリーダーボードを見つけて、そのコードをクリックして詳細ページを開きます。Cycles ドロップダウンを使用して、特定のサイクルでリストをフィルタリングします。
-
リーダーボードの詳細ページでは、次の内容を表示できます:
- Leaderboard details: リーダーボードのコード、名前、統計コード(statistic code)、サイクル、順序を表示します。
- Leaderboard data
- All Players: リーダーボード内のすべてのプレイヤーを表示します。
- Hidden Players: リーダーボードの一部であるが、ゲーム内では非表示になっているプレイヤーをリストします。
-
ゲーム名前空間内のリーダーボードを一覧表示します。
<YourNamespace>をゲーム名前空間に置き換えます。ags leaderboard leaderboards list --namespace <YourNamespace> -
リーダーボードの詳細を取得します。
<LeaderboardCode>をそのleaderboardCodeに置き換えます。ags leaderboard leaderboards get --namespace <YourNamespace> --leaderboard-code <LeaderboardCode>出力には、リーダーボードの
name、statCode、cycleIds、allTime、および並び順を示すdescendingが表示されます。 -
リーダーボードサイクル内のプレイヤーを一覧表示します。
<CycleId>をリーダーボードのcycleIdsのいずれかに置き換えます。ags leaderboard global-rankings list-cycle --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --cycle-id <CycleId>全期間サイクルの場合は、代わりに次のコマンドを実行します。
ags leaderboard global-rankings list-all-time --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> -
非表示のプレイヤーを一覧表示します。
ags leaderboard visibility list-hidden --namespace <YourNamespace> --leaderboard-code <LeaderboardCode>
リーダーボードの詳細、サイクル、全期間設定の更新
- Admin Portal
- AGS CLI
- 更新したいリーダーボードの詳細ページに移動します。
- Leaderboard Details セクションで、次のようにリーダーボードを更新できます:
- リーダーボード名を更新します。
- リーダーボードのサイクルを追加または削除します。
- リーダーボードの All-time cycle 設定を有効または無効にします。
- 有効にすると、リーダーボードは定期的に更新され、ゲームの全履歴からのランキングが表示されます。
- 無効にすると、リーダーボードは特定の期間またはサイクルのランキングを表示します。
- ランク付けされたプレイヤーの順序の表示方法を、昇順または降順のいずれかに変更します。
- リーダーボードのアイコンをアップロードまたは変更します。
-
リーダーボードの現在の設定をファイルに保存します。ファイル名は任意です。この例では
leaderboard.jsonを使用します。ags leaderboard leaderboards get --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --format json > leaderboard.json -
leaderboard.jsonで変更したいフィールドを編集します。name: リーダーボード名。cycleIds: リーダーボードのサイクル。allTime: All-time cycle 設定を有効にする場合はtrue、無効にする場合はfalse。cycleIdsに少なくとも 1 つのサイクルがあるか、allTimeがtrueである必要があります。descending: 降順の場合はtrue、昇順の場合はfalse。iconURL: すでにホストされているアイコン画像のアドレス。管理ポータルを使用する場合は、画像のアップロードが自動で行われます。
-
リーダーボードを更新します。
@の後に JSON ファイルへのパスを渡します。ags leaderboard leaderboards update --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --json @leaderboard.json警告cycleIdsからサイクルを削除するか、allTimeをtrueからfalseに変更すると、そのサイクルのランキングデータは直ちに削除されます。管理ポータルでは全期間サイクルを無効にする前に確認が求められますが、AGS CLI では確認なしで実行されます。
リーダーボードサイクルのリセット
リーダーボードサイクルをリセットすると、その中のすべてのランキングデータ、またはすべてのプレイヤーのポイントがリセットされます。リーダーボードサイクルをリセットした後、統計コード設定が更新されると、再びデータが登録されます。
リーダーボードをリセットするには、次の手順に従います:
- Admin Portal
- AGS CLI
- リセットしたいリーダーボードの詳細ページに移動します。
- Leaderboard Detail ページで、Leaderboard Data セクションの Reset Leaderboard ボタンをクリックします。Reset Leaderboard モーダルが表示され、リセットしたいサイクルを選択する必要があります。
- 確認メッセージで、リセットしたいリーダーボードのサイクルを選択し、Reset をクリックします。リーダーボードサイクルは直ちにリセットされます。
-
リーダーボードの詳細を取得し、その
cycleIdsからリセットするサイクルの ID を控えます。 -
サイクルをリセットします。
<CycleId>をサイクル ID に置き換えます。ags leaderboard global-rankings reset-cycle --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --cycle-id <CycleId>
リーダーボードからプレイヤーを非表示にする
- Admin Portal
- AGS CLI
- リーダーボードの詳細ページに移動します。
- リーダーボードの詳細ページで、非表示にしたいユーザーのランキングが含まれるリーダーボードサイクルを選択します。
- Leaderboard Data セクションの All Players タブで、非表示にしたいプレイヤーを見つけて、Action (...) メニューをクリックし、Delete を選択します。
- 確認メッセージで Hide をクリックします。プレイヤーは直ちにリーダーボードから非表示になります。非表示にしたプレイヤーを表示するには、Hidden Players タブに移動します。
-
リーダーボード内のプレイヤーを一覧表示し、非表示にするプレイヤーの
userIdを控えます。 -
プレイヤーを非表示にします。
<UserId>をプレイヤーのユーザー ID に置き換えます。ags leaderboard visibility set-user-status --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --user-id <UserId> --json '{"visibility": false}'プレイヤーを再度表示するには、
"visibility": trueを指定して同じコマンドを実行します。
プレイヤーのランキングデータの削除
プレイヤーのランキングデータを削除すると、そのプレイヤーは所属しているリーダーボードから直ちに削除されます。リーダーボードサイクル中に十分なランキングポイントを獲得できれば、リーダーボードに再参加できます。
ランキングデータを削除した後にプレイヤーがリーダーボードに再参加するのを防ぐには、ゲームへのログインまたはマッチメイキングプールから禁止することができます。
リーダーボード内のプレイヤーのランキングデータを削除するには、次の手順に従います:
- Admin Portal
- AGS CLI
- リーダーボードの詳細ページに移動します。
- リーダーボードの詳細ページで、削除したいユーザーのランキングが含まれるリーダーボードサイクルを選択します。
- Leaderboard Data セクションの All Players タブで、削除したいプレイヤーを見つけて、Action (...) メニューをクリックし、Delete を選択します。
- 確認メッセージで Delete をクリックします。プレイヤーは直ちにリーダーボードサイクルから削除されます。
-
リーダーボードサイクル内のプレイヤーを一覧表示し、削除するプレイヤーの
userIdを控えます。 -
サイクルからプレイヤーのランキングデータを削除します。
<UserId>をプレイヤーのユーザー ID に、<CycleId>をサイクル ID に置き換えます。ags leaderboard user-rankings reset-cycle --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --cycle-id <CycleId> --user-id <UserId>全期間サイクルからプレイヤーのランキングデータを削除するには、代わりに次のコマンドを実行します。
ags leaderboard user-rankings reset --namespace <YourNamespace> --leaderboard-code <LeaderboardCode> --user-id <UserId>