选手特工统计 (Player Agents)
获取选手的各特工竞技数据:Rating、ACS、K/D、ADR、KAST 及更多指标,支持自定义时间范围。
player.agents(player_id, timespan) 返回指定选手在 vlr.gg 上按特工分类的详细比赛竞技数据。
函数签名
player.agents(
player_id: int,
timespan: Literal["30d", "60d", "90d", "all"] = "all",
) -> AgentStatsPage参数
Prop
Type
返回值 - AgentStatsPage
Prop
Type
AgentStats 字段说明
Prop
Type
示例
使用默认时间范围查询特工统计
import vlrdevapi
stats = vlrdevapi.player.agents(player_id=438)
print(f"统计范围: {stats.timespan}")
if stats.agents:
for a in stats.agents:
print(f"{a.agent}: {a.rounds} 回合 | {a.rating} Rating | {a.acs} ACS | {a.kd} KD")
else:
print("未获取到该选手的特工统计数据。")筛选最近 60 天的数据
import vlrdevapi
stats = vlrdevapi.player.agents(player_id=438, timespan="60d")
if stats.agents:
for a in stats.agents:
rnd = a.rounds or 0
rat = f"{a.rating:.2f}" if a.rating is not None else "N/A"
acs = f"{a.acs:.1f}" if a.acs is not None else "N/A"
kd = f"{a.kd:.2f}" if a.kd is not None else "N/A"
adr = f"{a.adr:.1f}" if a.adr is not None else "N/A"
print(f"{a.agent:>8} | {rnd:>3}r | R={rat} | ACS={acs} | K/D={kd} | ADR={adr}")
else:
print("最近 60 天内没有找到特工比赛数据。")查找出场回合最多的招牌特工
import vlrdevapi
stats = vlrdevapi.player.agents(player_id=438, timespan="all")
if stats.agents:
most_played = max(stats.agents, key=lambda a: a.rounds or 0)
print(f"出场最多: {most_played.agent} ({most_played.rounds} 回合)")
print(f"Rating: {most_played.rating} | KD: {most_played.kd} | ACS: {most_played.acs}")
else:
print("该选手无特工数据。")柯里化链式访问
import vlrdevapi
player = vlrdevapi.player(438)
stats = player.agents(timespan="90d")
if stats.agents:
for a in stats.agents:
rnd = a.rounds or 0
rat = f"{a.rating:.2f}" if a.rating is not None else "N/A"
print(f"{a.agent}: {rnd} 回合中 Rating 为 {rat}")
else:
print("未找到该选手的特工统计数据。")最后更新于