控制台、计费与限制
在租户控制台打开应用,左侧菜单的「游戏房间」页有三个标签:「接入」看开通状态和接入步骤,「房间」查看和结束房间,「用量」看每天的玩家时长。本页还说明计费方式和各项上限。
下面截图里的标注:红色是对应的服务端接口,紫色是控制台的行为,绿色是操作入口。
开通
打开「游戏房间」页时,控制台检查你的应用能否使用:
| 看到的提示 | 原因 | 怎么办 |
|---|---|---|
| 正常的「接入」页 | 已经可以使用 | 按页面上的三步接入 |
| 当前套餐不含游戏房间 | 套餐没有「游戏房间」功能 | 点「查看套餐」升级到包含该功能的套餐 |
| 游戏房间暂未开放 | 平台还没有开放游戏房间 | 联系客服 |
| 本应用的游戏房间已被平台关闭 | 平台单独关闭了这个应用 | 联系客服 |
| 应用当前不可用 | 应用被停用或欠费 | 处理应用状态后再来 |
| 暂无可用的游戏大区 | 平台正在部署游戏节点 | 稍后刷新 |
只有可以使用时才显示「房间」和「用量」标签。
接入
「接入」页显示:
- 可用大区:建房时可以选的大区,标「默认」的是不指定大区时用的那个;
- 额度:同时进行的房间数、每个房间的人数、每局最长时长;
- 当前用量:进行中的房间数和在线玩家数;
- 三步接入及完成状态:① 你的服务端创建过房间;② 有玩家成功连上过游戏节点;③ 有启用的回调地址订阅了
game_room.closed。三步都完成后,说明可以收起; - 示例代码:服务端和客户端的示例,已填入你的应用和默认大区。

查看和结束房间
「房间」标签按「进行中」「已结束」「全部」列出房间,可以按房间 ID 或名称的前缀搜索。点「详情」查看房间的设置、在座的成员(在线状态、连接方式、延迟、在线时长)和结束原因,进行中的房间会自动刷新。


admin 及以上的成员可以结束进行中的房间:填写原因并重新验证身份后,房间以 closed_by_console 结束,玩家收到结束通知,你的服务端收到 game_room.closed(result 为 null)。developer 只能查看。控制台不能移出单个玩家,移出用服务端接口。

用量
「用量」标签按天显示最近 7、30 或 90 天的:
| 指标 | 说明 |
|---|---|
| 玩家时长 | 所有玩家连接游戏节点的时间合计(分钟),计费的依据 |
| 房间数 | 当天开局的房间数 |
| 峰值同时进行 | 当天同时对局中的房间数最大值 |
| 平均延迟 | 按在线时长加权的平均往返延迟 |
| 流量 | 玩家与游戏节点之间的流量(GB) |
可以按大区查看。当天和前一天凌晨 1 点之前的数据还在统计中,以斜纹显示,之后才定稿。

计费
| 项 | 规则 |
|---|---|
| 计量单位 | 玩家分钟:每个玩家连接游戏节点的时间。拿到座位但没有连上、断线期间不计 |
| 按天汇总 | 每个应用每天:所有大区、所有玩家的在线毫秒数相加,再按分钟向上取整 |
| 单价 | 以你的套餐为准,见控制台「套餐与用量」 |
| 流量 | 只统计,目前不计费 |
| 定稿 | 前一天的用量在当天凌晨 1 点之后定稿,定稿后计入账单 |
例如一局 4 人对战 20 分 30 秒,每人都全程在线:玩家时长为 4 × 20.5 = 82 分钟。
game_room.closed 回调里每个玩家的 billable_minutes 是这一局按人向上取整的分钟数,方便你给玩家计时和核对;账单按天汇总后取整,所以逐局相加的结果可能比账单略多。
限制
| 项 | 上限 |
|---|---|
| 每个房间的人数 | 10 |
| 同时进行的房间数(每个应用) | 由平台设置,见「接入」页的额度;超过时建房返回 open_rooms |
| 每局最长时长 | 默认 3600 秒,可设 60 秒到平台上限(见「接入」页) |
| 断线重连窗口 | 0–300 秒,默认 60 |
| 加入票据 | 每次最多 10 人,有效期 30–600 秒,默认 120 |
| 拿到座位后连上节点 | 60 秒内,否则以 connect_timeout 离开 |
| 房间无人 | 所有人离开或断线,超过重连窗口后再过 60 秒自动结束 |
ext / result | 2KB / 4KB |
每帧操作 sendInput | 128 字节;每个座位每秒不超过帧率的 2 倍次 |
自定义消息 sendCustom | 1KB;每个座位每秒 60 条、32KB |
快照 putSnapshot | 64KB;间隔不小于房间设置的一半 |
| 帧率 | 10、15、20、30、60 |
操作和自定义消息超过频率时,多出的被游戏节点丢弃;连续 10 秒超过时,这个玩家被移出房间。
