七、签到 #

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

签到接口用于处理展示签到记录和领取签到奖品的业务，使用签到系统需要事前在控制台配置签到的业务。

更多于签到系统有关的说明请参考能力综述/签到系统。

1、展示签到界面 #

弹出签到界面。

[WPlay showCheckInView:^(id error) {
		// 如果展示界面失败则触发回调
}];

2、处理签到奖励 #

监听并处理玩家签到时领取奖励的请求。

/**
 监听签到领奖状态

 @param awardBodyBlock          签到Block (回调AwardBody给游戏端，收到回调后可Return自定义Map进行领奖)
 @param getAwardBodyErrorBlock  领奖失败回调（若return回自定义字符串，则客户端错误提示toast会被替换）
 @param rewardBlock             发奖确认回调
 @param rewardErrorBlock        发奖失败回调（若return回自定义字符串，则客户端错误提示toast会被替换）
 */
[WPlay listenCheckInReward:^NSDictionary<NSString *,NSString *> *(NSString *awardBody) {
			// 玩家请求领奖时回调

			// awardBody: 控制台配置的关于本次奖励的参数
			// 由服务器透传到客户端，可以辅助客户端响应

			// 注意：此接口被回调时，仅表示玩家请求领奖
			// 便于客户端做一些前期准备，此时奖励尚未确认发放（服务器记录未更新）

			// return: 如果设置了回调接口，可以通过该字典返回自定义变量
			return @{@"callback_self_defined_key":@"callback_self_defined_value"};
		}
		getAwardBodyError:^NSString *(id error) {
			// 请求领奖失败时回调

			// 如果返回非空的字符串，则会替换默认提示玩家领奖失败的消息内容
			return @"msg_display_to_player";
		}
		rewardBlock:^(NSDictionary *returnBoby) {
			// 服务器确认发奖后回调

			// returnBoby: 如果控制台配置了returnBody，则该值由控制台配置的returnBody决定。
			// 如果控制台配置了Callback方法，则该值为回调游戏服务器后，由游戏服务器返回的JSON解码结果。

			// 客户端可以在该回调中将奖励发放给玩家
		}
		rewardError:^NSString *(id error) {
			// 确认领奖失败时回调

			// 如果返回非空的字符串，则会替换默认提示玩家领奖失败的消息内容
			return @"msg_display_to_player";
		}
];