Input API
Пожалуйста, ознакомьтесь с Правилами использования материалов на данном ресурсе.
Описание.
IDroidInputAPI Input
Предоставляет доступ к эмуляции действий на устройстве для взаимодействия с интерфейсом и элементами приложения. Этот интерфейс используется для выполнения свайпов, тапов и ввода текста, а также для выполнения команд ADB Shell.
Методы.
Cвайп по экрану от точки до точки.
void Swipe(int x1, int y1, int x2, int y2)
Параметры:
int x1, int y1 // Координаты первой точки.
int x2, int y2 // Координаты второй точки.
Перегрузка:
int duration // Продолжительность свайпа (скорость).
Пример.
//#1
var input = instance.DroidInstance.Input;
Point start = new Point() { X = 100, Y = 500 }; // Точка старта
Point end = new Point() { X = 200, Y = 200 }; // Точка конца
input.Swipe(start.X, start.Y, end.X, end.Y); // Сделать свайп по координатам
//#2
var duration = 100;
input.Swipe(start.X, start.Y, end.X, end.Y, duration); // Сделать свайп по к оординатам с настройкой скорости движения
Изогнутый свайп от точки до точки.
void SwipeCurved(int x1, int y1, int x2, int y2, int duration)
Параметры:
int x1, int y1 // Координаты первой точки.
int x2, int y2 // Координаты второй точки.
int duration // Продолжительность свайпа (скорость).
Пример.
var input = instance.DroidInstance.Input;
Point start = new Point() { X = 100, Y = 500 }; // Точка старта
Point end = new Point() { X = 200, Y = 200 }; // Точка конца
var duration = 100; // скорость свайпа
input.SwipeCurved(start.X, start.Y, end.X, end.Y, duration); // Изогнутый свайп
Изогнутый свайп с контролем изгиба.
void SwipeCurved(int x1, int y1, int xPivot, int yPivot, int x2, int y2, int duration)
Параметры:
int x1, int y1 // Координаты первой точки.
int xPivot // Точка вращения по Х.
int yPivot // Точка вращения по Y.
int x2, int y2 // Координаты второй точки.
int duration // Продолжительность свайпа (скорость).
Пример.
var input = instance.DroidInstance.Input;
Point start = new Point() { X = 100, Y = 500 }; // Точка старта
Point end = new Point() { X = 200, Y = 200 }; // Точка конца
var duration = 100; // Скорость свайпа
var xPivot = 200; // Настройка изгиба по X
var yPivot = 700; // Настройка изгиба по Y
input.SwipeCurved(start.X, start.Y, xPivot, yPivot, end.X, end.Y, duration); // Изогнутый свайп c настройкой изгиба
Нажатие по координатам.
void Tap(int x, int y)
Параметры:
int x // Координаты точки по Х.
int y // Координаты точки по Y.
Перегрузка:
int duration // Длительность нажатия.
Пример.
var input = instance.DroidInstance.Input;
Point point = new Point() { X = 100, Y = 500 }; // Точка
input.Tap(point.X, point.Y); // Нажатие по координатам
var duration = 100; // Продолжительность нажатия
input.Tap(point.X, point.Y, duration); // Долгое нажатие по координатам
Нажатие по координатам c дополнительными настройками.
void Touch(int xMin, int yMin, int xMax, int yMax, bool longPress, string clickDistributionType)
Параметры:
int xMin, int yMin // Координаты нижней точки.
int xMax, int yMax // Координаты верхней точки.
bool longPress // Использовать долгое нажатие
string clickDistributionType // Тип клика: "Normal" или "Random".
Пример.
var input = instance.DroidInstance.Input;
Point start = new Point() { X = 100, Y = 500 }; // Точка старта
Point end = new Point() { X = 200, Y = 200 }; // Точка конца
input.Touch(start.X, start.Y, end.X, end.Y, false, "Random"); // Нажатие по координатам с настройками
Долгое нажатие и свайп по экрану.
void LongTapAndSwipe(int x1, int y1, int x2, int y2)
Параметры:
int x1, int y1 // Координа ты первой точки.
int x2, int y2 // Координаты второй точки.
Перегрузка:
int duration // Продолжительность свайпа (скорость).
Пример.
var input = instance.DroidInstance.Input;
Point start = new Point() { X = 100, Y = 500 }; // Точка старта
Point end = new Point() { X = 200, Y = 200 }; // Точка конца
input.LongTapAndSwipe(start.X, start.Y, end.X, end.Y); // долгое нажатие и свайп по экрану
var duration = 100; // Продолжительность нажатия
input.LongTapAndSwipe(start.X, start.Y, end.X, end.Y, duration); // долгое нажатие и свайп по экрану, с настройкой скорости свайпа
Ввод текста в поле.
void SendText(string text)
Параметры:
string text // Текст ввода.
Перегрузка:
int latency // Задержка между вводом символов.
Пример.
var input = instance.DroidInstance.Input;
var text = "Привет мир!";
input.SendText(text); // Вводим текст в поле элемента
var latency = 100; // Скорость набора текста
input.SendText(text, latency); // Вводим текст с настройкой скорости ввода
Ввод специальных символов (через KeyCode).
void SendKeyCode(KeyCode keyCode)
Параметры:
KeyCode keyCode // Идентификатор спец.символа.
Перегрузка:
int keyCode // Числовой код спец.символа.
Пример.
var input = instance.DroidInstance.Input;
input.SendKeyCode(KeyCode.KEYCODE_HOME); //Отправка спецсимволов (по названию)
input.SendKeyCode(3); //Отправка спецсимволов(по числовому значению)
Очистить поле ввода от текста.
void ClearText()
Пример.
var input = instance.DroidInstance.Input;
input.ClearText(); // очистить текст элемента
Выполнить команду ADB Shell.
string Shell(string command)
Параметры:
string command // Команда ADB, которую нужно выполнить.
Перегрузка:
int timeout // Время ожидания команды.
bool checkconnect // Проверка подключения к устройству.
Пример.
var input = instance.DroidInstance.Input;
var adb = "dumpsys activity activities | grep ResumedActivity"; // Команда для получения текущей активити
var activity = input.Shell(adb); //Получить текущую активити
var adb = "am start -n com.example.app/.MainActivity"; // Команда запустить приложение с активити
input.Shell(adb, 1000); //Запускаем приложение с ожиданием выполнения
var adb = "reboot"; // Команда перезагрузки
input.Shell(adb, 1000, true); // Выполнить команду перезагрузки c ожиданием выполнения и проверкой подключения adb
Взять текст из Буфера обмена.
string GetClipboard()
Пример.
var input = instance.DroidInstance.Input;
var text = input.GetClipboard(); // Получить текст из буфера обмена
Скопировать текст в Буфер обмена.
void SetClipboard(string text)
Параметры:
string text // Текст для буфера обмена.
Пример.
var input = instance.DroidInstance.Input;
var text = "Привет мир!";
input.SetClipboard(text); // Поместить текст в буфер обмена
Приблизить экран.
void ZoomIn()
Перегрузка:
int centerX // Центр точки по Х.
int centerY // Центр точки по Y.
double ratio // Значение приближения.
Пример.
var input = instance.DroidInstance.Input;
input.ZoomIn(); // Приблизить
input.ZoomIn(-1, -1, 1.0); // Приблизить с настройкой
Отдалить экран.
void ZoomOut()
Перегрузка:
int centerX // Центр точки по Х.
int centerY // Центр точки по Y.
double ratio // Значение отдаления.
Пример.
var input = instance.DroidInstance.Input;
input.ZoomOut(); // Отдалить
input.ZoomOut(-1, -1, 1.0); // Отдалить с настройкой
Эмуляция получения SMS на устройство.
void SendSmsMessage(string phone, string message)
Параметры:
string phone // Телефон, который якобы отправляет нам SMS.
string message // Текст, который должен поступить в SMS.
Пример.
var input = instance.DroidInstance.Input;
var phone = "+79998007060";
var message = "Привет!";
input.SendSmsMessage(phone, message); // Эмуляция входящего SMS сообщения