Steamworks 文献库
ISiteLicenseService 接口
提供权限,以访问与参与 Steam 网吧计划的运营站点相关的服务。

GetCurrentClientConnections

GET https://api.steampowered.com/ISiteLicenseService/GetCurrentClientConnections/v1/
名称类型是否必需描述
keystringSteamworks Web API 发行商验证密钥。
siteiduint64要看到的站点 ID;零为所有站点。

查看一个或多个站点的当前活动。

响应具有以下结构:

名称类型描述
sites见下方站点详情列表
game_names见下方游戏名称的映射列表。

game_names 具有以下结构:

名称类型描述
iduint32条目的 ID 号;在下方的站点信息中引用
namestring游戏名称

sites 具有以下结构:

名称类型描述
siteiduint64站点的 64 位 SiteID
site_namestring您为站点分配的站点名称
clients见下方站点活跃客户端列表

clients 具有以下结构:

名称类型说明
ip_addressstring客户端电脑的 IP 地址
hostnamestring客户端电脑的机器名称
games见下方客户端电脑上的活跃游戏会话列表

games 具有以下结构:

名称类型描述
iduint32响应中 game_names 部分的游戏 ID
start_timestring此游戏会话开始的时间(RFC 3339 UTC 格式)
license_typestring见下方

license_type 可能具有以下的值之一:

描述
user用户拥有游戏许可
commercial用户正在通过应用至该站点的付费商用许可进行游戏
free用户正在通过应用至该站点的免费商用许可进行游戏

GetTotalPlaytime

GET https://api.steampowered.com/ISiteLicenseService/GetTotalPlaytime/v1/
名称类型是否必需描述
keystringSteamworks Web API 发行商验证密钥。
start_timestring报告此时或之后开始的活动。 RFC 3339 UTC 格式。
end_timestring报告此时之前开始的活动。 RFC 3339 UTC 格式。
siteiduint64要看到的站点 ID;零为所有站点。

获取一段时间内所有游戏的总游玩时间,可以针对一个或全部站点。

响应具有以下结构:

名称类型描述
sites见下方站点详情列表
game_names见下方游戏名称的映射列表。

game_names 具有以下结构:

名称类型描述
iduint32条目的 ID 号;在下方的站点信息中引用
namestring游戏名称

sites 具有以下结构:

名称类型描述
siteiduint64站点的 64 位 SiteID
site_namestring您为站点分配的站点名称
games见下方玩过的所有游戏的名称

games 具有以下结构:

名称类型描述
iduint32响应中 game_names 部分的游戏 ID
license_typestring根据许可类型将一款游戏的游戏时间进行划分。 请参阅上方的 GetCurrentClientConnections 一节,查看列表。
playtime_secondsuint32此游戏的此种许可类型在请求期间内的总游戏时间(以秒为单位)。