游戏盾SDK中包含两个核心函数,分别是initEx和GetProxyTcpByDomain。本文介绍了核心函数的作用和参数描述。

initEx

initEx用于初始化SDK,在首次使用SDK时调用。如果返回值不是0,建议循环调用一直到成功。

initEx的参数描述如下。

名称 说明
access_key 游戏盾接入身份密钥。从游戏盾管理控制台下载。具体操作,请参见获取SDK和AccessKey
token 游戏内的玩家标识。发生DDoS攻击时定位恶意玩家或黑客使用,如果未定义可以设置为Default

GetProxyTcpByDomain

GetProxyTcpByDomain函数用于获取回传IP和随机端口,使用同步阻塞的方法。

GetProxyTcpByDomain函数的特性说明如下。

  • 在单次App启动后的生命周期内,同样的参数返回的IP和端口结果相同。
  • 单次调用转化后的IP和端口在本次App生命周期内不会变化,IP和端口会自动检查是否可用,自动进行节点切换。
  • App重新启动后,获取的IP和端口会发生变化。
  • 函数返回的Target_ip是固定的127.0.0.1,您也可以动态获取此函数的返回结果。

GetProxyTcpByDomain的参数描述如下。

名称 说明
Token 游戏内的玩家标识。发生DDoS攻击时定位恶意玩家或黑客使用,如果未定义可以设置为Default。
GroupName 游戏业务对应的节点组标识,例如:access.v812vCOE21.aliyundoc.com。在游戏盾控制台添加游戏和业务时需要配置节点组,根据游戏同时在线用户规模分配独享节点数量。一个游戏对应多个节点组。
Dip 防护目标标识,需要转化的远端服务器的IP,在游戏盾无限抗防护目标处配置获取。
Dport 服务器的业务端口,按实际需要传入,无需在游戏盾中配置。
target_ip 返回的IP,固定为127.0.0.1。
target_port 返回的随机端口。