UnityCustomRankingTemplate

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クラス

特徴

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

使用方法

バックエンド(NCMB)の設定

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をシーンに配置します。

RankingCanvas内のPrefabについての説明

RankingFetcher

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

NameForm

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

ScoreSender

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

Q & A

Q: 特定のタイミングでスコアを保存するにはどうすればよいでしょうか？

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

Q: 一度保存したユーザ名は変更できますか？

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

その他

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