الحزم
حزم الخلفية & المبتدئون
نسخ الصفحة
العملاء الرسميين لخلفية Lia وأساليب بدائية آمنة لـ TypeScript، بايثون، PHP وغو.
عملاء الخوادم الرسميين لـ TypeScript/JavaScript، بايثون، PHP وغو. يُرسلون إلى نفس خادم Lia المُحدد بالتطبيق API. المفتاح التجريبي يرى سجلات تجريبية؛ والمفتاح الحي يتطلب تطبيقًا حيًا ويرى سجلات حية.
#أنشئ واجهة خلفية
npx @lia-labs/create-app@latest backendاختر Node.js HTTP أو Express، FastAPI أو Django، PHP HTTP، أو Go HTTP . تحقق الواجهات الخلفية المُولدة من جلسات اللاعبين المؤقتة والرسوم المدفوعة، وتحافظ على مخزونات SQLite مع إيصالات فريدة، وتؤكد التسليم بعد منح ناجح، وتُلغِي الإرجاعات بمجرد حدوثها. يحتوي مُبادر Node أيضًا على تحديات مكافآت تُصدرها الخوادم ومسحًا محدودًا ومتقسيمًا للتعافي.
لا يطلب منك CLI أبدًا لصق سر في معاملات واجهة سطر الأوامر أو كتابته في الواجهة الأمامية. قم بتعيين LIA_SERVER_KEY و LIA_WEBHOOK_SECRET على خادمك. قم بإنشاء coins-100 المنتج في مطوري Lia، ثم قم بتغيير خريطة الامتيازات التي يمتلكها الخادم لمنتجاتك الحقيقية. احفظ data/ على حجم متين. بالنسبة لحالات التطبيق المتعددة، استبدل متجر SQLite العينة بقاعدة بيانات معاملات مشتركة. قم بتكوين HTTPS وحدود السرعة الخاصة بالتطبيق على الخدمة الإنتاجية.
توجد أمثلة على دمج الإطارات لـ إكسبريس، تطبيق Next.js روتر، هونو، FastAPI، دجنو ولارافيل. لا يمكن مُعَدِّل الإطار معرفة لعبةك'حقه أو قواعد منع الغش؛ تظل هذه الشروط ملكًا للكود التطبيق الخاص بالخادم.
#تثبيت في خادم خلفي موجود
| اللغة | الحزمة / المصدر | تثبيت |
|---|---|---|
| JavaScript / TypeScript | @lia-labs/server | npm install @lia-labs/server |
| بايثون | lia-labs-server | pip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0' |
| PHP | lia-labs/server | أضف مستودع الشركة GitHub VCS أدناه، ثم composer require lia-labs/server:^0.1.0 |
| جوا | github.com/The-Lia-Labs/lia-server-go | go get github.com/The-Lia-Labs/lia-server-go@v0.1.0 |
يتم تثبيت بايثون من مصادره المُعلَّمة GitHub؛ لا يزال غير مدرج على PyPI. يمكن تثبيت PHP من خلال مُثبت VCS؛ لا يزال غير مدرج على باكاجيست.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}يدعم العقد ESM و CommonJS ويحتوي على أنواع TypeScript . بايثون توفر LiaClient و AsyncLiaClient. يتطلب PHP 8.2+ و cURL؛ كما يتطلب مُولد مخزون البداية أيضًا PDO SQLite. جو'يعتمد عميله على مكتبة القياسي؛ يستخدم مُنشئ المخزون المُولَّد SQLite عبر CGO ويحتاج إلى مُ compilers C. لا تقم باستيراد هذه الحزم في حزمة المتصفح.
#تأكيد هوية اللاعب
import {LiaClient} from '@lia-labs/server';
const lia = new LiaClient(process.env.LIA_SERVER_KEY!);
const player = await lia.requireSession(sessionFromLia);
const {products} = await lia.listProducts();بايثون: lia.require_session(session); PHP: $lia->requireSession($session); انتقل إلى: client.RequireSession(ctx, session).
تُرسل الواجهة الأمامية الجلسة التي تم إرجاعها من Lia.init() أو Lia.session(), ليس لاعبًا ID أو مفتاح خادمك. النتيجة's exp هو يونكس ملي ثانية. يتحقق العملاء من الاستجابة'وضعية اللعبة، شكل اللاعب وانتهاء الصلاحية. قم بتحديث جلسة الواجهة الأمامية عند انتهائها. يؤكد API نفسه التوقيعات وملكية التطبيق.
#العمليات
العقد القابل للقراءة من قبل الآلة المشتركة هو عقد التشغيل. أسماء أدناه هي أسماء TypeScript/PHP. يعتمد بايثون على snake_case وبارامترات الكلمات المفتاحية؛ ويستخدم جو PascalCase، context.Context, lia.Params و lia.RequestOptions.
| منطقة | الطرق |
|---|---|
| الجلسات | verifySession, requireSession |
| القائمة | listProducts |
| الشراء | getCharge, deliverCharge, refundCharge, listPendingCharges |
| مكافآت LIA | payReward, getPool |
| الإشعارات | sendNotification |
| الإعلانات المكافأة | verifyAd, createAdChallenge, claimAdChallenge |
| غرفة المباريات متعددة اللاعبين | listTables, saveTable, sitAtTable, removeTable |
| النتائج الرسمية | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| تخزين خاص بالخادمة | getPlayerStorage, setPlayerStorage |
| الويب هوكس | listWebhookEvents, replayWebhookEvent, التحقق من التوقيع الخام وبناء الأحداث |
| التحليلات | getAnalytics, exportAnalytics |
يحتاج كتابة التخزين expectedVersion; تعارض هو HTTP 409. JSON null هو قيمة مخزنة صالحة. الوصول من المتصفح إلى هذا التخزين قراءة فقط ويتم ربطه بالجلسة'اللاعب. يجب أن تأتي الدرجات من لعب مؤكد من الخادم؛ نقل درجة غير موثوقة إلى نقطة نهاية خادم لا يجعلها مرجعية.
#الشراء وإعادة المحاولة
- استعلم عن الرسوم باستخدام مفتاح الخادم. تحقق
playerId,mode,productIdوpaid/deliveredالحالة. - أدخل إيصال فريد مُعرَّف بـ الوضع + الشحن ID والسماح بالحق المُسجّل فقط إذا كان الإيصال جديدًا.
- احفظ المخزون، ثم استدعي
deliverCharge. أعد مصادقة هذه المرة حتى إذا تم منح المخزون بالفعل. - يتم مطابقة الرسوم المدفوعة المعلقة باستخدام كل صفحة مؤشر. يجب إعادة مراجعة الإرجاعات مقارنة بـ Lia وإلغاؤها مرة واحدة في قاعدة بياناتك.
يستخدم جميع العملاء ميزانية طلب بثانية 15 ويسمح بحد أقصى مرتين إعادة محاولة افتراضية.他们会重试临时的 HTTP/الشبكة فشل، ويحترم Retry-After, رفض إعادة التوجيه المصادق عليها وتجاهل محتويات الأخطاء الخام من الأخطاء. القيم المُعدَّلة تحتفظ بنفس مفتاح التكرار المُولَّد والجسم المُسلَّم ضمن استدعاء. مرر مفتاح عمل مستقر عند إعادة المحاولة بعد إعادة تشغيل العملية أو استدعاءات منفصلة.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});بايثون يستخدم idempotency_key=...; يأخذ PHP كمعامل ثاني; تستخدم جو lia.RequestOptions{IdempotencyKey: ...}. التحقق من الجلسة هو نوع قراءة POST ولا ينشئ سجلًا لا لزوم له من التكرار. LiaError يحتوي على رمز، حالة HTTP، معرف الطلب ID وفترة انتظار إعادة المحاولة. لا تتعامل أبدًا مع 503 كلاعب غير صالح أو عملية شراء مكتملة. تحقق من سلامة GETs والجلسة لهما عدد محدود من المحاولات؛ ويعتمد السلوك الدقيق المالي أيضًا على API'وقاعدة بياناتك'إيصالات الأعمال الفريدة.
#الويب هوكس الموقعة
التحقق بايتات خام غير مُغيَّرة قبل تحليل JSON مع constructWebhookEvent (العقد)، construct_webhook_event (بايثون)، Webhooks::constructEvent (PHP)، أو ConstructWebhookEvent (اذهب). استخدم Lia-Signature العنوان والتطبيق الخاص بك'سر الت webhook. ترفض التحقق من الرسائل المعدلة والتواريخ التي تختلف بخمس دقائق في الماضي أو المستقبل. يمكن الاعتراف بالأنواع غير المعروفة من الأحداث الموقعة دون منح أي شيء; test:true التحقيق لا يمنح المخزون أبداً.
يحتفظ Lia بصندوق خارج دائم مع حدث مستقر ID. يحاول التسليم فورًا، ثم بعد 1 دقيقة، 5 دقائق، 30 دقائق، 2 ساعة، 8 ساعة، 24 ساعة و 48 ساعة. تحصل كل محاولة على توقيت توقيع جديد. تحقق من البيانات الوصفية باستخدام listWebhookEvents، وقم بإعادة تشغيل الحدث بعد إصلاح معالجك. قم بإزالة التكرار باستخدام إيصالات الأعمال المستقرة حتى بعد إعادة التشغيل. لا ترجع 2xx قبل إتمام الالتزام.
#تحديات المكافآت
أنشئ تحديًا على خادمك بسياق مملوك للخادم ولاعب ID. ارجع challengeId إلى الواجهة الأمامية وتمريرها ك rewardContextId عند طلب إعلان مكافأة. تحقق من الربط/الادعاء يتحقق من اللاعب، وضع التطبيق، تنسيق الإعلان، العمر، الإكمال والاستخدام مرة أخرى. الادعاء لا يمنح المخزون بمفرده; منح لعبةك'الحق في الامتياز مرة واحدة لكل إعلان في معاملتك الخاصة.
المكافآت القيمة الحية تتطلب providerVerified:true. يحتاج تدفق الإثبات الجديد إلى مضيف_native المحدث Lia لإرسال nonce SSV لكل إعلان ووظيفة الاستدعاء AdMob SSV المُحددة. دعم الخلفية وحده لا يُحدث التطبيقات المثبتة مسبقًا. يتم محاكاة إكمال المضيف في الوضع التجريبي كأدلة، ولا تُعتبر إثباتًا مُوقَّعًا من المزود الحقيقي.
تقتصر الإعلانات الحقيقية في SDK Demo على 3 طلبات لكل يوم بتوقيت UTC، بفاصل لا يقل عن 30 دقيقة. تظل المشتريات ومكافآت LIA محاكاة. حدّث Lia لاستخدام هذه الميزة.
#التحليلات
تتضمن التقارير اللاعبين النشطين يوميًا، والشراء وتحويل المشترين، وبيانات الإعلانات حسب التنسيق واحتفاظ D1/D7/D30. تحتوي CSV على أنواع سجلات النشاط والإعلان والاحتفاظ. تبدأ جمع بيانات الاحتفاظ مع هذا الإصدار؛ لا يتم اختراع مجموعات تاريخية. تُرجع تغطية إعلانات الإعجاب غير الكاملة مقاييس معدومة. دخل SDK المُبلغ عنه هو تقدير، وليس دخلًا نهائيًا AdMob أو بيان دفع المطور.
يمكنك إدارة المواسم وإخفاء النتائج أو استعادتها وفحص محاولات تسليم خطافات الويب وإعادة إرسال الأحداث من Lia Developers. تشمل التحليلات تطبيقات فريقك وتصدير CSV. تظل بيانات الاختبار والبيانات المباشرة منفصلة.
#التحقق من الصحة
من الشركة lia-sdk المخزن:
npm install
python3 -m venv .venv
.venv/bin/pip install -e backends/python
LIA_PYTHON=.venv/bin/python npm run test:backends
npm run test:create-appقم بتثبيت Postman CLI، PHP مع cURL و Go أولاً. هذا يشغل جميع العملاء الأربعة الحقيقيين من خلال نموذج Postman HTTP الأولي المحلي، بما في ذلك الفشل المؤقت، والmutations المتكررة، وانتهاء الجلسة، والتحويلات، والمواعيد النهائية، وتزوير الويب هوك. لا يمس البيانات الإنتاجية. راجع scripts/developer-server-features-local-test.mjs في مستودع API لاختبار التكامل المنفصل ضد تنفيذ Worker المحلي الحقيقي.
تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية