NCMBをバックエンドとして用いたUnityのランキング機能のテンプレートアセットです。

Unity1Weekをはじめとしたゲームジャムでのランキング機能としてご活用ください。 より簡単な設定でランキング導入したい場合は、@naichilabさんのunity-simple-rankingがおすすめです。 (いつもありがとうございます！)

• Unity Version: 以下のバージョンにて動作確認済みです。

  • 2020.3.8f1(LTS)
  • 2020.3.21f1(LTS)
  • 2021.3.1f1(LTS)

• TextMeshProを使用しています。

• 事前にNCMBの設定が必要です。(詳しくは使用方法を参照してください)

• Prefabs
  • RankingCanvas.prefab: 以下のPrefabが入っているCanvas
    • RankingPanel.prefab: ランキングデータが表示されるパネル
    • RankingFetcher.prefab: ランキングデータを取得するボタン
    • ScoreSender.prefab: スコアをデータベースに送信するボタン
    • NameForm.prefab: ユーザ名設定用の入力フォーム
  • RankingRecord.prefab: データレコード用のPrefab
• Sample
  • Ranking.unity: サンプルシーン
• Scripts
  • RankingManager.cs: ランキングのデータ操作を行うためのクラス
  • ScoreSender.cs: スコアをデータベースに送信するためのクラス
  • NameForm.cs: ユーザ名設定用のクラス
  • RankingRecord.cs: データレコード用のクラス
  • RankingUtils.cs: ランキング用のキーなどを管理するstaticクラス

• 好きなタイミングでランキングデータを保存できます。
• 自身のランキングデータの色をカスタマイズできます。
• 順位に応じて、バッジの素材、色、サイズをカスタマイズできます。
• スコアが同じユーザは同じ順位になります。
• ユーザが自身の名前を自由に変えることができます。

1. ニフクラ mobile backend クイックスタートに沿って「APIキーの設定とSDKの初期化」まで設定を行います。
2. NCMBのアプリケーション管理画面の「データストア」から新しいクラスを作成します。(クラス名は任意です)
3. 「クラスの編集」から、フィールドを追加します。 設定したフィールド名は RankingUtils.cs に記載されたキーと対応しています。追加でデータを保存したい場合は、RankingUtils.csにも追記が必要です。

• UniqueUserId: ユーザの一意ID(自身のデータの色を変更するために必要です)
• HighScore: ハイスコアデータ
• UserName: ユーザー名

1. Releasesよりunitypackageをダウンロードし、Unityにインポートします。
2. RankingUtils.cs のNCMBStorageKeyを 2. で設定したクラス名にします。

// NCMBのデータストアキー 
 internal static readonly string NCMBStorageKey = "UnityCustomRanking"; 

3. RankingCanvas.prefabをシーンに配置します。

ボタンクリックでRankingPanelを開き、取得したランキングデータを表示します。

入力フォームにユーザ名を入力し、Saveボタンを押すことでユーザ名を更新します。 データベースも更新されます。確認するにはRankingFetcherを押してください。

インスペクターで設定されたスコアデータをデータベースに送信します。 スコア更新(現状のスコアよりハイスコア)がない場合は上書きされません。

A: データを保存したいタイミングで RankingManager.SendRankingを呼んでください。

A: RankingManager.ChangeNameを呼ぶことでローカルとデータベース上のユーザ名を変更できます。スコア送信の際にはローカル(PlayerPrefs)に保存されたユーザ名に紐付けてスコアを送信しています。そのため、スコア送信以前にユーザ名が設定されていなかった場合はデフォルト名で登録されます。

RankingCanvasはあくまで実装例なので自由にカスタマイズしてください。 質問や不具合報告などお気軽にご連絡ください！