Commands are actions which you add to a System, and then assign to a button, slider, gesture or timer to control a particular device.
To create a command, you first have to create a system. The system defines where the command will be sent to, whilst the command simply defines what content will be sent in the message.
Once you have created a system, the next step is to create the command and assign it to a button.
When a command is sent, you can also optionally assign the value of a target join.
To do this, firstly select the checkbox to enable the other properties. Then select the join type from the dropdown list.
Now enter the join number you want to target and finally enter the value you want to assign to the join.
This is handy for many reasons, such as changing an image path, changing a text value or changing a button state.
The value can contain token replacements and math expressions.
This will stop all running macros when the command is fired when the checkbox for this option is selected.
Commands can be assigned to buttons, sliders, macro, input field, page timers and gestures . Here we will show how to assign the commands to these objects.
You will of course first need to create a command following the steps above.
In the button properties dialog you can also set the command repeat delay. This delay time (entered in milliseconds) represents how often the command will be sent whilst the button is held down.</br> Enter zero for no repeating.
Sliders allow sending commands on press, drag and release. Each action can be assigned a separate command via the Slider Properties dialog.
The command being sent can also include the slider value. To do this the command value needs to use a special string
sliderval string will be replaced with the slider value when the command is sent. The slider value being sent can be manipulated by entering the min and max values within the Slider Properties dialog.
So setting the min to 0 and max to 100 will allow you to send a command with the values from 0 to 100 when dragging the slider from left to right (or bottom to top for vertical sliders).
Leaving the min and max empty will send the default slider value range of 0 to 65535.
The value can be sent as either a decimal value, hex value or hex string value (within the Slider Properties dialog).
To assign the various commands, double click on a slider to open the Slider Properties dialog and select the commands for the press, drag and/or release actions.
Go to Macros for more details.
Commands for “Send Value Actions” will only be run when the full input string is entered and when the “Done” button on the onscreen keyboard (OSK) is pressed. Commands for “On Change Actions” will be run for every individual input key that is typed or changed on the OSK.
Go to Timers for more details.
Go to Gesture Manager for more details.
Below is an example of controlling the volume of the XBMC server using JS. The “XBMCMacMini.XBMC.setVolume(data)” function is the command that sets the volume where the
sliderval string passes the value of the volume to be set via a slider.
To send hex strings or values, append a prefix of “\x” to the hex codes and insert at the Command Value section.
Some devices only have a HTTP control protocol. These devices can be controlled from a web browser by entering specific URLs into the browser.
To control these devices via iViewer, the command value to send needs to be crafted to follow the HTTP Request standard formatting.
See the HTTP Request Commands page for more details.