目录

playerId替换为openId方案

背景说明

为了采用更安全的OAuth 2.0协议实现游戏帐号登录,游戏服务中playerId需要逐步替换为openId。如果您当前使用playerId作为玩家的唯一标识,当前版本仍然兼容,但建议您尽快完成替换。

第一阶段:建立openId与playerId对应关系

第一阶段的替换步骤如下:

  1. 华为帐号授权成功后使用PlayersClient.getGamePlayer(boolean isRequirePlayerId)方法登录游戏,isRequirePlayerId传入true。

    从返回的Player对象中获取玩家的openId、playerId。

  2. playerId和openId的验证不再调用校验登录签名接口,修改为调用从游戏服务器获取用户标识接口,根据玩家Access Token从华为游戏服务器获取用户标识后,与PlayersClient.getGamePlayer返回的用户标识进行比对,完成一致性验证。

    只有验证成功后,您的服务器才能建立openId与playerId的对应关系。

    openId当前非固定长度,最大允许长度256,需进行三倍冗余考虑,不推荐进行长度限制。

  3. 此阶段完成后,您需要上架游戏并等待用户更新游戏后重新登录,以获取用户的openId与playerId。在第一阶段期间,如部分用户长时间不更新游戏并重新登录,您可以调用批量查询openId接口查看playerId对应的openId,便于直接建立映射关系。

    openId与playerId不能长期并存,请您尽快根据当前的用户覆盖率评估是否可以启动第二阶段。

第二阶段:以openId作为玩家标识,下线playerId

playerId与openId建立了对应关系后,您可以在新版本中进行如下修改:

  1. 将PlayersClient.getGamePlayer(boolean isRequirePlayerId)方法中的isRequirePlayerId参数传入false或将方法替换为PlayersClient.getGamePlayer(),返回的Player对象将不包含playerId、用户头像和玩家等级,用户头像可以从华为帐号授权成功后返回的AuthHuaweiId获取。玩家等级不再返回,您需要适配修改。
  2. 调用从游戏服务器获取用户标识接口验证用户标识时,不再验证playerId。
  3. 下线playerId,使用openId替换。

第二阶段完成后最终的游戏登录流程请参见游戏登录。