HarmonyOS鸿蒙Next中如何实现成就系统？解锁条件检测和通知

原理解析

成就系统核心逻辑：

1. 定义成就列表和解锁条件
2. 在关键操作后检查是否满足解锁条件
3. 解锁新成就时通知用户
4. 持久化已解锁的成就

解决步骤

步骤1：定义成就接口和列表

export interface Achievement {
  id: string;
  name: string;
  description: string;
  icon: string;
  condition: string;
  unlockedAt?: number;
}
export const ACHIEVEMENT_DEFINITIONS: Achievement[] = [
  { id: 'first_browse', name: '初次翻阅', description: '翻阅第一条内容', icon: '🎯', condition: '翻阅1条内容' },
  { id: 'browse_10', name: '学习新手', description: '翻阅10条内容', icon: '📖', condition: '翻阅10条内容' },
  { id: 'browse_50', name: '勤奋学员', description: '翻阅50条内容', icon: '📚', condition: '翻阅50条内容' },
  { id: 'browse_100', name: '百条达人', description: '翻阅100条内容', icon: '🏆', condition: '翻阅100条内容' },
  { id: 'streak_3', name: '三天坚持', description: '连续打卡3天', icon: '🔥', condition: '连续学习3天' },
  { id: 'streak_7', name: '一周坚持', description: '连续打卡7天', icon: '💪', condition: '连续学习7天' },
  { id: 'quiz_first', name: '首次测验', description: '完成第一次测验', icon: '✏️', condition: '完成1次测验' },
  { id: 'quiz_perfect', name: '满分达人', description: '测验获得满分', icon: '💯', condition: '测验得分100%' },
  { id: 'favorite_10', name: '收藏爱好者', description: '收藏10条内容', icon: '⭐', condition: '收藏10条内容' },
  { id: 'note_5', name: '笔记达人', description: '写5条笔记', icon: '📒', condition: '写5条笔记' }
];

步骤2：解锁成就方法

export async function unlockAchievement(achievementId: string): Promise<boolean> {
  if (!store) return false;
  try {
    const achievements = await getAchievements();
    const exists = achievements.some(a => a.id === achievementId);
    
    if (!exists) {
      const definition = ACHIEVEMENT_DEFINITIONS.find(d => d.id === achievementId);
      if (definition) {
        const newAchievement: Achievement = {
          ...definition,
          unlockedAt: Date.now()
        };
        achievements.push(newAchievement);
        await safeWrite(KEY_ACHIEVEMENTS, JSON.stringify(achievements));
        
        // 显示解锁通知
        promptAction.showToast({
          message: `🎉 解锁成就：${definition.name}`,
          duration: 2000
        });
        return true;
      }
    }
    return false;
  } catch (error) {
    return false;
  }
}

步骤3：检查并解锁成就

export async function checkAndUnlockAchievements(): Promise<void> {
  // 获取各项统计数据
  const browseStats = await getBrowseStats();
  const streakDays = await getStreakDays();
  const quizStats = await getQuizStats();
  const favorites = await getFavorites();
  const notes = await getNotes();
  
  // 检查浏览相关成就
  if (browseStats.total >= 1) await unlockAchievement('first_browse');
  if (browseStats.total >= 10) await unlockAchievement('browse_10');
  if (browseStats.total >= 50) await unlockAchievement('browse_50');
  if (browseStats.total >= 100) await unlockAchievement('browse_100');
  
  // 检查连续打卡成就
  if (streakDays >= 3) await unlockAchievement('streak_3');
  if (streakDays >= 7) await unlockAchievement('streak_7');
  
  // 检查测验成就
  if (quizStats.total >= 1) await unlockAchievement('quiz_first');
  if (quizStats.bestScore === 100) await unlockAchievement('quiz_perfect');
  
  // 检查收藏和笔记成就
  if (favorites.length >= 10) await unlockAchievement('favorite_10');
  if (notes.length >= 5) await unlockAchievement('note_5');
}

步骤4：在关键操作后调用检查

// 浏览内容后
export async function recordBrowse(...): Promise<boolean> {
  // ... 保存浏览记录
  await checkAndUnlockAchievements();
  return true;
}

// 完成测验后
async finishQuiz(): Promise<void> {
  await saveQuizRecord(record);
  await checkAndUnlockAchievements();
}

效果图

用户完成操作 → 检查成就条件 → 满足条件 → 解锁成就 → Toast通知"🎉 解锁成就：xxx"