成就(Achievement)模块允许开发者让用户解锁成就,清除成就,以及判断某个成就是否已经解锁。也允许根据根据进度获得成就。
默认情况下,成就在持久化文件中存储信息。如果Steam平台支持可用并且被启用,成就信息会自动与Steam同步。
achievement.
Sync
() link调用achievement.sync()函数的行为。只有当成就未同步的情况下才可用。
achievement.
clear
(name) link清除名为 name 的成就。
achievement.
clear_all
() link清除所有成就。
achievement.
grant
(name) link解锁名为 name 的成就,前提是该成就尚未解锁。
achievement.
has
(name) link如果用户已经解锁成就 name 就返回True。
achievement.
progress
(name, complete) link报告成就 name 的完成进度,前提是该成就未解锁。成就 name 必须先定义各完成度。
achievement.
register
(name, **kwargs) link注册一个成就。成就并不强制需要注册,但这样做可以将成就信息传给后端。
下列关键词参数是可选的。
achievement.
sync
() link同步本地存储和其他后端(例如,Steam)的注册成就。
控制成就的配置项包括:
achievement.steam_position
= None link若值不是None,该配置项设置steam弹出通知的位置。该值必须是一个字符串,可使用的内容包括“top left”,“top right”,“bottom left”和“bottom right”。
config.steam_appid
= None link若非None,该项应是Steam appid。Ren’Py会在启动时自动设置此appid。需要使用define语句设置该项。
define config.steam_appid = 12345