أفكار وميزات للعبة

ميزتك التالية

الإنجازات

يُفتح كل مفتاح مرة لكل لاعب. يثق الوضع اليدوي باللعبة؛ تُقيّم الحدود الإحصائية ضمن معاملة التقرير المتأثر نفسها.

SDK: فرع developتتطلب جلسة لاعب
Godot
رسم توضيحي لميزة الإنجازات
النتيجة المرئية

بعد الإجراء يُفتح first_steps للاعب نفسه. تكرار المفتاح لا يمنح إنجازاً أو مكافأة ثانية.

الفيديو قادم لاحقًا

لا يوجد فيديو لهذه الخطوة بعد. الدليل وطلب MCP متاحان للاستخدام.

الإنجازات

جهّزوا المشروع نفسه

  1. اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

    الإنجازات →
  2. أنشئوا إدخالات الاختبار هذه أو أعيدوا استخدام الموجود منها في نموذج لوحة التحكم. القيم أمثلة وليست بيانات المشروع الحالية.

    المفتاح
    first_steps
    الاسم
    First steps
    قاعدة الفتح
    manual
    نشط
    true
    مخفي حتى الفتح
    false
    دون مكافأة
    []

    يُفتح كل مفتاح مرة لكل لاعب. يثق الوضع اليدوي باللعبة؛ تُقيّم الحدود الإحصائية ضمن معاملة التقرير المتأثر نفسها.

  3. احفظوا الإدخالات وأعيدوا تحميلها وتحققوا منها قبل المثال. احتفظوا بالتعريفات الأخرى.

أضف هذه الميزة

يمكنك الاطلاع على الدليل. يتطلب التنفيذ مفتاح مشروع نشطًا. تجهيز المشروع

SDK مُثبّت وإعداد المشروع مُستورد واللاعب مسجّل الدخول.

يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

أكملوا اتصال البدء السريع باللاعب المقصود. استدعوا run_reviewed_action() بزر أو إجراء مشهد صريح. فتح الملف وحده لا يرسل طلباً.

GDScript
res://scripts/achievements.gd
استدعاء horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action unlocks the shown configured achievement key.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var user_id: String = Horizon.auth.getCurrentUser().userId
10 var loaded: Dictionary = await Horizon.achievements.getAchievements(user_id, "")
11 if not loaded.success:
12 push_warning(loaded.errorCode)
13 return
14 for progress in loaded.data.progress:
15 print(progress.key, ": ", progress.rewardState)
16​
17 # Configure manual first_steps; invoke on the corresponding game action.
18 var unlocked: Dictionary = await Horizon.achievements.unlock(user_id, "first_steps")
19 if not unlocked.success:
20 push_warning(unlocked.errorCode) # After timeout retry the same key.
21 return
22 # Complete progress has no unlock date or pending reward payload.
23 # Values were credited atomically. Refresh playerValues when displaying balances.
24 # No Inbox claim or local value addition. Retry the original key after an uncertain reply.
فتح مثال SDK الكامل ↗

اختبر ميزتك الجديدة.

بعد الإجراء يُفتح first_steps للاعب نفسه. تكرار المفتاح لا يمنح إنجازاً أو مكافأة ثانية.

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

نقاط النهاية
  • GET/achievements
  • POST/achievements/unlock
  • POST/achievements/rewards/deliver
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

أضف رقمًا قياسيًا لكل جولة.

احفظ النتيجة بعد الجولة وأظهر المتصدر. واصل استخدام اتصالك وجلسة اللاعب.