BlocosIA Wiki Editor

التطبيق (Kodular / App Inventor)

صدّر المشروع بصيغة HTML، وافتحه في WebViewer في Kodular أو MIT App Inventor، وتبادل الرسائل مع التطبيق: أحداث، وطلبات بردود، و TinyDB، وتنبيهات، واهتزاز، ومشاركة، والكثير غير ذلك.

في التطبيق: يستقبل الحدث WebViewer.WebViewStringChange ما يرسله المشروع (نص أو JSON). لإرسال شيء إلى المشروع، استخدم WebViewer.RunJavaScript("blocosiaApp('voltar')") أو غيّر الخاصية WebViewString. للرد على طلب: RunJavaScript("blocosiaApp.responder(ID, 'valor')"). في المحرر، استخدم "حاكِ إرسال التطبيق…" للاختبار. اطّلع على الوصفة الكاملة في الويكي.

لاستخدامها: في المحرر، انقر على "الإضافات" (في الزاوية السفلية) وأضف "التطبيق (Kodular / App Inventor)".

نعم/لا

هل أنا داخل تطبيق (App Inventor / Kodular)؟

صحيح عندما يكون المشروع المُصدَّر مفتوحًا في WebViewer داخل App Inventor أو Kodular.

أمر

أرسل النص ( ) إلى التطبيق

ترسل نصًا إلى التطبيق: يطلق الحدث WebViewer.WebViewStringChange.

أمر

أرسل الحدث ( ) مع البيانات ( ) إلى التطبيق

ترسل حدثًا باسم مع بيانات بصيغة JSON: {"tipo":"evento","nome":…,"dados":…}.

أمر

اطلب من التطبيق: [أظهر تنبيهًا (toast)] ( )

تطلب من التطبيق ميزة من ميزات الهاتف: رسالة toast، اهتزاز، فتح رابط، مشاركة، نطق، نسخ، إشعار، إبقاء الشاشة مضاءة، الاتجاه، شاشة أخرى أو إغلاق.

أمر

اطلب ( ) من التطبيق مع البيانات ( ) وانتظر الرد

ترسل طلبًا برقم (id) وتنتظر إجابة التطبيق (حتى 10 ثوانٍ). يجيب التطبيق بـ RunJavaScript("blocosiaApp.responder(id, value)").

قيمة

رد التطبيق

الإجابة على آخر طلب.

نعم/لا

هل ردّ التطبيق؟

صحيح إذا أجاب التطبيق على آخر طلب في الوقت المحدد.

أمر

احفظ في التطبيق (TinyDB) الوسم ( ) بالقيمة ( )

تطلب من التطبيق تخزين قيمة في TinyDB (تبقى في الهاتف بعد إغلاق التطبيق).

أمر

اقرأ من التطبيق (TinyDB) الوسم ( ) وانتظر

تطلب من التطبيق وسم TinyDB وتنتظر؛ تذهب القيمة إلى "إجابة التطبيق".

قبعة

عندما يرسل التطبيق رسالة

تبدأ عندما يرسل التطبيق أي رسالة أو حدث.

قبعة

عندما يرسل التطبيق الحدث [رجوع]

تبدأ عندما يرسل التطبيق حدثًا بهذا الاسم (مثلًا back أو pause أو coin).

قيمة

الرسالة المستلمة من التطبيق

نص آخر رسالة وصلت من التطبيق.

قيمة

اسم الحدث المستلم

اسم آخر حدث وصل.

قيمة

البيانات المستلمة من التطبيق

بيانات آخر حدث (رقم أو نص أو قائمة أو كائن).

قيمة

WebViewString الخاص بالتطبيق

القيمة الحالية لخاصية WebViewString في التطبيق.

قيمة

المعامل ( ) من عنوان الصفحة

تقرأ معاملًا من عنوان الصفحة (مثلًا game.html?level=2 ← level = 2).

أمر

حاكِ إرسال التطبيق للحدث ( ) مع البيانات ( )

تتظاهر بأن التطبيق أرسل حدثًا: اختبر المشروع في المحرر دون هاتف.