Skip to main content


Command Description

Use Laiye IDP to identify text in the specified screen area, and return result in JSON format

Command Prototype

jsonRet = Mage.ScreenOCRText(target,rect,config,time,optionArgs)

Parameter Description

targetTruedecorator@ui""Use mouse to select or cut off the target screen area including window, elements, range, etc
rectTruedictionary{"height":0,"width":0,"x":0,"y":0}The range that needs to be searched, the program will recognize in this range of the control, if the range is passed as {"x":0,"y":0,"width":0,"height":0}, then the control rectangle area Recognition within the scope
configTrueexpression{}Call configuration of Laiye IDP
timeTruenumber30000Specify the time in milliseconds to wait for a retry to find the text. If exceeded, an error will be thrown. Default: 30,000 milliseconds (30 seconds)
bContinueOnErrorNonebooleanNoneSpecify whether the automation should continue to support this field even if the activity is incorrect, it is only supported by the Boolean value (true, false) default value
iDelayAfterNonenumber300Delay time (in milliseconds) after executing the activity is 300 milliseconds
iDelayBeforeNonenumber200The delay time (in milliseconds) before any operations are executed is by default 200 milliseconds


jsonRet,The variable used to save the output of the command.


Dim config={"Pubkey":"","Secret":"","Url":""}  // Get from mage 
Dim rect={"height":0,"width":0,"x":0,"y":0} // Recognition range, currently the default value
Dim optionArgs={"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200} // Optional parameter, currently the default value

TracePrint "--------------------Screen Text Recognition--------------------"
// --------------------------------------------------------
// [Remarks] Identify the text content of the specified target on the screen
// Input parameter 1:
// target--target element, which is used in this example is the "Baidu click" button element after opening Baidu in chrome, which needs to be recorded by yourself
// Input parameter 2:
// rect--Recognition range.Type:Dict
// Input parameter 3:
// config--mage configuration, need to configure Pubkey and Secret.Type:Dict
// Input parameter 4:
// time--timeout time. Default unit: milliseconds. Type: Int
// Input parameter 5:
// optionArgs--optional parameters (including: error continue execution/delay after execution/delay before execution).Type:Dict

// Output parameters:
// jsonRet: The variable to which the output of the function call is saved

// Command prototype: jsonRet = Mage.ScreenOCRText(target,rect,config,time,optionArgs)
// --------------------------------------------------------

jsonRet = Mage.ScreenOCRText(@ui"input control <input>_ Baidu click",rect,config,30000,optionArgs)