The DoReactStr method

The DoReactStr method generates the response actions for the objects. It sends the action to the specified object. The action is transferred directly to the kernel where the object belongs, and not to the whole system. The action is specified as a group of String arguments.

Method call syntax

 function DoReactStr(objtype : String, id : String, action : String, param<value> [, param<value>] : String)

Method arguments:

1. objtype - Required argument. The type of the object that the action should be generated for. It takes the following values:  Type – String, range – existing object types.
2. id - Required argument. Identification number of the object of the type set in the objtype argument. It takes the following values:  Type – String, range – existing identification numbers of the objects of the specified type.
3. action - Required argument. The action to be generated. It takes the following values:  Type – String, range – available actions for the objects of the specified type.
4. param<value> - Required argument. Several arguments of this type can be specified. The parameters of the action.

One parameter has the following syntax:

"param<value>", where

param – name of the parameter;

value – value of the parameter.

Several parameters have the following syntax:

"param1<value1>,param2<value2>…"

Elements of the list are separated by commas with no white space. If no parameters need to be specified, an empty string is used:

DoReactStr("CAM","1","REC","");

The param argument can take the following values: Type – String, range – available parameters of the specified action. The value argument can take the following values: Type – String, range – depends on the parameter.

For all reactions it is possible to specify delay of reaction performing using delay<> parameter. Delay is specified in seconds.

Usage examples

Problem. When an alarm is received from a camera, switch Monitor 1 to single window mode and show the video from the alarmed camera in this window.

 if (Event.SourceType == "CAM" && Event.Action == "MD_START")
{
 var camid = Event.SourceId;
 DoReactStr("MONITOR","1","ACTIVATE_CAM","cam<"+ camid +">");
 DoReactStr("MONITOR","1","KEY_PRESSED","key<SCREEN.1>");
}

Problem. When alarm by some camera is completed the record is to be continued for 5 second and after this time the record will be stopped (analogue of Post-record mode).

if (Event.SourceType == "CAM" && Event.Action == "MD_STOP")
{
 var camid = Event.SourceId;
 DoReactStr("CAM",camid,"REC_STOP","delay<5>");
}

Problem. Use macros 1 to enable telemetry control using mouse on the camera 4 displayed in the monitor 10. Use macros 2 to disable it.

if (Event.SourceType == "MACRO" && Event.Action == "RUN" && Event.SourceId == "1")
{
 DoReactStr("MONITOR","10","CONTROL_TELEMETRY","cam<4>,on<1>");
}
if (Event.SourceType == "MACRO" && Event.Action == "RUN" && Event.SourceId == "2")
{
 DoReactStr("MONITOR","10","CONTROL_TELEMETRY","cam<4>,on<0>");
}