排行榜

参考名称

你必须为每个排行榜提供的内部名称。你可以使用此名称在 App Store Connect 中搜索排行榜。

排行榜 ID

你为排行榜指定的字母数字标识符。此 ID 不得超过 100 个字符（假定使用单子节字符）。请注意，排行榜 ID 等同于 GameKit API 中的“category（类别）”。排行榜 ID 为永久性设置，因此设定之后无法进行编辑。

排行榜描述

一段简短描述，旨在帮助玩家了解应如何登上排行榜。

分数格式

你希望此 App 的分数在排行榜中呈现的格式，例如 integer（整数）、elapsed time（用时）或 money（金额）。

分数范围

使用 64 位带符号整数的分数范围。此属性的值必须介于 long min (-2^63) 和 long max (2^63 - 1) 之间。超出此范围的分数将被删除。分数范围值可不填；但如果添加分数范围，则必须设置两个值，并且二者不能相等。首次添加分数范围或者将来缩小分数范围以限制数据时，该范围以外的所有数据将被删除，并且无法恢复。

分数提交类型

要显示在排行榜中的玩家分数：“最高分数”或“最新分数”。

排列顺序

分数的排列顺序。可选择“从低到高”或“从高到低”。如果你希望首先显示最低分数，请选择“从低到高”。如果你希望首先显示最高分数，请选择“从高到低”。

开始日期和时间¹

排行榜开始发布分数的日期和时间，基于协调世界时（UTC）。

持续时间¹

分数发布在此排行榜上的时长。

刷新间隔¹

此排行榜重置分数的频率。

本地化语言

排行榜的显示语言。至少需要指定一种语言。

显示名称

排行榜在指定语言中的显示名称。

排行榜描述

一段简短描述，旨在帮助玩家了解应如何登上排行榜。

分数格式后缀

此后缀将以单数形式添加到显示的分数之后（简体中文不区分单复数）。可不提供后缀，但该信息有助于说明排行榜中储存的分数类型。单数后缀示例：“point（点数）”、“coin（金币）”及“hit（命中）”。

分数格式后缀（复数）

此后缀将以复数形式添加到显示的分数之后（简体中文不区分单复数）。可不提供后缀，但该信息有助于说明排行榜中储存的分数类型。复数后缀示例：“points（点数）”、“coins（金币）”及“hits（命中）”。

分数格式

此属性决定排行榜如何针对每种指定语言显示分数。例如，如果分数格式为金钱，则你可能需要根据不同语言来指定不同类型的金钱。你为排行榜设置的分数格式类型会自动应用到所有语言，但你也可以为不同语言指定不同类型的分数格式。此属性可不填。

图像

代表排行榜的本地化图像。图像必须为 .jpeg、.jpg 或 .png 文件，1024 x 1024 像素，至少 72 ppi，并使用 RGB 色彩空间。此属性可不填。

经典

此类排行榜上的分数数据永远不会重置，除非排行榜被删除。

周期性

周期性排行榜会根据你的偏好设置不断重置。

联合

此类排行榜汇总多个单个排行榜的玩家分数并统一排名。

附加

与其他排行榜联合的单个排行榜，即联合排行榜的构成部分。