Gomaton
指南
API
GitHub
指南
API
GitHub
  • 前言

    • 快速开始
    • 能力速查
    • 工作原理
    • 硬件输入后端(ESP32 HID)
  • API 参考

    • motion - 触控 / 输入
    • images - 找图找色 / 截图
    • uiacc - 控件(UI 树)
    • device - 设备
    • app - 应用
    • ime - 输入法
    • ocr - 文字识别
    • yolo - 目标检测
    • files - 文件
    • storages - 键值存储
    • https - 网络
    • media - 媒体
    • system - 系统
    • utils - 工具

motion — 触控 / 输入

import "gomaton.dev/sdk/motion"

Package motion 触控与按键。坐标为屏幕像素。 实现是【胶水】:命令发给 utils.dex 框架桥(injectInputEvent,低延迟、多指、跨 ROM); 桥不可用时回退 input 命令。拟人滑动曲线在 dex(二进制)里做。

Back

func Back()

Back 返回键。

Enter

func Enter()

Enter 回车。

HasInjector

func HasInjector() bool

HasInjector 当前是否有低延迟注入(桥可用)。

Home

func Home()

Home 主页键。

Init

func Init() bool

Init 探测桥是否就绪(不调也会在首次操作时自动连接/拉起)。返回是否拿到低延迟注入(桥)。

Key

func Key(code int)

Key 发送按键(Android KeyEvent 键码,见 Key* 常量)。

LongPress

func LongPress(x, y, durMs int)

LongPress 长按;durMs<=0 取 600ms。

Menu

func Menu()

Menu 菜单键。

Notifications

func Notifications()

Notifications 下拉通知栏。

Paste

func Paste(s string) bool

Paste 写系统剪贴板再粘贴(桥不可用时输中文的兜底)。

Pinch

func Pinch(cx, cy, fromR, toR, durMs int) bool

Pinch 双指缩放:两指沿水平轴从 中心±fromR 到 中心±toR(像素半径),分 steps 步。仅桥可用。

Power

func Power()

Power 电源键(亮/灭屏)。

Recents

func Recents()

Recents 最近任务。

Swipe

func Swipe(x1, y1, x2, y2, durMs int)

Swipe 从 (x1,y1) 滑到 (x2,y2),历时 durMs 毫秒(<=0 取默认);拟人轨迹在 dex 内生成。

Tap

func Tap(x, y int)

Tap 点击像素坐标 (x, y)。

Text

func Text(s string) bool

Text 往当前焦点输入框输入文字(中文可用)。须先点中输入框;失败返回 false。

TouchDown

func TouchDown(x, y int)

TouchDown 手动分解触摸:手指(id 0)在 (x,y) 按下;桥不可用则无效。

TouchMove

func TouchMove(x, y int)

TouchMove 手动分解触摸:手指(id 0)移动到 (x,y);需先 TouchDown;桥不可用则无效。

TouchUp

func TouchUp()

TouchUp 手动分解触摸:抬起手指(id 0);桥不可用则无效。

VolumeDown

func VolumeDown()

VolumeDown 音量减。

VolumeUp

func VolumeUp()

VolumeUp 音量加。

上次更新: 2026/9/2 06:21
贡献者: hb
Next
images - 找图找色 / 截图