Struct TouchBuilder 

pub struct TouchBuilder<'a> { /* private fields */ }

Builds and executes a “touch” action.

A touch can be a simple tap or a long press, depending on the duration. This struct is created by the Droid::touch() method.

Implementations

impl<'a> TouchBuilder<'a>

pub fn new(droid: &'a mut Droid, target: Target) -> Self

pub fn times(self, count: u32) -> Self

Sets the number of times to perform the touch action.

Default is 1.

pub fn duration(self, duration: Duration) -> Self

Sets the duration of the touch.

A short duration (e.g., < 200ms) is a tap. A longer duration is a long press.

Default is 100ms.

pub fn threshold(self, value: f32) -> Self

Sets the confidence threshold for image matching.

This only applies if the target is an Image. The value should be between 0.0 and 1.0. If not set, the default confidence from DroidConfig is used.

pub fn search_in(self, rect: RelativeRect) -> Self

Restricts the image search to a specific region of the screen.

This only applies if the target is an Image. The rect is defined using relative coordinates (0.0 to 1.0).

pub fn execute(self) -> Result<()>

Executes the configured touch action.

It resolves the target to a screen coordinate and then performs the tap or long press.

Errors

Returns an error if the target cannot be found (for image targets) or if the underlying ADB command fails.