作者:崔毅然
在这篇文章中,我们使用 LeanCloud 作为后端来实现游戏内的账户系统。这篇文章以 Unity 游戏引擎中的 C# 语言为示例,主要讲解如何实现几种主流的登录方式,包括游客登录、游客账号升级、手机号验证码登录、用户名密码注册及登录。
接入 SDK
首先要接入 LeanCloud 的 SDK,接入方式可以参考文档。
游客登录
为了让玩家尽快体验游戏,每一个游戏都会有游客登录的功能。游客登录在 LeanCloud 中可以这样来实现:
var user = await AVUser.LogInAnonymouslyAsync();
复制代码
调用上述代码成功后,LeanCloud 会自动生成一个游客用户登录,进入「控制台」 - 「存储」-「_User」表就可以看到表中新增了一条数据。在客户端登录的游客信息会一直被 SDK 存在本地,直到玩家删除游戏或主动退出登录。但就像所有游戏中的游客登录一样,当该游客退出登录后会丢失自己全部的游戏数据,为了保存游戏数据,需要将游客账号升级为正式账号。
游客账号升级
为了不丢失玩家的数据,我们会在游戏内建议玩家升级账号为正式玩家。例如绑定微信登录、绑定用户名密码及手机号,绑定成功后玩家就能以正式的登录方式获取到自己的游戏数据。
升级为微信登录
假设我们已经通过某些方法(例如使用 ShareSDK)拿到了微信的 openId、access_token、unionId 等,可以这样在 LeanCloud 中将游客账号关联到微信登录中:
var authData = new Dictionary<string, object> {
{ "access_token", "ACCESS_TOKEN" },
{ "expires_in", 7200 },
{ "openid", "OPENID" },// openId 是用户在当前微信应用下的唯一 Id
};
// unionId 是用户在整个微信内的唯一 Id
var unionId = "ox7NLs06ZGfdxbLiI0e0F1po78qE";
AVUserAuthDataLogInOption options = new AVUserAuthDataLogInOption
{
UnionIdPlatform = "weixin",// 这里指定用微信平台
AsMainAccount = true
};
var user = AVUser.CurrentUser;
// 绑定微信登录,第二个参数 weixinapp1是自定义的当前微信应用的标识
await user.AssociateAuthDataAndUnionIdAsync(authData, "weixinapp1", unionId, options);
复制代码
关联成功后,玩家以后就可以用微信登录了,登录代码见下文的第三方账户登录。
绑定用户名、密码及手机号
var currentUser = AVUser.CurrentUser;
currentUser.Username = "username";
currentUser.Password = "password";
user.MobilePhoneNumber = "186xxxxxxxx";
await currentUser.SaveAsync();
复制代码
如果保存了手机号,保存成功后 LeanCloud 会自动向该手机号发送一条验证码,用户输入验证码后验证手机号:
await AVUser.VerifyMobilePhoneAsync("6位数字验证码");
复制代码
手机号码验证成功后,该玩家以后就能以手机号登录了,这样就保证了游戏数据不会丢失。
手机号+验证码登录、用户名及密码登录的代码见下文。
手机号 + 验证码登录
这种登录方式下,如果 _User 表中没有这个手机号,则视为新用户,会自动注册账号并登录;如果 _User 表中某个用户已经有了这个手机号(例如曾使用过该手机号登录,或通过游客账号升级绑定的信息),则直接登录。
首先,调用发送登录验证码的接口:
await AVCloud.RequestSMSCodeAsync("18611111111");
复制代码
然后使用验证码来登录
var user = await AVUser.SignUpOrLogInByMobilePhoneAsync("18611111111", "6位短信验证码");
复制代码
用户名 + 密码注册登录
这种是最常见的登录方式,稍微有一点麻烦的是,需要玩家记住自己的用户名和密码。
注册
如果 _User 表中没有相应的用户名密码信息,例如从未注册过,也没有通过游客升级的方式增加用户名密码,需要先注册。
var user = new AVUser();
user.Username = "Tom";
user.Password = "cat!@#123";
await user.SignUpAsync();
Debug.Log(user.Username);
登录
var user = await AVUser.LogInAsync("username", "password");
Debug.Log(user.Username);
复制代码
第三方登录
微信或 QQ 登录可以让玩家更便捷的登录游戏。利用 LeanCloud 第三方登录的模块就可以完成这种场景。
微信登录
假设现在开发者已经通过某些方法(例如使用 ShareSDK)拿到了微信的 openId、access_token、unionId 等,无需注册就可以在 LeanCloud 中直接登录。如果游客已经升级绑定了微信信息,也可以通过这种方式来登录。
var authData = new Dictionary<string, object> {
{ "access_token", "ACCESS_TOKEN" },
{ "expires_in", 7200 },
{ "openid", "OPENID" },// openId 是用户在当前微信应用下的唯一 Id
};
// unionId 是用户在整个微信内的唯一 Id
var unionId = "ox7NLs06ZGfdxbLiI0e0F1po78qE";
AVUserAuthDataLogInOption options = new AVUserAuthDataLogInOption
{
UnionIdPlatform = "weixin",// 这里指定用微信平台
AsMainAccount = true
};
// 绑定微信登录,第二个参数 weixinapp1 是自定义的当前微信应用的标识
var user = await AVUser.LogInWithAuthDataAndUnionIdAsync(authData, "weixinapp1", unionId, options);
复制代码
在 LogInWithAuthDataAndUnionIdAsync
这个方法中,第二个参数是自己定义的微信应用的名字,第三个参数 unionId 是用户在多个微信应用之间互通的唯一 id。如果我们有多个微信应用,就可以通过 unionId 登录来实现多个微信应用之间的账号互通。
其他平台
如果是其他平台,例如 facebook 是没有 unionId 的,这个时候只需要 access_token、expires_in、uid 三个自定义字段就可以了。
var authData = new Dictionary<string, object> {
{ "access_token", "ACCESS_TOKEN" },
{ "expires_in", 7200 },
{ "uid", "FACEBOOK_UID" },
};
var user = await AVUser.LogInWithAuthDataAsync(authData, "facebook");
复制代码
由于 LeanCloud 默认只支持微信、QQ、新浪微博登录,因此对 Facebook 需要额外去设置一下唯一索引,设置唯一索引的方式非常简单,只需要进入控制台,在 _User 表中选择「其他」-「索引」,将 authData.facebook.uid 建立唯一索引,并且勾选上「允许缺失值」选项,这样 Facebook 登录也完成了。