مرجع SDK

الاهتزازات، مُاسح QR، الحافظة، الروابط، شاشات Lia الخاصة، وجوه ID ولمسات ID، وأجهزة الاستشعار الحركية.

#الاهتزازات

#Lia.haptic(kind)

لمسة يشعر بها الشخص. تُحل بـ null.

Lia.haptic("success");

نوع غير معروف يلعب "light". كل اهتزاز هو رحلة ذهاب وإياب إلى Lia، لذلك لا'للعب واحد في كل إطار من لعبة.

#المسح والלוח الافتراضي

#Lia.scanQr(options)

يفتح Lia'مُسحّن QR عبر تطبيقك. يتم حلها بالرمز'نصها أو null إذا أغلقه الشخص.

const text = await Lia.scanQr({ text: "Scan the code on the table" });

الأخطاء: bad_text, busy.

#Lia.copyText(text)

ينسخ النص إلى الحافظة، وLia يقول ذلك'مُنسخ. يُعيد القيمة null.

الأخطاء: bad_text, unsupported.

#Lia.readClipboard()

النص الموجود على الحافظة، أو null. على iPhone، يسأل الهاتف الشخص أولًا.

const pasted = await Lia.readClipboard();

#الروابط

#Lia.openLink(url, options)

يفتح صفحة ويب. يتم عرض إطاراتك فقط صفحاتك الخاصة، لذلك استخدم هذا لأي موقع آخر.

Lia.openLink("https://example.com/terms");               // in Lia's in-app browser, over your app
Lia.openLink("https://example.com", { external: true }); // outside Lia, in the phone's browser

يُحل بـ null مرة واحدة يتم إغلاق المتصفح الداخلي للتطبيق (أو فورًا لـ external). أخطاء: bad_url.

#Lia.openLiaLink(screen)

يفتح أحد Lia'شاشاته الخاصة. الصفحات تغلق تطبيقك أولاً (مع طلب، إذا قمت بتشغيل تأكيد الإغلاق مع فتحها كأنها نفسها؛ تفتح الأوراق فوق تطبيقك، بينما يبقى التطبيق.

Lia.openLiaLink("mine"); // Lia's mining sheet, over your app

يُحل بـ { closed }: true إذا أغلق تطبيقك، false إذا بقيت (أو اختار الشخص البقاء). أخطاء: unknown_screen, bad_screen.

#وجه ID ولمسة ID

#Lia.biometric

اسأل الشخص لتأكيد ذلك'أرسلها، مع الهاتف'س الوجه ID، أو اللمس ID أو البصمة، قبل شيء حساس في تطبيقك. يتعلم تطبيقك فقط ما إذا نجحوا.

#Lia.biometric.init()

سواء كان الهاتف يستطيع ذلك. يُعيد التحقق بـ { available, type }: available هو صحيح عندما يكون الهاتف لديه و'تم إعدادها; type هو "face", "finger" أو "unknown".

#Lia.biometric.authenticate(options)

يطلب من الشخص التأكيد. يُعيد النتيجة بـ { authenticated }. إذا استطاعوا'لاستخدام التعرف على الوجه، قد يعرض الهاتف رمز المرور الخاص به.

const { available } = await Lia.biometric.init();
if (available) {
  const { authenticated } = await Lia.biometric.authenticate({ reason: "Confirm it's you to open your vault" });
}

الأخطاء: unsupported, busy, bad_reason.

#الحركة

ثلاثة أجهزة استشعار، كل منها مع start, stop, isStarted وقراءته الأخيرة. تصل القراءات كأحداث بينما يعمل المستشعر ؛ يتوقف عندما تغلق تطبيقك. جميع الثلاثة اختيارية على الهواتف: start() يفشل بـ unsupported حيث هناك'لا شيء.

await Lia.deviceOrientation.start({ refreshRate: 50 });
Lia.on("deviceOrientationChanged", function (r) {
  steer(r.gamma); // tilting left and right
});
// later
Lia.deviceOrientation.stop();

#Lia.accelerometer

#Lia.gyroscope

نفس الشيء كما Lia.accelerometer, مع x, y و z معدلات الدوران.

#Lia.deviceOrientation

نفس الشيء، مع alpha, beta و gamma.

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