签到 - CheckinBoardService

签到主要分两种类型,一种是每日签到,即每日只能只能签到一次,成功则返回连续签到次数,如果本日签到过再发起签到会返回0,表示当日已经签到过
还有一种类型是不累计次数的签到,等同于一个在线的计数器,可以获取到两次签到的间隔时间
签到功能需要在后台创建一个指定id的签到板才能使用,暂时请联系后台人员协助创建
每个角色在不同的签到板的签到信息是独立的

SgtApi.CheckinBoardService.checkin(playerId, checkinBoardId, callback)

签到

SgtApi.CheckinBoardService.accumlateCount(playerId, checkinBoardId, callback)

获取最大累计签到数

SgtApi.CheckinBoardService.countinuousCount(playerId, checkinBoardId, callback)

获取连续签到数

SgtApi.CheckinBoardService.getCheckinboardByChekinboardId(checkinBoardId, callback)

通过CheckInBoardId获取签到板实体数据

SgtApi.CheckinBoardService.getLastCheckinTime(playerId, checkinBoardId, callback)

获取最后签到时间

SgtApi.CheckinBoardService.getRewardByCheckinBoardId(checkinBoardId, callback)

获取奖励

SgtApi.CheckinBoardService.setCheckinTimes(playerId, checkinBoardId, times, callback)

补签

SgtApi.CheckinBoardService.validateCheckin(playerId, checkinBoardId)

判断是否可以签到

SgtApi.CheckinBoardService.getAvailableCheckinBoards(callback)

获取当前可用(有效时间内)的签到板

SgtApi.CheckinBoardService.getAvailableCheckinBoardsByTag(tag, callback)

根据自定义标签获取当前可用(有效时间内)的签到板

SgtApi.CheckinBoardService.getAvailableCheckinBoardsByType(type, callback)

根据类型获取当前可用(有效时间内)的签到板

Class: CheckinBoard

  • CheckinboardId 用来和客户端交互数据的标识是CheckinboardId,类似于排行榜的LeaderboardId,在服务器端创建,客户端操作
  • name 签到板名称
  • type 目前有每日签到CHECKIN_TYPE_DAILY,普通签到CHECKIN_TYPE_NORMAL,日历签到CHECKIN_TYPE_CALENDAR3种类型
  • maxCheckinTimes 最大连续签到次数,在服务器端设置过最大签到次数以后,会把连续签到次数重置为0
  • 有效开始时间(可选)
  • 有效结束时间(可选) 开始时间和结束时间可以只选择一个,或者都不选 若签到板不在有效期内,则抛出异常 InvalidStateException("签到板已过期!")
  • rewards 奖励
  • tag 自定义签到标记,可以用来区分不同的签到类型,例如多个每日签到等
  • resetTime 签到状态重置时间,表示第二天{resetTime}时间点可以再次签到,默认为0,零点整。24小时制,取值范围为0--24