Input 模块
android.input 提供文本输入、键盘事件、剪贴板与文本编辑能力,适合表单填写、搜索框输入和编辑场景。
常用方法
inputStr(str)
输入一段文本。
- 参数:
str: string - 返回值:
Promise<boolean>
setKeyCode(keyCode)
发送一个按键码。
- 参数:
keyCode: number - 返回值:
Promise<boolean>
setKeyDown(keyCode)
按下某个按键。
setKeyUp(keyCode)
抬起某个按键。
setKeyChar(keyChar)
输入单个字符。
- 参数:
keyChar: string - 返回值:
Promise<boolean>
setClipboardContent(text)
设置剪贴板文本。
getClipboardContent()
读取剪贴板文本。
setShellClipboardContent(text)
通过 Shell 方式设置剪贴板。
getShellClipboardContent()
通过 Shell 方式读取剪贴板。
paste() / copy() / cut()
执行粘贴、复制、剪切动作。
selectAllText() / unSelectAllText()
全选 / 取消选择文本。
getSelectedText()
读取当前选中文本。
moveCursorToStart() / moveCursorToEnd() / moveCursor(step)
移动输入光标。
示例
await android.input.inputStr('hello')
await android.input.setKeyCode(66) // Enter注意事项
- 输入能力通常依赖输入法权限与当前焦点控件
- 调用前建议先检查
android.auth.openInput(false) - 在复杂表单场景中,建议配合
android.acc.findView()先定位输入框
