CCU 追踪

您可使用同时在线人数 (CCU) 追踪功能查看有多少玩家同时连接到您的 zeuz 游戏服务器。

一经启用,您即可在 zeuz 控制面板KPI 页面上查看 CCU 数据。

前期准备

在启用 CCU 追踪功能之前,请确保您已完成如下操作:

集成您的游戏和 A2S 协议

如需使用 CCU 追踪功能,您可使用以下两种方法在游戏服务器进程中用 A2S (Steam 标准查询协议) 暴露 CCU 数据:

  • 如果您使用 Steam SDK虚幻引擎 Steam 在线子系统,您的 CCU 已暴露给 A2S。
  • 如果您不使用 Steam SDK 或 虚幻引擎 Steam 在线子系统,您必须把 CCU 直接暴露给 A2S。请联系您的 zeuz 账号经理了解更多信息。

如果您不确定是否已连接到 A2S,可用下述方法检查:

小贴士:检查您是否能使用 CCU 追踪功能

启用 CCU 追踪功能需要用到 A2S 协议。您可使用以下步骤检查 A2S 是否能连接到负载:

  1. 下载并安装 qstat 命令行实用程序。

    LinuxUbuntu qstat (下载链接在页面顶部)

    Windowsqstat 下载

  2. 进入 zeuz 控制面板的 Payloads (负载) 页面,查看 Reserved payloads (已分配负载),并记录下所有已分配负载的 IP 地址及其端口映射。

  3. 在命令行中运行 qstat 命令,该命令使用 A2S 协议尝试连接到指定的 IP 地址和端口,并以 XML 格式返回结果。

    ./qstat -xml -a2s <ipaddress:port>

    例如: ./qstat -xml -a2s 200.100.180.50:32082

    成功的 A2S 连接会返回如下示例的结果,其中包括游戏类型、玩家数量、和最大玩家数。

<qstat>
  <server type="A2S" address="200.100.180.50:32082" status="UP">
      <hostname>200.100.180.50</hostname>
      <name>My_zeuz_game</name>
      <gametype>My_game_type</gametype>
      <map>Precinct</map>
      <numplayers>7</numplayers>
      <maxplayers>32</maxplayers>
      <numspectators>0</numspectators>
      <maxspectators>0</maxspectators>
      <ping>127</ping>
      <retries>0</retries>
  </server>
</qstat>

A2S 连接失败则返回 status="TIMEOUT"

  1. 如果连接失败但该 IP 地址还有其他的映射端口,请用其他映射端口重试该命令。

如果您使用该命令尝试了已分配负载的 IP 地址和它的全部端口映射,但 A2S 连接尝试无一成功,则您无法使用 CCU 追踪功能。

在配载的 Command 字段中添加 statsPort 变量

如需使用 CCU 追踪功能,您必须将 statsPort 变量添加到配载配置的 Command (命令) 字段。

statsPort 变量将端口配置传给您的游戏,并允许端口传输同时在线玩家的信息。

如需更多信息,参见 命令 配置说明。

启用 CCU 追踪功能

在创建配载时,您可以启用 CCU 追踪功能。前往 zeuz 控制面板的 Allocations (配载) 页面 (路径:Orchestration > Allocations),点击 +ADD ALLOCATION 创建配载。更多信息,参见 创建配载

Payload definition (负载定义) 部分,找到 CCU 追踪的下拉菜单。

CCU 追踪功能默认为禁用。要启用它,请选择以下选项之一:

  • Private:仅 zeuz 可访问您的 CCU 追踪数据。

  • Public:对 CCU 追踪数据的访问不做限制。如您需要同时允许 zeuz 和 Steam 访问该数据,请选用该选项。

    注意:A2S 协议不支持身份认证功能。

查看 CCU 追踪数据

启用 CCU 追踪后,新启动的负载会上报追踪信息,已启动的负载则不会。

前往 zeuz 控制面板中的 KPI 页面,您可查看您游戏的同时在线玩家数据。更多信息,请参阅 KPI : CCU


2020年3月4日 该文档已更新并通过审校

2020年12月14日 该文档已创建并通过审校


最近更新时间: October 20, 2021 (8d51a796)