Introduction to Leaderboards
概要
AccelByte リーダーボードサービスを使用すると、プレイヤー間に競争意識を持たせ、これにより、熱の入ったプレイでパフォーマンスや、ランクを上げようとする意欲を高めることができます。リーダーボードサービスは、AccelByte 統計データ に保存されたデータを使用して、各プレイヤーのランクを比較します。
このセクションでは、リーダーボードサービスのキーコンセプトと、このサービスを活用する場合のベストプラクティスについて説明します。
キーコンセプト
いくつかのキーコンセプトを理解することが重要です。
リーダーボードの設定
リーダーボードの設定では、ゲームの要件に合わせて、特定のコンテキストと目的を持つリーダーボードを設定できます。それぞれの設定で、統計データ のどの値を比較して抽出するのかを選択したり、開始日と終了日、およびリーダーボードのライフサイクルを設定したりできます。
リーダーボードコード
リーダーボードコードは、リーダーボードを識別するために使用される一意の文字列です。マシンが生成したコードは使用しません。
リーダーボードコードの例を挙げます。
- "mmr" (MMR)
- "victory" (勝利回数)
- "experience" (経験値)
統計データコード
統計データコードは、リーダーボードが抽出する 統計データ の設定の識別子です。統計データの設定はプレイヤーのスコアを保存しており、リーダーボードではこれをプレイヤーのランク付けに使用できます。リーダーボードを有効化する前に、必ず、同じゲームの名前空間に統計データの設定を作成してください。
リーダーボードのライフサイクル
指定された期間中、プレイヤーは得点を稼いで互いに競い合い、その進行が追跡されて、リーダーボードに表示されます。
リーダーボードには、5 つのライフサイクルのうちいずれかが設定されます。
全期間
全期間のリーダーボードには期間の制限がなく、リーダーボードが有効化されて以降のゲーム内のパフォーマンスすべてに基づいてプレイヤーをランク付けします。プレイヤーのスコアが増え続けるのにつれて、このリーダーボードが更新されます。
毎日
毎日のリーダーボードでは、24 時間のパフォーマンスに基づいてプレイヤーをランク付けします。ゲーム管理者は開始時刻を設定できます。リーダーボードは 24 時間後にリセットされ、その後プレイヤーは次の 24 時間でリーダーボードの順位を争う新たなチャンスを得ます。
毎週
毎週のリーダーボードは、7 日間のパフォーマンスに基づいてプレイヤーをランク付けします。ゲーム管理者は、期間の開始日時を設定できます。リーダーボードは 7 日後にリセットされ、その後プレイヤーは次の 7 日間でリーダーボードの順位を争う新たなチャンスを得ます。
毎月
毎月のリーダーボードは、1 か月間のパフォーマンスに基づいてプレイヤーをランク付けします。ゲーム管理者は開始日時を設定できます。リーダーボードは翌月の同日同時刻にリセットされ、その後プレイヤーは翌月にリーダーボードの順位を争う新たなチャンスを得ます。
シーズン
シーズンのリーダーボードは、カスタムの特定期間のパフォーマンスに基づいてプレイヤーをランク付けします。このタイプのリーダーボードでは、開始と終了の両方のタイミングを設定します。
開始日
統計データサービスがパブリッシュした、比較しランク付けする値を、リーダーボードが受信し始める正確なタイミングです。
順序
順序では、リーダーボードの表示を昇順にするか降順にするかを選択できます。
リーダーボードの更新フロー
このセクションでは、リーダーボードサービスをユーザーの統計データと統合する方法を説明します。以下のフローを理解することで、サービスの最適な使用方法を簡単に理解できます。
リーダーボードサービスは、特定の統計データイベントをリッスンします。ユーザーの統計データが更新されるたびに、統計データサービスがイベントをパブリッシュし、リーダーボードサービスがこれを受信します。イベントのデータはリーダーボードに追加され、ユーザーランキングがソートされます。