想读取英雄联盟客户端状态、做本地查询小工具,核心是调用 LCU(League Client Update)本地接口;按下面五步,你能从零连通并验证。
准备:先明确能做什么、不能做什么
- LCU 是英雄联盟客户端启动后在本地提供的 HTTPS 接口,供客户端和授权工具通信;它只监听本机,不是公开开放平台。
- 适合做只读查询:当前登录召唤师、游戏流程阶段、选人会话是否开始。不要用它自动接受对局、自动选人、修改对局结果,既容易违反规则,也会因接口变动失效。
- 需要已登录的客户端、能读本地文件的脚本环境、可发 HTTPS 请求的工具。接口没有公开稳定文档,版本更新后路径和字段可能变化。
第一步:找到 lockfile,拿到端口和密码
- 先启动并登录客户端,保持运行。客户端关闭后 lockfile 会被删除,接口也不可用。
- 在安装目录根部找 `lockfile`;Windows 通常在 League of Legends 文件夹,macOS 可在应用包内查找。找不到时,从客户端进程启动参数看 `--app-port` 和 `--remoting-auth-token`。
- 内容形如 `LeagueClient:进程号:端口:密码:https`,字段用冒号分隔。端口和密码每次启动都可能变化,必须现读现用。
- 判断标准:能读出进程号、端口、密码、协议四项,协议为 `https`;文件为空或不存在,先确认是否完全登录。
第二步:用 Basic Auth 发起本地 HTTPS 请求
- 地址是 `https://127.0.0.1:端口/接口路径`,不要用 `http://`。用户名固定为 `riot`,密码填 lockfile 里的密码,按 Basic Auth 编码后放入 `Authorization` 头。
- 本地证书是自签的,普通客户端会报证书错误。只在访问 127.0.0.1 时跳过证书校验,不要把这个设置带到其他请求。
- 可用 curl 试:`curl -k -u riot:密码 https://127.0.0.1:端口/lol-summoner/v1/current-summoner`。返回 JSON 且含当前账号信息,说明认证和连通正常。
- 判断标准:200 为通;401 多为密码错或用户名不对;连接被拒绝多为端口错或客户端没开;证书报错是没跳过本地自签证书。
第三步:选对接口,按游戏阶段查询
- 查当前账号:`/lol-summoner/v1/current-summoner`,返回当前登录召唤师基础信息。登录后一般都能访问,适合做连通性验证。
- 查流程阶段:`/lol-gameflow/v1/gameflow-phase`,常见值有 `None`、`Lobby`、`Matchmaking`、`ReadyCheck`、`ChampSelect`、`InProgress`。先用它判断上下文,再决定查什么。
- 查选人会话:`/lol-champ-select/v1/session`,只在选人阶段有数据。不在选人阶段返回 404 是正常现象。
- 轮询控制在 1–2 秒一次,只取需要字段并缓存。判断标准:进入大厅、匹配、选人时阶段值能变化;一直不变就检查是否用了旧端口。
验证与常见坑
- 验证顺序:先请求 current-summoner 确认 200,再请求 gameflow-phase 看阶段,最后在选人时请求 session。三步都符合预期,才算跑通。
- 坑一:把密码写死在代码里。客户端重启后密码会变,每次运行都重新读 lockfile。
- 坑二:把 404 当断连。部分接口只在特定阶段存在,先用阶段接口判断。
- 坑三:把本地接口暴露到公网或局域网。它只适合本机使用,不要转发端口,也不要把密码发给别人。
- 坑四:忽略合规与稳定性。只做只读展示和辅助查询,别碰自动对局操作;升级后以实际返回为准。
先跑通 current-summoner,再按阶段扩展查询;只做本地只读工具,别硬编码密码,也别用于自动对局操作。
