الإنجازات في ألعاب PlayDrop

{
  "achievements": [
    { "key": "first-win", "displayName": "First flag", "description": "Reach the flag once",
      "kind": "STANDARD", "icon": "achievements/first-win.png" },
    { "key": "collector", "displayName": "Collector", "description": "Collect 100 stars",
      "kind": "INCREMENTAL", "maxProgress": 100, "icon": "achievements/collector.png" },
    { "key": "secret-room", "displayName": "Secret room", "description": "Find the hidden room",
      "kind": "STANDARD", "hidden": true, "icon": "achievements/secret-room.png" }
  ]
}

• يتبع key صيغة مفاتيح لوحات المتصدرين نفسها.
• قيمة kind هي STANDARD (يُفتح مرة واحدة) أو INCREMENTAL (يُفتح عندما يبلغ التقدم maxProgress، وهو عدد صحيح موجب).
• icon صورة PNG داخل الحزمة. استخدم صورة مربعة واضحة تبقى مقروءة بأحجام صغيرة.
• يُبقي hidden: true الاسم والوصف سرًا حتى يُفتح الإنجاز.

لا يمكن حذف المفاتيح المنشورة، ولا يمكن تغيير kind وmaxProgress وhidden. أوقف إنجازًا باستخدام "status": "RETIRED".

await sdk.achievements.unlock("first-win");
await sdk.achievements.setProgressAtLeast("collector", starsCollected);

const { achievements } = await sdk.achievements.list();
const { achievement } = await sdk.achievements.get("collector");

• تأخذ setProgressAtLeast الإجمالي حتى الآن، وليس مقدار الزيادة أبدًا. التقدم يرتفع فقط، ويُحدّ عند maxProgress ويُفتح الإنجاز عنده.
• يعيد الاستدعاءان { accepted, changed, unlocked, progress, unlockedAt, achievement }؛ وتكون قيمة changed هي false عندما لا يحدث شيء جديد، فتعرض إشعارك المنبثق الخاص مرة واحدة فقط.
• تتضمن list({ includeHiddenDefinitions: true, includeRetired: true }) التعريفات المخفية والموقوفة.

افتح الإنجازات أثناء اللعب الحقيقي فقط، ولا تفتحها أبدًا في المعاينات أو الالتقاطات. ودون أي جلسة لاعب، تنجح الاستدعاءات دون حفظ أي شيء.

امزج إنجازات مبكرة تعلّم اللعبة بأهداف طويلة الأمد. سمِّ الفعل لا المكافأة: «اربح دون أن تتلقى أي ضرر» يقول ما يجب فعله. اثنا عشر إنجازًا مدروسًا أفضل من مئة إنجاز تافه.