المُشغِّلات وأحداث تطبيقك

المُشغِّلات وأحداث تطبيقكالمُشغِّل قاعدة من جزأين: عندما يقع حدث، نفّذ إجراءً أو أكثر. تستخدم عدسات الوجه وتأثيرات الشاشة المُشغِّلات على حد سواء، ويمكن أن يضم العنصر ما يصل إلى 32 مُشغِّلًا.المُشغِّلات بيانات لا شيفرة. فالعدسة أو التأثير المنشور ليس سوى ملف بيان (manifest) وصوره، ولا يحتوي على أي نص برمجي، لذا لا يُشغّل تطبيقك أبدًا شيفرة قادمة من IngevoraMirage.إضافة مُشغِّل

اختر Add trigger (إضافة مُشغِّل) في لوحة Triggers.

اختر Event source (مصدر الحدث) وEvent name (اسم الحدث).

اضبط الإجراء الأول: نوعه، والطبقة أو المقطع الذي يعمل عليه. ويضيف Add action مزيدًا من الإجراءات.

لا يعرض كل إجراء إلا الطبقات التي يمكنه العمل عليها.الأحداث

مصدر الحدث

أسماء الأحداث

عدسات الوجه

تأثيرات الشاشة

دورة الحياة

lens.started

نعم

—

دورة الحياة

effect.started، effect.ended

—

نعم

إشارة الوجه

mouth.open، smile، blink، brows.raised، head.tilt

نعم

—

حدث المضيف

أي اسم يختاره تطبيقك

نعم

إشارات الوجهتُقرأ كل إشارة وجه بقيمة من 0 إلى 1 في كل إطار:

mouth.open — مقدار انفراج الشفتين.

smile — مقدار اتساع زاويتَي الفم.

blink — مقدار انغلاق العينين.

brows.raised — مقدار ارتفاع الحاجبين فوق العينين.

head.tilt — مقدار ميل الرأس إلى أي من الجانبين؛ وتبلغ 1 عند 30 درجة أو أكثر.

ينطلق مُشغِّل الوجه حين ترتفع إشارته إلى العتبة، وهي 0.5 ما لم تحدد Custom threshold (عتبة مخصصة) وتضبط قيمتك بين 0 و1. وبعد انطلاقه، يجب أن تنخفض الإشارة إلى ما دون العتبة ناقص 0.1 قبل أن يتمكن المُشغِّل من الانطلاق مجددًا. لا يوجد مؤقت. وما دام لا يُتتبَّع أي وجه، تنتظر مُشغِّلات الوجه، ثم تعود جاهزة حين يظهر وجه من جديد.يعرض خيار Show face signals (إظهار إشارات الوجه)، أسفل عارض الوجه، القيم الحية أثناء اختيارك للعتبة.أحداث دورة الحياةينطلق lens.started مرة واحدة، في الإطار الأول لعدسة الوجه. وينطلق effect.started عند الزمن 0 لتأثير الشاشة، وeffect.ended عند نهايته. ولا تظهر نتيجة للإجراءات المرتبطة بـ effect.ended، لأنه لا يُرسم شيء بعد النهاية.أحداث تطبيقكحدث المضيف اسمٌ يرسله تطبيقك أثناء تشغيل عدسة أو تأثير، مثل round.start أو level.complete. تحدد IngevoraMirage آلية عمل الأحداث، وأنت تختار الأسماء. يبدأ الاسم بحرف لاتيني صغير ولا يستخدم إلا الحروف الصغيرة والأرقام و. و_ و-، بحد أقصى 64 حرفًا إجمالًا.

يسري الحدث في الإطار التالي.

الحدث المُرسَل قبل بدء العدسة أو التأثير، أو بعد انتهائه، يُهمَل. ولا يُوضع أبدًا في قائمة انتظار.

الحدث الذي لا يستمع إليه أي مُشغِّل يُتجاهَل.

اتفق على الأسماء مع مطوريك. فالاستوديو لا يمكنه معرفة الأحداث التي يرسلها تطبيقك فعلًا.الإجراءات

الإجراء

يعمل على

ما يفعله

Show

أي طبقة

يجعل الطبقة مرئية.

Hide

أي طبقة

يُخفيها. إخفاء الجسيمات يمسحها ويوقف ظهور جسيمات جديدة؛ وإخفاء الحركة يوقفها. وتستمر الرسوم المتحركة المخفية في التشغيل دون أن تُرى.

Play sprite

الرسوم المتحركة، والرسوم المتحركة بملء الشاشة، والرسوم المتحركة (sprite)

يُظهر الطبقة ويُشغّلها من إطارها الأول، ويعيد تشغيلها إن كانت قيد التشغيل.

Emit particles

جسيمات الوجه، والجسيمات

يُظهر الطبقة ويقذف عدد Count من الجسيمات دفعة واحدة. وتُهمَل الجسيمات التي تتجاوز Max particles alive.

Run motion

الحركة (في تأثيرات الشاشة فقط)

يُظهر الحركة ويُشغّلها من البداية، ويعيد تشغيلها إن كانت قيد التشغيل.

Play animation

مقطع إطارات مفتاحية

يُظهر طبقة المقطع ويُشغّل المقطع من البداية، ليحلّ محل أي مقطع يعمل على تلك الطبقة.

حين يطابق حدث واحد عدة مُشغِّلات، تُنفَّذ بترتيب القائمة، وتُنفَّذ إجراءات كل مُشغِّل بالترتيب. والإجراءات اللاحقة هي التي تسري: فإجراء Show يتبعه Hide في الإطار نفسه يترك الطبقة مخفية.تجربة المُشغِّلات في الاستوديو

تسرد قائمة Fire event (إطلاق حدث) في شريط الأدوات الأحداث التي تستمع إليها مُشغِّلاتك. وتحتاج إشارة الوجه إلى وجه مُتتبَّع؛ إذ يضبطها الاستوديو على 1 لإطار واحد كي ينطلق المُشغِّل.

اكتب أي اسم في مربع Host event واختر Send.

يُشغّل Restart العنصر من البداية، فينطلق lens.started أو effect.started مجددًا.

على الهاتف، تحتوي صفحة الاختبار على هاتفك على زر لكل حدث مضيف تستخدمه العدسة.

صفحات ذات صلة

عدسات الوجه وتأثيرات الشاشة — الطبقات التي تعمل عليها الإجراءات.

الحركة بالإطارات المفتاحية — مقاطع Play animation.