当前用户

CurrentUser 类

CurrentUser 继承于 User。currentUser 实例代表了当前登录的用户，开发者可以通过访问 currentUser 上的属性来获取当前用户的信息，通过调用 currentUser 上的方法来更新用户信息。

获取 currentUser 对象

通过当前用户对象进而对当前用户进行管理，为了保证本地当前用户信息与服务器的用户信息一致，开发者只能通过两种方式获取到当前用户对象：

• 通过注册、登录后将获取当前用户对象。
• 通过以下方法获取当前用户：

• Swift
• Objective-C

// 用户管理对象
Auth.getCurrentUser { (currentUser, error) in
}

// 用户管理对象
[BaaSAuth getCurrentUser:^(BaaSCurrentUser * _Nullable currentUser, NSError * _Nullable error) {
}];

设置用户信息

currentUser 对象提供了一些方法，用于修改当前用户信息。

常见使用场景：

• 用户的用户名/邮箱设置有误，需要修改为新的用户名/邮箱。

除更新自定义字段外，其他方法匿名用户无法调用。

设置用户名

匿名用户无法调用

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

示例代码

• Swift
• Objective-C

currentUser.updateUsername("test_new") { (result, error) in
}

[currentUser updateUsername:@"testoc_new" completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
}];

参数说明

结果返回

设置邮箱

匿名用户无法调用

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

示例代码

• Swift
• Objective-C

currentUser.updateEmail("test_new@ifanr.com") { (result, error) in
}

[currentUser updateEmail:@"test_new@ifanr.com" completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
}];

参数说明

结果返回

设置密码

匿名用户无法调用

示例代码

• Swift
• Objective-C

currentUser.updatePassword("111", newPassword: "1111") { (result, error) in
}

[currentUser updatePassword:@"111" newPassword:@"123" completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
}];

参数说明

参数说明：

结果返回

更新用户自定义字段

示例代码

• Swift
• Objective-C

currentUser.updateUserInfo(["age": 18]) { (result, error) in
}

[currentUser updateUserInfo:@{@"age": @18} completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
}];

参数说明

参数说明：

结果返回

邮箱验证

匿名用户无法调用

当用户通过邮箱注册后或者修改了邮箱后，开发者可能希望对用户填写的邮箱真实性进行校验，调用该 API 后，知晓云会向当前用户发送一封验证邮件，用户可以打开邮件并进行验证操作。

示例代码

• Swift
• Objective-C

currentUser.requestEmailVerification() { (success, error) in
}

[currentUser requestEmailVerification:^(BOOL success, NSError * _Nullable error) {
}];

结果返回

通过邮件重置密码

当用户忘记了登录密码，可以通过邮件重置密码。

只有通过验证的邮箱才能使用邮件重置密码功能

示例代码

• Swift
• Objective-C

currentUser.resetPassword(email: "test@ifanr.com") { (success, error) in
}

[currentUser resetPasswordWithEmail:@"test@ifanr.com" completion:^(BOOL success, NSError * _Nullable error) {
}];

结果返回