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

请参见 Web API 概览,了解更多有关使用 Steamworks Web API 的信息。

GetGlobalAchievementPercentagesForApp

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

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

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
  • 第 2 版 - 从数组中移除元素名称。

GetGlobalStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
名称类型是否必需描述
keystringSteamworks Web API 发行商验证密钥。
appiduint32要获取全局统计的 AppID。
countuint32要为其获取数据的统计项目的数量。
name[0]string要为其获取数据的统计项目的名称。
startdateuint32每日总数的开始日期(unix 时间戳)
enddateuint32每日总数的结束日期(unix 时间戳)

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

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

GetNumberOfCurrentPlayers

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

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

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

GetPlayerAchievements

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

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

GetSchemaForGame

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

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

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
  • 第 2 版 - 修复了以 XML 格式返回游戏名称的问题。

GetUserStatsForGame

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

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

此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
  • 第 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 必须通过安全服务器调用,且绝不能由客户端直接调用!