五、角色管理 #

#lfeng/wellplay/客户端集成/IOS

角色管理接口允许开发者对管理当前登录用户在Wellplay中对应角色的生命周期。角色管理的接口必须在正常登录了Wellplay社区后才能正常使用，且每个玩家只能操作自己的角色。

关于角色系统的更多说明请参考能力综述/角色系统。

1、获取当前玩家登陆的角色回调 #

如果使用了Wellplay社区中涉及角色的功能，每当需要获取当前登录角色时，SDK会回调该接口，以确保获取最新的角色ID。

[WPlay giveRoleID:^NSString *{
		// 可以返回nil表示当前未登录角色
		return @"your_wellplay_role_id";
}];

如果返回nil，表示当前未登录角色，与角色相关的界面、列表（如签到界面、奖励列表）会无法打开，以避免误操作。
如果返回的角色ID不属于当前Wellplay登录的用户，则相关操作会被禁止。

2、创建角色 #

在Wellplay中创建一个角色，并初始化其属性。

[WPlay createRoleWithPropertyMap:@{@"PropertyKey":@"PropertyValue"}
		success:^(NSDictionary *successDic) {
			// 创建成功回调
		}
		failure:^(id error) {
			// 创建失败回调
		}
];

属性名需要先在控制台配置。
创建的角色隶属于当前登录的Wellplay用户，如果当前未登录，则无法创建角色。
设置成功后会返回该角色的唯一ID，开发者需要自己建立好该角色ID与游戏角色ID之间的映射关系。

3、修改角色属性 #

修改或设置Wellplay中的指定角色的属性值。

[WPlay updateRoleWithRoleID:@"your_wellplay_role_id"
		propertyMap:@{@"PropertyKey":@"PropertyValue"}
		success:^(NSDictionary* successDic) {
			// 修改角色属性成功时回调
		}
		failure:^(id error) {
			// 修改角色属性失败时回调
		}
];

4、删除角色 #

删除Wellplay中的指定角色。

[WPlay deleteRoleWithRoleID:@"your_wellplay_role_id"
		success:^{
			// 删除角色成功时回调
		}
		failure:^(id error) {
			// 删除角色失败时回调
		}
];