排行榜

排行榜元数据标识 App Store Connect 中的每个排行榜，描述分数属性，并收集不同语言的文本用于显示排行榜信息。App Store Connect 跟踪不同类型排行榜的元数据，并显示排行榜的状态，以说明该排行榜是否已通过审核并随 App 上线。

请根据配置排行榜所述，在“Game Center”页面的“排行榜”部分中为 App 设置这些属性。

排行榜属性

以下为主要的排行榜属性，用于标识 App Store Connect 中的每个排行榜。这些属性描述分数的整理方式与格式。

属性	描述
参考名称	你必须为每个排行榜提供的内部名称。你可以使用此名称在 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 dpi，并使用 RGB 色彩空间。此属性可不填。

排行榜类型

App Store Connect 为不同类型的排行榜追踪不同的数据。排行榜类型决定了排行榜包含的分数类型。

类型	描述
经典	此类排行榜上的分数数据永远不会重置，除非排行榜被删除。
循环	循环排行榜会根据你的偏好设置不断重置。
联合	此类排行榜汇总多个单个排行榜的玩家分数并统一排名。
附加	与其他排行榜联合的单个排行榜，即联合排行榜的构成部分。

排行榜状态

排行榜状态指示排行榜是否已通过审核并随 App 上线。

状态	描述
已上线	排行榜已随 App 通过审核。
未上线	排行榜所属的 App 版本尚未通过审核。如果排行榜随 App 上线后被移至群组，但尚未随群组通过审核，排行榜也会呈现此状态。