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

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

إحصاءات اللاعب

أرسل الجولات والإقصاءات وأفضل النتائج في دفعة جلسة واحدة، بقواعد المجموع أو الأعلى أو الأدنى أو أحدث قيمة.

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

ترسل اللعبة جلسة كاملة في دفعة واحدة وتعرض العدادات والفترات الحالية.

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

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

إحصاءات اللاعب

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

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

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

    تعريفات الإحصاءات
    kills: mode=sum, reset=none; best_score: mode=max, reset=none

    يجمع المجموع كل تقرير. يحتفظ الأعلى والأدنى بالقيمة القصوى أو الدنيا؛ وتستبدل الأحدث القيمة. يبدأ الأعلى والأدنى والأحدث بالتقرير الأول. القيم أعداد صحيحة بإشارة ضمن النطاق الآمن.

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

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

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

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

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

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

GDScript
res://scripts/statistics.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 reports the shown persisted batch.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var snapshot: Dictionary = await Horizon.statistics.getStatistics()
10 if snapshot.is_empty():
11 push_error(Horizon.statistics.getLastErrorCode())
12 return
13 var pending_path: String = "user://statistics_" + snapshot.userId + ".dat"
14 var pending: Dictionary
15 if FileAccess.file_exists(pending_path):
16 var file := FileAccess.open(pending_path, FileAccess.READ)
17 if file == null:
18 return
19 var saved: Variant = file.get_var()
20 file.close()
21 if not saved is Dictionary:
22 return
23 pending = saved
24 else:
25 pending = {"operationId": Horizon.statistics.createOperationId(),
26 "updates": [{"key": "kills", "value": 3}, {"key": "best_score", "value": 250}]}
27 var file := FileAccess.open(pending_path, FileAccess.WRITE)
28 if file == null:
29 return
30 file.store_var(pending, false) # Variant storage preserves int64 values.
31 file.flush()
32 var saved_ok: bool = file.get_error() == OK
33 file.close()
34 if not saved_ok:
35 return
36 var original_bytes: PackedByteArray = FileAccess.get_file_as_bytes(pending_path)
37 if original_bytes.is_empty():
38 return
39 var result: Dictionary = await Horizon.statistics.updateStatistics(pending.updates, pending.operationId)
40 if result.is_empty():
41 # Keep the file and original ID, including after timeout or OPERATION_EXPIRED.
42 push_error(Horizon.statistics.getLastErrorCode())
43 return
44 # A delayed O1 success cannot remove another action's O2 original.
45 if FileAccess.get_file_as_bytes(pending_path) == original_bytes:
46 DirAccess.remove_absolute(ProjectSettings.globalize_path(pending_path))
47 print(result.values)
فتح مثال SDK الكامل ↗

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

ترسل اللعبة جلسة كاملة في دفعة واحدة وتعرض العدادات والفترات الحالية.

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

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

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

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