Matchvs多节点功能正式版上线

 

众所周知，部分游戏类型（如 fps 类，格斗类，竞速类等）对于延迟容忍极低，远节点连接会使玩家游戏体验很差，本着为用户提供高质量服务的态度，Matchvs开放了自选多节点服务，开发者可以根据游戏要求给游戏开通该服务。

本次为用户开放了3个节点，分别是北京、上海和广州，用户可自行选择较近的节点。

以下是多节点服务的功能说明和注意事项，感兴趣的用户可自行了解。

开通多节点服务后，可以实现：

1. 由玩家根据节点延迟情况，手动切换节点进行游戏
2. 游戏里可以根据匹配情况，自动做节点切换策略

需要注意的是，玩家会在各个节点分别进行匹配。如果您游戏玩家数量过少，您可以在游戏自动做节点切换策略。这样可以保障匹配成功率的前提下，保障低延时

如果您的游戏对延时要求不高（如棋牌，回合制游戏等），不建议您开启多节点服务。

如需开启多节点服务，可以前往控制台 - 游戏列表 - 设置：

成功启用后，即可对接 SDK 多节点功能，gameServer 无变化。

在 Matchvs SDK中 使用接口获取节点信息，并切换到指定的节点。

如需开启多节点服务，可以前往控制台 - 游戏列表 - 设置：

注意：SDK v3.7.9+ 开放多节点功能

init

init 接口和之前的 init 接口是同一个，这里只是在 init 接口中新增了一个参数 threshold，只有传了该参数，才能获取节点列表和使用指定节点登录。参考init接口说明

getNodeList

获取节点列表信息。在 init 成功后才能使用，并且init 一定要传入 threshold参数。不然返回值为 null。

engine.getNodeList()

无请求参数

返回值

属性	类型	描述	示例
nodeID	number	节点ID	1
area	string	节点区域名称	中国1区-华南
latency	number	延迟，单位 毫秒（ms）	10

login

登录接口和前面 API文档描述的登录接口是同一个，login接口说明 。只是加了一个 nodeID 参数，如果不传这个参数或者传入的参数为0，login 则使用默认节点登录。否则会使用指定的 nodeID登录，nodeID 必须是从 getNodeList 接口获取的有效ID。

changeNode

切换到指定节点中，切换节点只能在拥有多个节点的情况下使用，并且只能切换到 getNodeList 获取到的节点中。所有在 init 的时候设置好 threshold 参数。

切换节点是指在使用 login 接口登录了默认节点后，想换一个节点就可以使用 changNode 接口切换到指定节点，所以，要使用 changeNode 接口必须是在登录后。

engine.changeNode(args)

args 的属性

参数	类型	描述	示例
nodeID	number	从 getNodeList 获取的信息	1

返回值参考 错误码说明