MouseControl

The MouseControl capability serves to define the methods required for normalizing a mouse/trackpad (move/scroll with relative coordinates and click).

Methods

mouseControl.connectMouse ()

Establish a connection with the DeviceService’s mouse communication medium (WebSocket, HTTP, etc). While this step may not be necessary with certain platforms, it is suggested to call it anyways, for purposes of seamless normalization. Calling connect on a non-connectable protocol will just trigger the success callback immediately.

Related capabilities:

• MouseControl.Connect

Returns: Command

mouseControl.disconnectMouse ()

Disconnects from the mouse communication medium.

Related capabilities:

• MouseControl.Disconnect

Returns: Command

mouseControl.move (dx, dy)

Move the mouse by the given distance values.

Related capabilities:

• MouseControl.Move

Parameters:

• dx (number) – Distance to move the mouse on the x-axis relative to its current position
• dy (number) – Distance to move the mouse on the y-axis relative to its current position

Returns: Command

mouseControl.scroll (dx, dy)

Scroll by the given distance values.

Related capabilities:

• MouseControl.Scroll

Parameters:

• dx (number) – Distance to scroll the mouse on the x-axis relative to its current position
• dy (number) – Distance to scroll the mouse on the y-axis relative to its current position

Returns: Command

mouseControl.click ()

Perform a click action at the current mouse position.

Related capabilities:

• MouseControl.Click

Returns: Command