通用注册登录

BaaS.auth 模块集合了和平台无关的用户注册登录相关操作。

注册

开发者可以使用 BaaS.auth.register(opts) API 来进行用户的通用注册。

注册成功后会自动登录，调用注册方法之前需先前往设置打开该登录方法

opts 参数说明：

名称	类型	说明
opts.username	String	用户名，username、phone 和 email 必选一个
opts.email	String	邮箱，username、phone 和 email 必选一个
opts.phone	String	手机号，username、phone 和 email 必选一个
opts.password	String	密码

邮箱中的英文字母会被强制转换为小写。例如 iFanrX@Hello.com 会被转换成 ifanrx@hello.com

示例代码

wx.BaaS.auth.register({email: 'ifanrx@ifanr.com', password: 'ifanrx123'}).then(user => {
  console.log(user)
}).catch(err=>{
  // HError 对象
})

qq.BaaS.auth.register({email: 'ifanrx@ifanr.com', password: 'ifanrx123'}).then(user => {
  console.log(user)
}).catch(err=>{
  // HError 对象
})

BaaS.auth.register({email: 'ifanrx@ifanr.com', password: 'ifanrx123'}).then(user => {
  console.log(user)
}).catch(err=>{
  // HError 对象
})

my.BaaS.auth.register({email: 'ifanrx@ifanr.com', password: 'ifanrx123'}).then(user => {
  console.log(user)
}).catch(err=>{
  // HError 对象
})

swan.BaaS.auth.register({email: 'ifanrx@ifanr.com', password: 'ifanrx123'}).then(user => {
  console.log(user)
}).catch(err=>{
  // HError 对象
})

返回结果

user 为 currentUser 对象，该对象的详细介绍请参考 currentUser 小节

用户名不区分大小写。当用户注册了 username 为 ifanrx 的账号后，其他人不能再注册诸如 Ifanrx、IfAnrx、IFANRX 等账号了

示例代码

wx.BaaS.auth.register({username: 'ifanrx', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

qq.BaaS.auth.register({username: 'ifanrx', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

BaaS.auth.register({username: 'ifanrx', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

my.BaaS.auth.register({username: 'ifanrx', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

swan.BaaS.auth.register({username: 'ifanrx', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

user 为 currentUser 对象，该对象的详细介绍请参考 currentUser 小节

示例代码

wx.BaaS.auth.register({phone: '15000000000', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

qq.BaaS.auth.register({phone: '15000000000', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

BaaS.auth.register({phone: '15000000000', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

my.BaaS.auth.register({phone: '15000000000', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

swan.BaaS.auth.register({phone: '15000000000', password: 'ifanrx123'}).then(user => {
  console.log(user)
})

user 为 currentUser 对象，该对象的详细介绍请参考 currentUser 小节

往数据表里添加数据，需要有一个用户身份（这样才能保障数据来源可回溯）。如果不希望强制用户在一开始就进行注册，可以使用匿名用户，让应用不提供注册步骤也能创建临时用户。以使得当前用户可以往 ACL 权限设置为“允许所有人（匿名用户 + 登录用户）可写” 的数据表内添加数据。

匿名登录使用场景举例：假如开发者希望应用内的文章，所有人可以在登录前阅读、点赞，而且仅在调用特定接口时才需要登录，比如发布文章、评论文章。这时可以先使用匿名登录，之后再使用其他登录方式登录（这里可能需要进行合并用户数据操作）。

匿名用户转换为正式用户（匿名登录后再使用其他登录方式登录），开发者需要考虑以下情况（以微信为例）：

不需要进行用户数据合并

匿名登录后，调用 wx.BaaS.auth.register，注册返回的 user_id 与之前匿名登录的 user_id 是一致的（也就是直接把匿名用户转变为了正式用户），所以不需要数据合并。
可能需要进行用户数据合并

匿名登录后，调用 wx.BaaS.auth.loginWithWechat，由于该微信账号可能已经与平台上的账号进行了绑定（即账号可能已经存在），登录成功后，返回的 user_id 与之前匿名登录的 user_id 不一定一致。可以通过对比前后的 user_id 是否一致来判断是否需要数据合并。
需要进行用户数据合并

匿名登录后，调用 wx.BaaS.auth.login，登录成功后，返回的 user_id 必定与之前匿名登录的 user_id 不一致，所以需要数据合并。

最终进不进行数据合并，由开发者自己考量决定。合并操作需要开发者自己进行。

示例代码

wx.BaaS.auth.anonymousLogin().then(user => {
  console.log(user)
}).catch(err => {
  // HError
})

返回结果