Skip to Content
VLRdevAPI

选手特工统计 (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("未找到该选手的特工统计数据。")

最后更新于

本页内容