Leaderboard

App Store Connectでは、Leaderboardのメタデータによって、各Leaderboardを定義し、スコアに関する概要を記載し、表示に使用される言語固有のテキストを管理できます。また、Leaderboardのタイプを追跡し、アプリでライブ状態になっているかどうかを示す承認ステータスも表示することもできます。

「Leaderboardの管理」にある説明のとおり、アプリの「Game Center」ページの「Leaderboard」セクションで以下のプロパティを設定します。

Leaderboardのプロパティ

主要なLeaderboardのプロパティは、App Store Connectの各Leaderboardを識別します。これらのプロパティは、スコアの編成とフォーマット形式を示します。

プロパティ	説明
参照名	インターナルネーム。各Leaderboardに入力する必要があります。App Store ConnectでLeaderboardを検索する場合に使用する名前です。
Leaderboard ID	Leaderboardに選択する英数字の識別子。このIDは100文字以内に制限されています(シングルバイト文字を前提としています)。Leaderboard IDはGame Kit APIの「カテゴリ」に相当します。Leaderboard IDは永続的な設定であるため、後に編集することはできません。
Leaderboardの説明	このLeaderboardにランクインするためにプレイヤーが何をすべきかを理解するために役立つ、短い説明文。
スコアのフォーマット	このアプリのスコアをLeaderboardで表す形式の種類 (整数、経過時間、お金など)。
スコアの範囲	64ビット符号付き整数を使用したスコア範囲。値は、long型の最小値(-2^63) とlong型の最大値(2^63 - 1)の間でなければなりません。この範囲外のスコアはすべて削除されます。スコア範囲の値はオプションですが、追加する場合は、両方の値を設定する必要があり、同じ値にはできません。最初にスコア範囲を追加するとき、または将来より小さい範囲に変更しデータを制限する場合、範囲外のデータはすべて失われ、回復できません。
スコア送信タイプ	Leaderboardに表示するプレーヤーのスコアで、ベストスコアまたは最新のスコア。
並べ替えの順序	スコアの順序。「低い順」と「高い順」を選択します。最低スコアを最初に表示する場合は、「低い順」を選択します。最初に最高のスコアを表示する場合は、「高い順」を選択します。
開始日時¹	スコアがLeaderboardに投稿開始される日時。日付と時刻は、協定世界時(UTC)に基づいています。
期間¹	このLeaderboard上のスコアが投稿される時間の長さ。
再起動間隔¹	このLeaderboardのスコアがリセットされる頻度。

¹このプロパティは、周期Leaderboardでのみ使用できます。

Leaderboardの言語プロパティ

Leaderboardの言語プロパティは、Leaderboardの表示で使用される言語固有のテキストを収集します。少なくとも1つの言語用に、これらのプロパティを含める必要があります。

プロパティ	説明
ローカリゼーション	Leaderboardが表示される言語です。少なくとも1つの言語が定義されている必要があります。
表示名	指定された言語でのLeaderboardの表示名。
Leaderboardの説明	このLeaderboardにランクインするためにプレイヤーが何をすべきかを理解するために役立つ、短い説明文。
スコアのフォーマットサフィックス	このサフィックスは、単数形で表示されたスコアの末尾に追加されます。このサフィックスはオプションですが、Leaderboardに保存されているスコアの種類を明確にするのに役立ちます。例としては、「ポイント」、「コイン」、「ヒット」などがあります。
スコアのフォーマットサフィックス(複数)	このサフィックスは、複数形で表示されたスコアの末尾に追加されます。このサフィックスはオプションですが、Leaderboardに保存されているスコアの種類を明確にするのに役立ちます。たとえば、「ポイント」、「コイン」、「ヒット」などがあります。
スコアのフォーマット	これにより、指定した言語ごとに、Leaderboardにおけるスコアの表示方法が決まります。たとえば、通貨によるスコアを採用しているアプリの場合、選択した言語に基づき異なる通貨の種類を指定したい場合が想定されます。Leaderboardに設定したスコアフォーマットの種類は、言語別に種類を指定しない限り、すべての言語に自動的に適用されます。このプロパティはオプションです。
画像	Leaderboardを表すローカライズされた画像。画像の要件は、`.jpeg`、`.jpg`、または`.png`のいずれかのファイルフォーマットで、1024 x 1024ピクセル、最低72ppi、RGBカラースペースとなります。このプロパティはオプションです。

Leaderboardのタイプ

App Store Connectは、Leaderboardの種類ごとに異なるデータを追跡します。Leaderboardの種類によって、Leaderboardに含めるスコアが決まります。

タイプ	説明
Classic	Leaderboardが削除されない限り、スコアデータがリセットされないLeaderboard。
Recurring	周期Leaderboardは、ユーザの好みに基づいて継続的にリセットされます。
Combined	複数の単一Leaderboardのプレイヤーのスコアを組み合わせて、ランク付けするLeaderboard。
Attached	他のLeaderboardと結合された1つのLeaderboard(結合されたLeaderboardの子です)。

Leaderboardのステータス

Leaderboardのステータスは、Leaderboardが承認され、アプリで配信されたかどうかを示します。

ステータス	説明
配信中	Leaderboardはアプリで承認されました。
未配信	Leaderboardはアプリのバージョンで承認されませんでした。Leaderboardは、以前アプリに公開されていて、グループに移動し、グループに承認されていない場合も、このステータスです。