لعبة MonkeyRunner
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
فئة cloudrunner - تتضمن طرقًا مساعِدة ثابتة.
ملخّص
| الطرق |
|
إلغاء
|
تنبيه
(رسالة سلسلة،
عنوان سلسلة،
سلسلة okTitle)
يتم عرض مربّع حوار للتنبيه بشأن عملية تنفيذ البرنامج
الحالي.
|
|
عدد صحيح
|
choice
(رسالة سلسلة،
خيارات قابلة للتكرار،
عنوان سلسلة)
تعرض مربّع حوار يتضمن قائمة بالخيارات المتعلقة بالعملية التي يتم فيها تشغيل البرنامج الحالي.
|
|
إلغاء
|
المساعدة
(تنسيق سلسلة)
تعرض مرجع واجهة برمجة التطبيقات monkeyrunner بأسلوب يشبه نمط أداة pydoc في Python، وذلك باستخدام التنسيق المحدَّد.
|
|
سلسلة
|
إدخال
(رسالة سلسلة،
سلسلة ومبدئية،
سلسلة العنوان،
سلسلة okTitle،
سلسلة cancelTitle)
يتم عرض مربّع حوار يقبل الإدخال.
|
|
إلغاء
|
النوم
(عدد ثواني العائم)
إيقاف البرنامج الحالي مؤقتًا للعدد المحدد من الثواني.
|
MonkeyDevice
|
returnForConnection
(مهلة float،
string رقم تعريف الجهاز)
يحاول إجراء اتصال بين الواجهة الخلفية monkeyrunner والجهاز أو المحاكي المحدّد.
|
الطرق المتاحة للجميع
سلسلة
تنبيه
(
رسالة سلسلة،
عنوان سلسلة،
سلسلة okTitle)
يتم عرض مربّع حوار للتنبيه بشأن عملية تنفيذ البرنامج
الحالي. يظهر مربّع الحوار هذا بشكل نمطي، وبالتالي يتوقف البرنامج مؤقتًا إلى أن ينقر المستخدم على زرّ مربّع الحوار.
الوسيطات
| رسالة |
الرسالة التي سيتم عرضها في مربّع الحوار.
|
| title |
عنوان مربّع الحوار. القيمة التلقائية هي "تنبيه".
|
| okTitle |
النص المعروض في زر مربّع الحوار القيمة التلقائية هي "OK".
|
عدد صحيح
الاختيار
(رسالة سلسلة،
خيارات قابلة للتكرار،
عنوان سلسلة)
تعرض مربّع حوار يتضمن قائمة بالخيارات المتعلقة بالعملية التي يتم فيها تشغيل البرنامج الحالي. يكون
مربّع الحوار مشروطًا، وبالتالي يتوقف البرنامج مؤقتًا إلى أن ينقر المستخدم على أحد أزرار
مربّع الحوار.
الوسيطات
| رسالة |
رسالة الطلب المعروضة في مربّع الحوار
|
| اخْتِيَارَاتْ |
يشير ذلك المصطلح إلى نص قابل للتكرار في Python يحتوي على كائن واحد أو أكثر يتم عرضه كسلاسل. والنموذج المقترَح هو مصفوفة من السلاسل.
|
|
title
|
عنوان مربّع الحوار. القيمة التلقائية هي "الإدخال".
|
الركلات المردودة
-
إذا اختار المستخدم الزر "حسنًا" ونقر على الزر "حسنًا"، تعرض الطريقة
الفهرس المستند إلى 0 للاختيار ضمن قابل للتكرار.
إذا نقر المستخدم على زر "إلغاء"، ستعرض الطريقة -1.
تعرض مرجع واجهة برمجة التطبيقات monkeyrunner بأسلوب يشبه نمط أداة pydoc في Python، وذلك باستخدام التنسيق المحدَّد.
الوسيطات
| الصيغة |
تمثّل هذه السمة تنسيق الترميز المطلوب استخدامه في الإخراج. والقيم المحتملة هي "نص" للنص العادي أو "html" للغة HTML.
|
يتم عرض مربّع حوار يقبل الإدخال وإعادته إلى البرنامج. ويكون مربّع الحوار
نمطيًا، وبالتالي يتوقف البرنامج مؤقتًا إلى أن ينقر المستخدم على أحد أزرار مربّع الحوار.
يتضمّن مربّع الحوار زرَّين، أحدهما يعرض قيمة okTitle ويعرض الآخر قيمة cancelTitle. وإذا نقر المستخدم على الزر okTitle،
يتم عرض القيمة الحالية لمربّع الإدخال. إذا نقر المستخدم على الزر cancelTitle، سيتم عرض سلسلة فارغة.
الوسيطات
| رسالة |
رسالة الطلب المعروضة في مربّع الحوار
|
| القيمة المبدئية |
القيمة الأولية التي سيتم عرضها في مربع الحوار. القيمة التلقائية هي سلسلة فارغة.
|
| title |
عنوان مربّع الحوار. القيمة التلقائية هي "الإدخال".
|
| okTitle |
النص المعروض في الزر okTitle. الإعداد التلقائي هو "حسنًا".
|
| إلغاء العنوان |
النص المعروض في الزر cancelTitle. الخيار التلقائي هو "إلغاء".
|
الركلات المردودة
-
إذا نقر المستخدم على الزر okTitle، ستعرض الطريقة القيمة الحالية لمربّع إدخال مربّع الحوار. إذا نقر المستخدم على الزر cancelTitle، ستعرض الطريقة سلسلة فارغة.
فارغ
النوم
(
الثانية)
)
إيقاف البرنامج الحالي مؤقتًا للعدد المحدد من الثواني.
الوسيطات
| ثانية |
عدد الثواني المطلوب إيقافها مؤقتًا.
|
MonkeyDevice
انتظار_الاتصال
(مهلة float،
string deviceId)
يحاول إجراء اتصال بين الواجهة الخلفية monkeyrunner والجهاز أو المحاكي المحدّد.
الوسيطات
| وقت مستقطع |
عدد الثواني المطلوب انتظارها حتى يتم الاتصال. الإعداد التلقائي هو الانتظار للأبد.
|
|
رقم تعريف الجهاز
|
تعبير عادي يحدد الرقم التسلسلي للجهاز أو المحاكي راجِع الموضوع Android Debug Bridge للتعرّف على وصف الجهاز والأرقام التسلسلية للمحاكي.
|
الركلات المردودة
-
مثيل
MonkeyDevice للجهاز أو المحاكي. استخدِم هذا الكائن للتحكّم في الجهاز أو المحاكي والتواصل معه.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# MonkeyRunner\n\nA monkeyrunner class that contains static utility methods.\n\nSummary\n-------\n\n| Methods ||||||||||||\n|------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|---|---|---|---|---|---|---|---|---|\n| void | [alert](#alert) (*string* message, *string* title, *string* okTitle) Displays an alert dialog to the process running the current program. |\n| *integer* | [choice](#choice) (*string* message, *iterable* choices, *string* title) Displays a dialog with a list of choices to the process running the current program. |\n| void | [help](#help) (*string* format) Displays the monkeyrunner API reference in a style similar to that of Python's `pydoc` tool, using the specified format. |\n| *string* | [input](#input) (*string* message, *string* initialValue, *string* title, *string* okTitle, *string* cancelTitle) Displays a dialog that accepts input. |\n| void | [sleep](#sleep) (*float* seconds) Pauses the current program for the specified number of seconds. |\n| ` `[MonkeyDevice](/tools/help/MonkeyDevice)` ` | [waitForConnection](#waitForConnection) (*float* timeout, *string* deviceId) Tries to make a connection between the `monkeyrunner` backend and the specified device or emulator. |\n\nPublic methods\n--------------\n\n#### *string*\nalert\n( *string* message, *string* title, *string* okTitle)\n\n\nDisplays an alert dialog to the process running the current\nprogram. The dialog is modal, so the program pauses until the user clicks the dialog's\nbutton. \n\n##### Arguments\n\n| message | The message to display in the dialog. |\n| title | The dialog's title. The default value is \"Alert\". |\n| okTitle | The text displayed in the dialog button. The default value is \"OK\". |\n|---------|---------------------------------------------------------------------|\n\n#### *integer*\nchoice\n(*string* message, *iterable* choices, *string* title)\n\n\nDisplays a dialog with a list of choices to the process running the current program. The\ndialog is modal, so the program pauses until the user clicks one of the dialog's\nbuttons. \n\n##### Arguments\n\n| message | The prompt message displayed in the dialog. |\n| choices | A Python iterable containing one or more objects that are displayed as strings. The recommended form is an array of strings. |\n| title | The dialog's title. The default is \"Input\". |\n|---------|------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- If the user makes a selection and clicks the \"OK\" button, the method returns the 0-based index of the selection within the iterable. If the user clicks the \"Cancel\" button, the method returns -1. \n\n#### void\nhelp\n(*string* format)\n\n\nDisplays the monkeyrunner API reference in a style similar to that of Python's\n`pydoc` tool, using the specified format. \n\n##### Arguments\n\n| format | The markup format to use in the output. The possible values are \"text\" for plain text or \"html\" for HTML. |\n|--------|-----------------------------------------------------------------------------------------------------------|\n\n#### *string*\ninput\n(*string* message *string* initialValue, *string* title, *string* okTitle, *string* cancelTitle)\n\n\nDisplays a dialog that accepts input and returns it to the program. The dialog is\nmodal, so the program pauses until the user clicks one of the dialog's buttons.\n\n\nThe dialog contains two buttons, one of which displays the okTitle value\nand the other the cancelTitle value. If the user clicks the okTitle button,\nthe current value of the input box is returned. If the user clicks the cancelTitle\nbutton, an empty string is returned. \n\n##### Arguments\n\n| message | The prompt message displayed in the dialog. |\n| initialValue | The initial value to display in the dialog. The default is an empty string. |\n| title | The dialog's title. The default is \"Input\". |\n| okTitle | The text displayed in the okTitle button. The default is \"OK\". |\n| cancelTitle | The text displayed in the cancelTitle button. The default is \"Cancel\". |\n|--------------|-----------------------------------------------------------------------------|\n\n##### Returns\n\n- If the user clicks the okTitle button, then the method returns the current value of the dialog's input box. If the user clicks the cancelTitle button, the method returns an empty string. \n\n#### void\nsleep\n( *float* seconds )\n\n\nPauses the current program for the specified number of seconds. \n\n##### Arguments\n\n| seconds | The number of seconds to pause. |\n|---------|---------------------------------|\n\n#### `\n`[MonkeyDevice](/tools/help/MonkeyDevice)`\n`\nwaitForConnection\n(*float* timeout, *string* deviceId)\n\n\nTries to make a connection between the `monkeyrunner` backend and the\nspecified device or emulator. \n\n##### Arguments\n\n| timeout | The number of seconds to wait for a connection. The default is to wait forever. |\n| deviceId | A regular expression that specifies the serial number of the device or emulator. See the topic [Android Debug Bridge](/tools/help/adb) for a description of device and emulator serial numbers. |\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- A [MonkeyDevice](/tools/help/MonkeyDevice) instance for the device or emulator. Use this object to control and communicate with the device or emulator."]]
