إنتقل إلى المحتوى الرئيسي

263 مستندات موسومة مستند موسوم بـ "مرجع"

عرض كل الوسوم

CheckBox()

يضيف مربع اختيار إلى عرض مربع الحوار

ClickParams()

مفيدة لتحديد معاملات حدث النقر

ClickParams():setDelay()

يمكنك تعيين تأخير النقر بالمللي ثانية باستخدام هذه الدالة

ClickParams():setOffset()

عند تعيين المطابقة أو الإحداثيات، سيتم إزاحة موضع النقر بناءً على إحداثيَّي x و y

Clipboard:paste()

يلصق نص الحافظة الحالي في حقل الإدخال المُحدَّد.

Color()

فئة مساعدة لإجراء مقارنة تشابه الألوان

Color():blue()

يستخرج قيمة اللون الأزرق من سلسلة لون سداسية عشرية.

Color():getHex()

يُعيد سلسلة اللون السداسية العشرية

Color():green()

يستخرج قيمة اللون الأخضر من سلسلة لون سداسية عشرية.

Color():isEqual()

تتحقّق ما إذا كان اللونان متطابقين بدرجة تشابه تساوي 1

Color():red()

يستخرج قيمة اللون الأحمر من سلسلة لون سداسية عشرية.

Column()

يضيف عرض عمود إلى مربع الحوار

DateTime()

أداة مساعدة لإجراء عمليات حسابات التاريخ والوقت.

DateTime():add()

يضيف مقدارًا محددًا من الوقت إلى كائن DateTime.

DateTime():day()

يعيد يوم الأسبوع من كائن DateTime. (الأحد هو 0، والاثنين هو 1، وهكذا).

DateTime():diff()

يحسب الفرق بين كائن DateTime الحالي وكائن DateTime آخر.

DateTime():endOf()

يضبط كائن DateTime إلى نهاية وحدة زمنية محددة (مثال: نهاية اليوم، نهاية الشهر).

DateTime():hour()

يعيد ساعة اليوم من كائن DateTime. (بنظام 24 ساعة، 0-23).

DateTime():hour()

يضبط ساعة اليوم في كائن DateTime. (بنظام 24 ساعة، 0-23).

DateTime():isAfter()

يتحقق ما إذا كان كائن DateTime الحالي بعد كائن DateTime آخر.

DateTime():isBefore()

يتحقق ما إذا كان كائن DateTime الحالي قبل كائن DateTime آخر.

DateTime():isBetween()

يتحقق ما إذا كان كائن DateTime الحالي واقعًا بين كائنين آخرين من DateTime (شاملًا الطرفين).

DateTime():isSame()

يتحقق ما إذا كان كائن DateTime الحالي مطابقًا لكائن DateTime آخر.

DateTime():isSameOrAfter()

يتحقق ما إذا كان كائن DateTime الحالي مطابقًا لكائن DateTime آخر أو يأتي بعده.

DateTime():isSameOrBefore()

يتحقق ما إذا كان كائن DateTime الحالي مطابقًا لكائن DateTime آخر أو يأتي قبله.

DateTime():local()

يحوّل المنطقة الزمنية لكائن DateTime إلى المنطقة الزمنية المحلية الافتراضية للنظام.

DateTime():month()

يعيد شهر كائن DateTime. (يبدأ من 1، حيث يناير هو 1).

DateTime():month()

يضبط شهر كائن DateTime. (يبدأ من 1، حيث يناير هو 1).

DateTime():startOf()

يضبط كائن DateTime إلى بداية وحدة زمنية محددة (مثال: بداية اليوم، بداية الشهر).

DateTime():toISOString()

يُعيد نص التاريخ منسّقًا وفق معيار ISO 8601 (مثل "1970-01-01T0000.000Z").

DateTime():tz()

يضبط المنطقة الزمنية لكائن DateTime على معرّف منطقة زمنية محدد.

DateTime():unix()

يعيد طابع يونكس الزمني (Unix timestamp) (الثواني منذ بداية حقبة يونكس) لكائن DateTime.

DateTime():utc()

يحوّل المنطقة الزمنية لكائن DateTime إلى UTC.

DateTime():valueOf()

يعيد القيمة الأولية لكائن DateTime، وهي عدد المللي ثانية منذ بداية حقبة يونكس (Unix epoch).

Dialog:add()

يضيف عرضًا إلى مربع الحوار، حاليًا يمكنك إضافة عرض استنادًا إلى هذا المعامل فقط

Dialog:getValueById()

هذه الدالة مفيدة للحصول على قيمة EditText أو CheckBox أو RadioGroup بناءً على المُعرّف

Dialog:getValueOf()

هذه الدالة مفيدة للحصول على قيمة EditText أو CheckBox أو RadioGroup

Dialog:init()

لبدء استخدام مربع الحوار وعرضه، تُستخدم هذه الدالة لتهيئة مربع الحوار

Dialog:remove()

يزيل عرضًا من عرض مربع الحوار بناءً على مُعرّفه

Dialog:show()

إذا استدعيت هذه الدالة، سيظهر مربع الحوار منبثقًا على الشاشة

EditText()

يضيف حقل إدخال نص إلى عرض مربع الحوار

FinderParams()

مفيدة لتحديد معاملات اكتشاف البحث.

FinderParams():isGrayscale()

تُعيد هذه الدالة قيمة منطقية تشير إلى ما إذا كان البحث عن الصور/النصوص سيُجرى في وضع التدرج الرمادي.

FinderParams():isHighlight()

يُعيد قيمة منطقية تشير إلى ما إذا كان الاكتشاف سيُميَّز أم لا.

FinderParams():setDelay()

يمكنك ضبط تأخير البحث عن الصور/النصوص بالمللي ثانية باستخدام هذه الدالة.

FinderParams():setDynamicScaling()

يضبط ما إذا كان سيتم استخدام القياس الديناميكي أثناء الاكتشاف (مفيد لدعم الشاشات المتعددة).

FinderParams():setHighlight()

يُخبر هذا المعامل الماكرو بإظهار تمييز الاكتشاف على شاشة جهازك.

Keyboard

وحدة مفيدة لكتابة النص على شاشة جهازك

Keyboard:type()

تقوم هذه الدالة بمحاكاة الكتابة على لوحة المفاتيح على شاشتك، لكنها تعمل فقط مع أي مدخل نصي ولا تعمل في بعض التطبيقات

Macro:getList()

يحصل على قائمة وحدات الماكرو الموجودة لديك

Macro()

وحدة إضافية لاستدعاء أو تنفيذ الماكرو الخاص بك برمجيًا أثناء التشغيل

MatchResult:getX()

تُعيد الإحداثي X للزاوية العلوية اليسرى من المنطقة المطابقة.

MatchResult:getY()

تُعيد الإحداثي Y للزاوية العلوية اليسرى من المنطقة المطابقة.

Point()

إحداثيا الشاشة x و y

RadioButton()

يضيف زر اختيار إلى عرض مربع الحوار

RadioGroup()

إضافة مجموعة أزرار اختيار إلى عرض مربع الحوار، حيث يحتوي كل عرض فرعي على زر اختيار

Record

وحدة مفيدة لإعادة تشغيل إيماءاتك/لمساتك

Region()

الوحدة الأساسية لاكتشاف وإجراء أتمتة واجهة المستخدم في منطقة اهتمام وهي جزء من شاشة الجهاز

Region():click()

لإجراء سلوك نقر ذي معاملات باستخدام MatchResult

Region():clickAll()

لإجراء اكتشاف صورة/نص والنقر على إحداثيات مطابقتها بشكل جماعي

Region():exist()

للتحقق مما إذا كانت المطابقة موجودة في المنطقة، إذا تم العثور على مطابقة فإن هذه الدالة تُعيد true وإلا تُعيد false

Region():existClick()

لإجراء اكتشاف صورة/نص والنقر على إحداثيات مطابقتها، إذا تم العثور على مطابقة فإن هذه الدالة تُعيد true

Region():existClickAll()

لإجراء اكتشاف صورة/نص والنقر على إحداثيات مطابقتها، إذا تم العثور على مطابقة فإن هذه الدالة تُعيد true

Region():find()

لإجراء بحث عن صورة أو نص في المنطقة، إذا تم العثور على الصورة أو النص تُعيد MatchResult وإلا تُعيد nil

Region():findAll()

لإجراء بحث عن صورة أو نص بشكل جماعي وإعادة قائمة من MatchResult

Region():getColor()

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

Region():getColors()

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

Region():getText()

تجري هذه الدالة عمليات OCR في منطقة الاهتمام وتُعيد النص المدمج

Region():getTextMatches()

الحصول على جميع مطابقات النصوص الموجودة في المنطقة منسقة بشكل صحيح

Region():multiSwipe()

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

Region():screenshot()

التقاط لقطة شاشة للمنطقة وحفظها في /data/data/com.androidmacro/images/$macroId/$fileName

Region():wait()

الانتظار حتى يظهر القالب في المنطقة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً

Region():waitVanish()

الانتظار حتى يختفي القالب أو يتلاشى من المنطقة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً

Request()

وحدة لإجراء طلبات شبكية إلى الإنترنت تم تقديمها في الإصدار 1.0.0.31

Request():delete()

ينفّذ طلب DELETE ويُعيد كائن Response. تُستخدم هذه الدالة لحذف مورد من الخادم.

Request():get()

ينفّذ طلب GET ويُعيد كائن Response. تُستخدم هذه الدالة لاسترجاع البيانات من عنوان محدد.

Request():patch()

ينفّذ طلب PATCH ويُعيد كائن Response. تُستخدم هذه الدالة لتحديث جزئي لمورد على الخادم.

Request():post()

ينفّذ طلب POST ويُعيد كائن Response. تُستخدم هذه الدالة لإرسال البيانات إلى الخادم، عادةً لإنشاء مورد جديد.

Request():put()

ينفّذ طلب PUT ويُعيد كائن Response. تُستخدم هذه الدالة لاستبدال مورد بالكامل على الخادم.

Request():setHeader()

تضيف ترويسة (header) جديدة لطلبات HTTP. تتيح لك هذه الدالة إضافة ترويسات HTTP مخصّصة إلى طلبك قبل إرساله.

Request():setParameter()

تضيف معاملاً لمتن الطلب (يُستخدم مع طلبات POST/PUT/PATCH). تتيح لك هذه الدالة إضافة بيانات سيتم إرسالها في متن الطلب.

Response

يحتوي كائن Response على نتيجة طلب HTTP تم إجراؤه باستخدام وحدة Request. يوفر الوصول إلى بيانات الاستجابة ورمز الحالة والبيانات الوصفية الأخرى التي يُعيدها الخادم.

Response:getData()

يحصل على محتوى متن الاستجابة كسلسلة نصية من استجابة HTTP.

Row()

يضيف عرض صف إلى مربع الحوار

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:multiSwipe()

إجراء سحب بمالا يصل إلى 10 أصابع في الوقت نفسه على الشاشة. يعمل كل إصبع وفقًا لخط زمني مستقل خاص به — النقر والتحريك والإمساك والرفع وفقًا لمعاملاته الخاصة.

Screen:screenshot()

التقاط لقطة شاشة لكامل شاشة الجهاز وحفظها في /data/data/com.androidmacro/images/$macroId/$fileName

Screen:swipe()

إجراء سحب بإصبع واحد على الشاشة. يُحدد مسار السحب بقائمة من قيم SwipePoint التي يتحرك الإصبع عبرها بالتسلسل.

Screen:wait()

الانتظار حتى يظهر القالب في الشاشة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً

Screen:waitVanish()

الانتظار حتى يختفي القالب أو يتلاشى من الشاشة، وإذا انتهت المهلة فإن هذه الدالة ستُصدر خطأً

Screen():getTextMatches()

الحصول على جميع مطابقات النصوص الموجودة على الشاشة منسقة بشكل صحيح

Screen():waitClick()

الانتظار حتى تظهر صورة/نص على الشاشة ثم النقر عليه

Settings:cacheOff()

عند تعطيل هذا الخيار، لن يستخدم الماكرو إطار الصورة المخزّن مؤقتًا.

Settings:cacheOn()

عند تفعيل هذا الخيار، سيخزّن الماكرو ذاكرة مؤقتة للاحتفاظ بالإطار الأخير. عادةً ما يلتقط الماكرو شاشة الجهاز في كل مرة يتوفر فيها إطار، وهي عملية شاقة، ولمنع ذلك يمكنك استخدام هذا الخيار.

Settings:getMinScore()

يُعيد درجة المطابقة الدنيا كعتبة عند إجراء اكتشاف النصوص أو الصور.

Settings:getScanInterval()

يُعيد تأخير اكتشاف النصوص أو الصور في الماكرو قيد التشغيل حاليًا.

Settings:grayscaleOff()

عند تعطيل هذا الخيار، ستتم معالجة اكتشاف النصوص أو الصور في الوضع العادي.

Settings:grayscaleOn()

عند تفعيل هذا الخيار، ستتم معالجة اكتشاف النصوص أو الصور في وضع التدرج الرمادي، وهو ما يفيد في تسريع عملية الاكتشاف.

Settings:isGrayscale()

يتحقق مما إذا كان اكتشاف النصوص أو الصور يُعالَج في وضع التدرج الرمادي.

Settings:setClickDelay()

يغيّر تأخير النقر بالكامل في الماكرو قيد التشغيل حاليًا.

Settings:setComparisonHeight()

يغيّر ارتفاع المقارنة؛ وارتفاع المقارنة هذا هو متغير أو ثابت يستخدمه Android Macro لحساب دقة الشاشة بين جهازين لهما نفس نسبة العرض إلى الارتفاع.

Settings:setComparisonWidth()

يغيّر عرض المقارنة؛ وعرض المقارنة هذا هو متغير أو ثابت يستخدمه Android Macro لحساب دقة الشاشة بين جهازين لهما نفس نسبة العرض إلى الارتفاع.

Settings:setMinScore()

يغيّر درجة العتبة الدنيا عند إجراء اكتشاف النصوص أو الصور.

Settings:setSwipeDelay()

يغيّر تأخير السحب بالكامل في الماكرو قيد التشغيل حاليًا.

Storage:read()

قراءة قيمة مخزَّنة باستخدام مفتاحها.

SwipeParams()

مفيدة لتحديد معاملات أحداث السحب (التمرير)

SwipeParams():setContinue()

يمكنك تحديد ما إذا كانت كل نقطة من نقاط السحب متصلة (مستمرة)، مما يعني أن الإصπο الذي يسحب لا يتم رفعه عن الشاشة.

SwipeParams():setDelay()

يمكنك ضبط تأخير السحب بالمللي ثانية باستخدام هذه الطريقة

SwipePoint()

يمثّل نقطة في مسار السحب. تُستخدم مع ‎ScreenmultiSwipe()‎ لتحديد الموضع الذي يتحرك إليه الإصبع وسرعته ومدة توقّفه.

TextView()

يضيف حقل عرض نص إلى عرض مربع الحوار

ToastParams()

مفيدة لتحديد معاملات الرسائل المنبثقة

ToastParams():getPadding()

يُعيد التبطين (padding) الحالي كمصفوفة أرقام ‎[left, top, right, bottom]‎

ToastParams():setOpacity()

يمكنك تعيين مستوى شفافية الإشعار المنبثق باستخدام هذه الدالة (من 0.0 إلى 1.0)

ToastParams():setPosition()

يمكنك تعيين موضع الإشعار المنبثق على الشاشة باستخدام إحداثيَّي x و y

ToastParams():setTextColor()

يمكنك تعيين لون نص الإشعار المنبثق (مثال: ‎"#FF0000"‎ أو ‎"#AARRGGBB"‎)

Toolbar:getScale()

الحصول على عامل مقياس شريط الأدوات الحالي.

Toolbar:isAvailable()

التحقق مما إذا كانت خدمة شريط الأدوات العائم متاحة.

Toolbar:isSnapped()

التحقق مما إذا كان شريط الأدوات في حالة التصاق حاليًا.

Toolbar:isVisible()

التحقق مما إذا كان شريط الأدوات مرئيًا حاليًا على الشاشة.

Toolbar:setCollapse()

تفعيل أو تعطيل وضع الدائرة المطوية لشريط الأدوات.

Toolbar:setPosition()

نقل شريط الأدوات العائم إلى موضع محدد على الشاشة.

Toolbar:setSnap()

تفعيل أو تعطيل وضع الالتصاق بالحافة لشريط الأدوات.

Touch

واجهة للتعامل مع تفاعلات اللمس على أجهزة أندرويد.

Touch:dispatch()

يرسل جميع أحداث اللمس المعلقة إلى النظام. تكون هذه الدالة مفيدة عندما ترغب في ضمان معالجة جميع أحداث اللمس على الفور.

Touch:down()

ينفّذ إجراء لمس للأسفل عند الإحداثيات أو النقطة المحددة.

Touch:exit()

يخرج وينظّف واجهة اللمس. يجب استدعاء هذه الدالة عندما تنتهي من استخدام واجهة اللمس.

Touch:init()

يُهيّئ واجهة اللمس. يجب استدعاء هذه الدالة قبل استخدام أي دوال لمس أخرى.

Touch:move()

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

Touch:up()

ينفّذ إجراء رفع اللمس، مما يحرر اللمس عند الموضع الحالي.

Utils

فئة مساعدة لإظهار الإشعارات المنبثقة والتنبيهات والانتظار والمزيد

Utils:sleep()

يضيف فترة انتظار إلى الماكرو

Utils:toast()

يُظهر إشعارًا منبثقًا على الشاشة

الإعدادات

مفيدة لتعديل إعدادات الماكرو وتحسين أدائه.

النظام

فئة مساعدة للضغط على أزرار النظام

شريط الأدوات

وحدة مساعدة للتحكم في شريط أدوات Android Macro العائم من Lua.