مرجع SDK

البدء والدورة الحياتية

نسخ الصفحة

Lia.البدء، Lia.الجاهز، Lia.الجلسة و Lia.الإغلاق، وكل حدث Lia يرسله تطبيقك.

#Lia.init()

استدعِها أولًا. تجيب بمن هو اللاعب وما يخص كيفية عرض تطبيقك، وتعبئت SDK's الخصائص و CSS متغيرات.

const me = await Lia.init();

يُحل بـ:

حقل	النوع	ماذا هو
`player`	كائن	`{ id, name }`: اللاعب'معرّفها في تطبيقك، ومعرف Lia الخاص بهم. انظر اللاعبون.
`session`	سلسلة	رمز جلسة لسيرفرك، `lias_…`.
`exp`	عدد	عند انتهاء الجلسة، بالمللي ثانية منذ 1970 (الدقيقة 15 بعد الفتح).
`mode`	سلسلة	`"test"` أو `"live"`.
`language`	سلسلة	الشخص'لغته في Lia، مثل `"en"`.
`rtl`	منطقية	سواء كان يُقرأ من اليمين إلى اليسار.
`platform`	سلسلة	`"ios"` أو `"android"`.
`theme`	سلسلة	`"light"` أو `"dark"`.
`themeParams`	كائن	Lia'ألوانه (`bg_color`, `text_color`…).
`display`	سلسلة	`"sheet"`, `"full"` أو `"fullscreen"`.
`isFullscreen`	منطقية	من الطرف إلى الطرف أو لا.
`viewport`	كائن	`{ height, expanded }`
`safeArea`	كائن	`{ top, bottom, left, right }` ببكسل
`contentSafeArea`	كائن	`{ top, bottom, left, right }` ببكسل
`startParam`	سلسلة أو فارغ	ما تم فتح تطبيقك به.
`link`	سلسلة	تطبيقك'رابط الدعوة الخاص به، بدون startParam.
`sound`	منطقية	سواء كان الشخص يريد تطبيقك'الأصوات.
`notifications`	كائن	`{ allowed, available }`: ما إذا وافقوا على تنبيهاتك، وما إذا كان تطبيقك يمكنه طلب ذلك.

الأخطاء: not_in_lia, not_ready (لا يزال Lia يفتح التطبيق؛ حاول مرة أخرى قريبًا)، timeout.

#Lia.ready()

يقول Lia أن صفحتك تم رسمها، لذلك تزيل مشغلها. اتصل بهم بمجرد أن الشاشة الأولى الخاصة بك على الصفحة. لا يعيد أي شيء.

Lia.init().then(function (me) {
  renderHome(me);
  Lia.ready();
});

#Lia.session()

رمز جلسة جديد لخادمك. تستمر الجلسات لمدة 15 دقائق، لذلك احصل على واحد جديد قبل المكالمات التي يجب أن يثق بها خادمك.

const { session, exp } = await Lia.session();

يُحل بـ { session, exp }. الأخطاء: not_open أو الشخص لم'لقد فتحت تطبيقك في Lia بعد؛ اتصل init() أولاً)، timeout.

#Lia.close()

يغلق تطبيقك. يحل مع null. إذا قمت بتفعيل تأكيد الإغلاق, هذا يُغلق دون طلب.

#Lia.on(event, listener)

يُستمع إلى أحد Lia'الفعاليات. ترجع دالة توقف عن الاستماع.

const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();

الرمي bad_listener إذا listener لا'ت وظيفة. مستمع يطرح خطأ لا'لإيقاف الآخرين.

#Lia.off(event, listener)

يوقف مستمعًا تم إضافته باستخدام Lia.on.

#Lia.onPause(listener)

نفس الشيء كما Lia.on("pause", listener). ترجع دالة توقف الاستماع.

#Lia.onResume(listener)

نفس الشيء كما Lia.on("resume", listener).

#الأحداث

حدث	البيانات	متى
`"pause"`	لا شيء	انتهى Lia إلى الخلفية، أو أحد Lia'الشاشات (قائمة الدفع، إعلان، حوار) تغطي تطبيقك. توقف المؤقتات والصوت.
`"resume"`	لا شيء	العودة مرة أخرى.
`"theme"`	`{ theme, colorScheme }`	الشخص غير تغيير Lia بين الإضاءة والظلام. `theme` هو الألوان الجديدة. متغيرات CSS تم تحديثها بالفعل.
`"viewport"`	`{ height, expanded, isStateStable }`	صفحتك'ارتفاعه تغير (ورقة تم سحبها، الأزرار السفلية تظهر).
`"fullscreenChanged"`	`{ isFullscreen, contentSafeArea }`	تم إرسال تطبيقك إلى وضع الشاشة الكاملة أو الخروج منها.
`"languageChanged"`	`{ language, rtl }`	الشخص غير تغيير Lia'لغته.
`"startParam"`	`{ startParam }`	تم فتح إشعار أو دعوة لتطبيقك بينما كان مفتوحًا بالفعل.
`"notificationsChanged"`	`{ allowed }`	الشخص الذي منح أو منع تطبيقك'إشعاراتها.
`"soundChanged"`	`{ on }`	الشخص مكتفٍ أو غير مكتفٍ بتطبيقك من Lia'قائمة ...
`"charge"`	`{ chargeId, productId }`	تم تأكيد دفع بينما لا `Lia.pay()` كان في الانتظار (بعد إعادة التحميل). أيضًا `Lia.onCharge`.
`"ad"`	`{ state, format }`	إعلان'المرحلة: `"loading"`, `"showing"` أو `"closed"`. أيضًا `Lia.onAd`.
`"banner"`	`{ state, position, height, reason? }`	الشريط الإعلاني's `"loading"`, `"shown"`, `"failed"` أو `"hidden"`. أيضًا `Lia.onBanner`.
`"nativeAd"`	`{ state, placement, height? }`	إعلان أصلي's `"loading"`, `"showing"` أو `"closed"`. أيضًا `Lia.onNativeAd`.
`"safeAreaChanged"`	`{ safeArea, contentSafeArea }`	شريط إعلان مثبت أو بطاقة أصلية أخذ أو أعاد حافة: Lia يضيف مساحة حوله، لذلك منطقتك الآمنة هناك هي 0. CSS المتغيرات تم تحديثها بالفعل.
`"mainButtonClicked"`	لا شيء	الزر الرئيسي تم الضغط عليه. أيضًا `Lia.mainButton.onClick`.
`"secondaryButtonClicked"`	لا شيء	تم الضغط على الزر الثانوي.
`"backButtonClicked"`	لا شيء	الشريط العلوي'تم الضغط على زر العودة الخاص به.
`"settingsButtonClicked"`	لا شيء	تم اختيار الإعدادات في قائمة ⋯.
`"accelerometerChanged"`	`{ x, y, z }`	قراءة، بينما يعمل التسارع.
`"gyroscopeChanged"`	`{ x, y, z }`	قراءة، بينما يعمل الجيروسكوب.
`"deviceOrientationChanged"`	`{ alpha, beta, gamma }`	قراءة، بينما يعمل الاتجاه.
`"accelerometerStarted"`, `"accelerometerStopped"`	لا شيء	بدأ المستشعر أو توقف. أيضًا لـ `gyroscope` و `deviceOrientation`.

تجربة SDK تُحدِّث خصائصها الخاصة (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn والباقي) قبل تشغيل مستمعيكم.

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية