リーダーボード入門
注釈：本資料はAI技術を用いて翻訳されています。
概要
AccelByte リーダーボードサービスは、プレイヤー間の競争意識を高め、パフォーマンスを向上させるためにより熱心にプレイし、ランキングを上げようとする動機付けを提供します。リーダーボードサービスは、AccelByte 統計に保存されたデータを使用して、各プレイヤーのランクを比較します。
このセクションでは、リーダーボードサービスの主要な概念と、サービスを利用する際のベストプラクティスについて学習します。
主要な概念
いくつかの主要な概念を理解することが重要です。
リーダーボード設定
リーダーボード設定は、ゲームの要件に合わせて特定のコンテキストと目的を持つリーダーボードをセットアップする方法を提供します。各設定では、統計から比較および取得する値を選択し、開始日と終了日、およびリーダーボードのライフサイクルを設定できます。
リーダーボードコード
機械生成されたコードを使用する代わりに、リーダーボードコードはリーダーボードを識別するために使用される一意の文字列です。
リーダーボードコードの例:
- "mmr"
- "victory"
- "experience"
統計コード
統計コードは、リーダーボードが取得する統計設定の識別子です。統計設定はプレイヤーのスコアを保存し、リーダーボードがプレイヤーをランク付けするために使用できます。リーダーボードを有効にする前に、同じゲーム名前空間に統計設定を作成していることを確認してください。
リーダーボードのライフサイクル
プレイヤーは指定された期間中にポイントを獲得するために互いに競い合い、その進捗状況が追跡されてリーダーボードに表示されます。
リーダーボードには5つのライフサイクルのいずれかを設定できます:
全期間
全期間リーダーボードには時間的制約がなく、プレイヤーの統計データからの最終値に基づいてプレイヤーをランク付けします。プレイヤーのスコアが蓄積され続けると、このリーダーボードは更新されます。
日次
日次リーダーボードは、24時間の期間におけるプレイヤーのパフォーマンスに基づいてランク付けします。ゲーム管理者は開始時刻を設定できます。リーダーボードは24時間後にリセットされ、プレイヤーは次の24時間の期間でリーダーボードの順位を競う新しいチャンスを得ます。
週次
週次リーダーボードは、7日間の期間におけるプレイヤーのパフォーマンスに基づいてランク付けします。ゲーム管理者は期間の開始日時を設定できます。リーダーボードは7日後にリセットされ、プレイヤーは次の7日間でリーダーボードの順位を競う新しいチャンスを得ます。
月次
月次リーダーボードは、1か月間のプレイヤーのパフォーマンスに基づいてランク付けします。ゲーム管理者は開始日時を設定できます。リーダーボードは翌月の同じ日時にリセットされ、プレイヤーは翌月にリーダーボードの順位を競う新しいチャンスを得ます。
シーズン
シーズンリーダーボードは、特定のカスタム期間中のプレイヤーのパフォーマンスに基づいてランク付けします。このタイプのリーダーボードでは、開始時刻と終了時刻の両方を設定します。
開始日
リーダーボードが統計サービスから公開された値の受信を開始し、比較およびランク付けされる正確な時刻です。
順序
順序では、リーダーボードを昇順または降順のどちらで表示するかを選択できます。
リーダーボード更新フロー
このセクションでは、リーダーボードサービスがユーザー統計とどのように統合されているかを説明します。以下のフローを理解することで、サービスを最適に使用する方法が理解しやすくなります。
リーダーボードサービスは特定の統計イベントをリッスンします。ユーザー統計が更新されるたびに、統計はリーダーボードサービスによって取得されるイベントを公開します。イベント内のデータはリーダーボードに追加され、ユーザーランキングがソートされます。
リーダーボードバージョン
サービスの体験を向上させるために、新しいバージョンのリーダーボードをサポートしています。
新しいリーダーボード
- 新規ユーザーの場合、レガシーバージョンは管理者ポータルでアクセスできません。新しいリーダーボードバージョンでのみ設定を作成できます。v3エンドポイントを使用してください。
- レガシーバージョンのリーダーボードをまだ使用している既存ユーザーの場合、最新の機能強化を試したい場合は、新しいリーダーボードメニューで設定を作成し、最新バージョンのv3エンドポイントを使用してリーダーボードをアップグレードしてください。
新しいバージョンのリーダーボードを使用してプレイヤーのランキングを表示する方法の詳細については、リーダーボードランキングの表示を参照してください。
レガシーリーダーボード
v1およびv2エンドポイントを使用してレガシーバージョンを引き続き使用できます。これらは完全に機能しており、管理者ポータルから既存の設定にアクセスできます。ただし、これらのバージョンの更新と改善は終了していることに注意してください。
レガシーリーダーボードバージョンの詳細については、リーダーボード設定の作成とプレイヤーのランキングの表示のガイドを参照してください。