Steamworks 文献库
ISteamUserStats 接口
用于访问关于用户的信息。

请参见 Web API 概览,对如何使用 Steamworks Web API 了解更多。

GetGlobalAchievementPercentagesForApp

获取 https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
名称类型是否必需描述
gameiduint64要获取成就百分比的 GameID。

为指定应用获取全局成就百分比。

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。

  • Version 2 - 从数组中移除元素名称。

GetGlobalStatsForGame

获取 https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
名称类型是否必需描述
appiduint32要获取全局统计的 AppID。
countuint32要获取数据的统计的数量。
name[0]string要获取数据的统计的名称。
startdateuint32每日合计的开始日期(unix 时间戳)
enddateuint32每日合计的结束日期(unix 时间戳)

为指定应用获取全局统计数据百分比。

参见 全局统计 文档了解更多信息。

GetNumberOfCurrentPlayers

获取 https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
名称类型是否必需描述
appiduint32要获得用户数量的 AppID。

获得指定应用当前在 Steam 上的活跃玩家的总数量。

注意,这不会返回正在玩但未连接至 Steam 的玩家。

GetPlayerAchievements

获取 https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
名称类型是否必需描述
keystringSteamworks Web API 用户验证密钥。
steamiduint64用户的 SteamID。
appiduint32要获取成就的 AppID。
lstring返回字符串的语言。

获得指定用户在一个应用中已解锁的成就列表。

GetSchemaForGame

获取 https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
名称类型是否必需描述
keystringSteamworks Web API 用户验证密钥。
appiduint32游戏的 appid。
lstring返回的本地化语言(english、french 等)。

获得指定游戏的统计与成就的完整列表。

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。

  • Version 2 - 修复用 XML 返回游戏名称。

GetUserStatsForGame

获取 https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
名称类型是否必需描述
keystringSteamworks Web API 用户验证密钥。
steamiduint64用户的 SteamID。
appiduint32游戏的 appid。

获得指定用户在一个应用中设置的统计列表。

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。

  • Version 2 - 修复用 XML 返回游戏名称。

SetUserStatsForGame

POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
名称类型是否必需描述
keystringSteamworks Web API 发行商验证密钥。
steamiduint64用户的 SteamID。
appiduint32游戏的 appid。
countuint32要设置值的统计与成就的数量(名称/值参数对)。
name[0]string要设置的统计与成就的名称。
value[0]uint32要设置的值。

为游戏设置指定用户的统计。

注意: 此调用要求拥有指定 App ID 的发行商 API 密钥才能使用此方法。 因此,此 API 必须通过安全服务器调用,且绝不能由客户端直接调用!