P10 NFC 打卡页

页面定位

用于完成景点线下 NFC 打卡。

适用角色与入口

• 适用角色：已登录且已绑定手机号用户
• 页面入口：路线详情页、景点详情页

页面组成

1. 线索图片区

字段：clueImageList

展示打卡点线索图片，辅助用户找到线下芯片位置。

2. 识别状态区

字段：loadingAnimation、deviceStatus、nfcStatus

展示等待触碰芯片、设备状态与识别状态。

3. 结果弹窗

字段：checkinStatus、spotName、spotImage、rewardType、rewardValue、prizeName、contactHint、resultDesc

展示打卡成功或失败反馈。

支持奖励类型：

• 积分
• 核销码
• 实物

其中核销码/实物奖励的领取逻辑，参考抽奖中奖后的客服领取引导。

关键交互

• 开始识别：首次进入时初始化 NFC 监听
• 重新尝试：识别失败后重试
• 返回景点/路线：成功或失败后返回来源页

识别流程

1. 进入页面先校验设备能力与权限
2. 初始化 NFC 监听
3. 用户触碰标签后进入识别
4. 调用预校验接口
5. 调用确认接口完成打卡
6. 展示结果弹窗并返回来源页或继续操作

校验规则

• 登录状态有效
• 当前景点未打卡
• 标签必须属于当前景点的有效标签
• 幂等键唯一，避免重复提交
• 防止短时间内重复识别

状态与异常处理

• 识别中：展示 loading 动图
• 设备不支持：展示降级提示
• 识别失败：展示失败弹窗

异常文案：

• 设备不支持：当前设备暂不支持 NFC 打卡
• 识别失败：打卡识别失败，请重试
• 重复打卡：该景点已完成打卡

跳转关系

P10 -> P08 / P09

埋点建议

• checkin_page_show
• checkin_prepare_success
• checkin_confirm_success
• checkin_confirm_fail