الحزم

الطبقة الأدنى. استدعاءات مُنضبطة وأحداث عبر جسر إطارات Lia، والفترات الزمنية والحدود، وmockLia() لبناء خارج Lia.

معظم التطبيقات تريد @lia-labs/sdk, الذي تم بناؤه على هذا ويعيد تصدير كل شيء. استخدم الجسر بمفرده لبناء طبقة خاصة بك، أو لاستدعاء شيء لا يمكن لـ SDK'لإغلاق.

npm install @lia-labs/bridge

#البروتوكول

داخل Lia، تُشغل صفحتك التطبيق Lia'متصفح الويب. المكالمة هي رسالة JSON التي ترسلها الصفحة مع window.ReactNativeWebView.postMessage:

{ "lia": 1, "id": 7, "method": "haptic", "params": { "kind": "success" } }

Lia يجيب على كل مكالمة مرة واحدة، من خلال window.__lia.receive(...), مع { id, ok: true, result } أو { id, ok: false, error: { code, message? } }, ويُرسل الأحداث بنفس الطريقة كما يفعل { event, data }. الجسر يحدد window.__lia (مجمد، مرة واحدة لكل صفحة) ويتوافق الإجابات مع المكالمات من خلال المعرف.

#المكالمة

import { isLia, request, send } from '@lia-labs/bridge';

isLia(); // true inside the Lia app (or with mockLia)

const me = await request('init');
const { best } = await request('submitScore', { score: 1280 });
send('ready'); // without waiting for the answer; failures are dropped

request(method, params?, options?) يتم تحديده لكل طريقة: المعلمات التي تأخذها والإجابة التي تحللها تأتي من Methods نوع. يرفض بـ LiaError:

const controller = new AbortController();
const code = request('scanQr', { text: 'Scan a table' }, { signal: controller.signal, timeout: 60_000 });

#الاستماع

import { on, once, onAny, off } from '@lia-labs/bridge';

const stop = on('theme', ({ colorScheme, theme }) => repaint(colorScheme, theme));
once('resume', () => refresh());
onAny((event, data) => console.log(event, data));
stop();

الأحداث مُصنفة (Events): pause, resume, theme, viewport, fullscreenChanged, languageChanged, startParam, notificationsChanged, soundChanged, charge, ad, الأربعة *ButtonClicked الإجراءات، و sensor ({ name, values }; عندما يتحول SDK إلى كل مستشعر's reading). مستمع يطرح استثناء يتم تسجيله ولا يُعالج'لإيقاف الآخرين.

#كل ما يصدره

#واحد لكل صفحة

نسخة مزدوجة من الجسر في حزمة واحدة تشترك في مجموعة واحدة من المكالمات والمستمعين (تُحتفظ بها في رمز عالمي)، لذلك لا شيء يتعطل. يمكن لعلامة السكربت SDK أن'لمشاركة: إذا كان'س موجودة بالفعل على الصفحة، يحذرك الجسر ويمكنه'أن تسمع Lia'س الإجابات. استخدم واحدة أو الأخرى.

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