Skip to content

按键和文字:modavd_key、modavd_input_text 走模拟器控制台 - #19

Merged
qiyinxi merged 3 commits into
ModAVD:mainfrom
qiyinxi:feat/key-text
Nov 14, 2026
Merged

qiyinxi merged 3 commits into
ModAVD:mainfrom
qiyinxi:feat/key-text

Conversation

@qiyinxi

@qiyinxi qiyinxi commented Nov 14, 2026

Copy link
Copy Markdown
Member

modavd_key 和 modavd_input_text 从「已声明、返回不支持」变成能用,接口版本升到 3。和点击一样走模拟器控制台,不经 adb。

文字

  • 编辑框有焦点、ModAVD 的宿主输入法(org.modavd.ime)在用时,走控制台的 ime commit,文字原样交给编辑框,任意语言。换行发成回车键。
  • 否则,可打印的 ASCII 走 event text,由模拟器的键盘打出来。每条命令最多 4 个字符,发完停 4 ms:一次发得多了,客体键盘的队列装不下,整段都会丢。
  • 两样都不满足(不是 ASCII,又没有这样的编辑框)时返回 MODAVD_E_UNSUPPORTED,什么都不打。

按键

  • 控制台有 event key <linux 键码> <0|1> 时,按的是模拟器键盘上的真实按键,按下、抬起分开发,返回、主页、多任务也在内。这条命令现在发布的模拟器(0.40.x)还没有,会跟下一次模拟器重编一起发;库不带参数发一次 event key,看回的是用法还是 bad sub-command 来判断,每个控制台会话只问一次。
  • 没有这条命令时,以及键盘上没有的键:能打出字符的键(字母、数字、回车、Tab、空格、标点)走 event text;编辑键(退格、方向键等)在编辑框有焦点时走 ime key;其余返回 MODAVD_E_UNSUPPORTED。这两条路按下时就把按下和抬起一起发了,抬起不再发东西。
  • 键码表照模拟器键盘在客体里用的 /vendor/usr/keylayout/qwerty.kl 写,不是 Generic.kl:主页键是 102;Esc 键被这张表读作返回。

能力位

  • MODAVD_CAP_TEXT:接口版本 3 起恒有。
  • MODAVD_CAP_KEY:控制台有 event key 时才有。为此 modavd_capabilities() 第一次调用会连一次控制台。

测试

  • 单元测试:假控制台按有没有 event key、编辑框有没有焦点分别回话,核对库发出的每一行命令;文字分段、转义、UTF-8 切分的纯函数另测。Windows 本机 3 组全过。
  • 实机(ModAVD 0.40.2,Windows):
    • 现在发布的模拟器:158 和 395 个 ASCII 字符经键盘打入,客体收到的按键数一个不少,约 1.2 ms 一个字符;设置页搜索框里中文、半角假名、表情原样进入;退格有效;返回键返回不支持。
    • 换上带 event key 的模拟器:返回、主页、多任务、Esc、退格、回车都生效;明日方舟里返回键弹出退出确认框,Esc 把它关掉。
    • MaaCore 和 MaaFramework 的接入分支各用这份库跑过:MaaCore 五项日常全部完成,MaaFramework 的截图、点击、滑动、按键、文字都走库。
  • Linux、macOS 只过编译和单元测试(看 CI),没有实机测。

发版(版本号、发版说明)另开 PR。

文字:编辑框有焦点且宿主输入法在用时走 ime commit(任意语言),否则 ASCII 走 event text,每 4 个字符一条、间隔 4 ms(一次发多了客体键盘队列溢出,整段丢)。按键:控制台有 event key 时发真实按键;没有时只有能打出字符的键和编辑框里的编辑键可用,其余返回 MODAVD_E_UNSUPPORTED。接口版本 3,MODAVD_CAP_TEXT 恒有,MODAVD_CAP_KEY 看控制台有没有 event key。
模拟器的键盘在客体里用 /vendor/usr/keylayout/qwerty.kl,不是 Generic.kl。键盘上没有的键(FORWARD_DEL、MOVE_HOME 等)照没有 event key 时的办法走。带 event key 的模拟器上实测:返回、主页、多任务、Esc、退格、回车。
@qiyinxi qiyinxi added the enhancement New feature or request label Nov 14, 2026
@qiyinxi
qiyinxi added this pull request to the merge queue Nov 14, 2026
Merged via the queue into ModAVD:main with commit 0b81b82 Nov 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant