資料

Leaderboard

Leaderboard のメタデータは、App Store Connect の各 Leaderboard を識別し、スコアの説明と、Leaderboard の表示で使用される言語固有のテキスト収集を行います。App Store Connect はメタデータから Leaderboard のタイプを追跡します。また、Leaderboard の承認状況と App で配信中かを示すステータスを表示します。

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 は永続的な設定であるため、後に編集することはできません。

スコアのフォーマット

この App のスコアを Leaderboard で表す形式の種類 (整数、経過時間、お金など)。

スコアの範囲

64 ビット符号付き整数を使用したスコア範囲。値は、long 型の最小値 (-2^63) と long 型の最大値 (2^63 - 1) の間でなければなりません。この範囲外のスコアはすべて削除されます。スコア範囲の値はオプションですが、追加する場合は、両方の値を設定する必要があり、同じ値にはできません。最初にスコア範囲を追加するとき、または将来より小さい範囲に変更しデータを制限する場合、範囲外のデータはすべて失われ、回復できません。

スコア送信タイプ

Leaderboard に表示するプレーヤーのスコアで、ベストスコアまたは最新のスコア。

並べ替えの順序

スコアの順序。「低い順」と「高い順」を選択します。最低スコアを最初に表示する場合は、「低い順」を選択します。最初に最高のスコアを表示する場合は、「高い順」を選択します。

開始日時1

スコアが Leaderboard に投稿開始される日時。日付と時刻は、協定世界時 (UTC) に基づいています。

期間1

この Leaderboard 上のスコアが投稿される時間の長さ。

再起動間隔1

この Leaderboard のスコアがリセットされる頻度。

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

Leaderboard の言語プロパティ

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

プロパティ

説明

ローカリゼーション

Leaderboard が表示される言語です。少なくとも 1 つの言語が定義されている必要があります。

表示名

指定された言語での Leaderboard の表示名。

スコアのフォーマットサフィックス

このサフィックスは、単数形で表示されたスコアの末尾に追加されます。このサフィックスはオプションですが、Leaderboard に保存されているスコアの種類を明確にするのに役立ちます。例としては、「ポイント」、「コイン」、「ヒット」などがあります。

スコアのフォーマットサフィックス (複数)

このサフィックスは、複数形で表示されたスコアの末尾に追加されます。このサフィックスはオプションですが、Leaderboard に保存されているスコアの種類を明確にするのに役立ちます。たとえば、「ポイント」、「コイン」、「ヒット」などがあります。

スコアのフォーマット

これにより、指定した言語ごとに、Leaderboard におけるスコアの表示方法が決まります。たとえば、通貨によるスコアを採用しているアプリの場合、選択した言語に基づき異なる通貨の種類を指定したい場合が想定されます。Leaderboard に設定したスコアフォーマットの種類は、言語別に種類を指定しない限り、すべての言語に自動的に適用されます。このプロパティはオプションです。

画像

Leaderboard を表すローカライズされた画像。画像の要件は、.jpeg.jpg、または .png のいずれかのファイルフォーマットで、1024 x 1024 ピクセル、最低 72 dpi、RGB カラースペースとなります。このプロパティはオプションです。

Leaderboard のタイプ

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

タイプ

説明

Classic

Leaderboard が削除されない限り、スコアデータがリセットされない Leaderboard。

Recurring

周期 Leaderboard は、ユーザの好みに基づいて継続的にリセットされます。

Combined

複数の単一 Leaderboard のプレイヤーのスコアを組み合わせて、ランク付けする Leaderboard。

Attached

他の Leaderboard と結合された 1 つの Leaderboard (結合された Leaderboard の子です)。

Leaderboard のステータス

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

ステータス

説明

配信中

Leaderboard は App で承認されました。

未配信

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