Screen
يتمتّع هذا النموذج بوظائف مشابهة لنموذج Region، باستثناء أنه يستخدم العرض والارتفاع الكاملين للجهاز
Screen:click()
لتنفيذ سلوك النقر المُعتمَد على المعاملات باستخدام MatchResult
Screen:clickAll()
لتنفيذ اكتشاف الصور/النصوص والنقر على إحداثيات التطابقات بشكل دفعي
Screen:exist()
للتحقق من وجود تطابق على شاشة الجهاز؛ إذا وُجد التطابُق تُعيد هذه الدالة true وإلا تُعيد false
Screen:existClick()
لإجراء اكتشاف صورة/نص والنقر على إحداثيات مطابقتها، إذا تم العثور على مطابقة فإن هذه الدالة تُعيد true
Screen:existClickAll()
لإجراء اكتشاف صورة/نص والنقر على إحداثيات مطابقتها، إذا تم العثور على مطابقة فإن هذه الدالة تُعيد true
Screen:find()
لإجراء بحث عن صورة أو نص في شاشة جهازك، إذا تم العثور على الصورة أو النص تُعيد MatchResult وإلا تُعيد nil
Screen:findAll()
لإجراء بحث عن صورة أو نص بشكل جماعي وإعادة قائمة من MatchResult
Screen:getColor()
للحصول على بكسل اللون في إحداثي معين، ويمكن لاحقًا استخدام هذا اللون للمقارنة لمعرفة ما إذا كان ذا درجة مطابقة مماثلة، وهو ما يفيد في إجراء اكتشاف الألوان
Screen:getColors()
للحصول على بكسل اللون في عدة إحداثيات في الوقت نفسه، ويمكن لاحقًا استخدام هذه الألوان للمقارنة لمعرفة ما إذا كان اللون ذا درجة مطابقة مماثلة، وهو ما يفيد في إجراء اكتشاف الألوان
Screen:getText()
تجري هذه الدالة عمليات OCR على شاشة الجهاز وتُعيد النص المدمج
Screen:getX()
الحصول على الإحداثي x للشاشة
Screen:getY()
الحصول على الإحداثي y للشاشة
Screen:height()
الحصول على ارتفاع الشاشة
Screen:highlight()
تُستخدم لإبراز الشاشة
Screen:multiSwipe()
إجراء سحب بمالا يصل إلى 10 أصابع في الوقت نفسه على الشاشة. يعمل كل إصبع وفقًا لخط زمني مستقل خاص به — النقر والتحريك والإمساك والرفع وفقًا لمعاملاته الخاصة.
Screen:screenshot()
التقاط لقطة شاشة لكامل شاشة الجهاز وحفظها في /data/data/com.androidmacro/images/$macroId/$fileName
Screen:swipe()
إجراء سحب بإصبع واحد على الشاشة. يُحدد مسار السحب بقائمة من قيم SwipePoint التي يتحرك الإصبع عبرها بالتسلسل.
Screen:wait()
الانتظار حتى يظهر القالب في الشاشة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً
Screen:waitVanish()
الانتظار حتى يختفي القالب أو يتلاشى من الشاشة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً
Screen:width()
الحصول على عرض الشاشة
Screen():waitClick()
الانتظار حتى تظهر صورة/نص على الشاشة ثم النقر عليه
Screen():getTextMatches()
الحصول على جميع مطابقات النصوص الموجودة على الشاشة منسقة بشكل صحيح