Keyboard Input
Sources
运行在线示例
免费 · 无需注册 · 直接在浏览器中运行
KeyboardInput 模块支持使用标准计算机键盘(方向键或 WASD 键)在仿真运行期间对模型进行实时手动遥控。在画布上点击该模块图块可激活键盘焦点;按下方向按键即可同步操纵两个独立的坐标输出通道( 和 )。在模型中放置 KeyboardInput 模块会自动将仿真引擎速率锁定为物理真实时钟步进,非常适用于交互式飞行仿真、机器人遥操作、游戏化展示以及实时手动扰动注入测试。
数学模型
键盘事件监听器将按键按下 (keydown) 与按键释放 (keyup) 动作解析为离散的方向状态 :
从右侧两个端口输出的控制信号按比例增益 gain () 缩放:
当用户点击画布任意其他区域时,模块焦点自动失活,两个按键状态安全归零()。
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| ← Out | x |
X | number | Output |
| ← Out | y |
Y | number | Output |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
keyX |
X State | number | 0 |
-1 (left/A), 0, or 1 (right/D) — written by the keyboard listener |
keyY |
Y State | number | 0 |
-1 (down/S), 0, or 1 (up/W) — written by the keyboard listener |
gain |
Gain | number | 1 |
Output scale: out = key state × gain |
使用示例
示例 1: 类似赛车游戏的车辆转向与油门控制
遥操作一辆受控虚拟电动地面小车。端口 提供驱动扭矩设定值,配置 gain = 50.0 (Nm);端口 操纵前轮转向角,配置 gain = 25.0(度)。将端口 级联接入 RateLimiter(变化率限制器)模块,可将突变阶跃转化为平滑真实的方向盘回转动态。
示例 2: 闭环控制系统抗扰能力的交互式动态脉冲测试
在操作人员实时介入下评估闭环控制器的抗扰动性能。将端口 经过一个增益为 的 Gain 模块后,直接接入磁悬浮或倒立摆受控对象的受力求和节点。点按键盘上下键即可注入标定的冲击推力,实时检验系统的自稳定恢复能力。
说明与最佳实践
- 点击激活安全焦点机制: 模块要求显式点击画布图块以激活键盘捕获。点击画布其他区域会立即解除焦点并复位输出至零,杜绝因焦点丢失造成的按键卡死隐患。
- 双键映射支持: 同时支持标准方向箭头键与 WASD 键,契合双手人体工学操作习惯。
- 滤波平滑过渡: 键盘按键产生的是阶跃突变(),级联连接
RateLimiter、TransferFunction或LeadLag模块可实现平滑的模拟量控制手感。 - 自动物理实时同步: 引入 KeyboardInput 模块会自动锁定仿真步进与物理真实时钟保持 1:1 速率。
相关模块
- Joystick2D: 连续二维模拟量摇杆控件,支持鼠标与触控屏操作。
- Slider: 单轴连续滑动条控件,支持全局项目变量驱动。
- RateLimiter: 限制键盘输入阶跃突变信号的变化率。
- Constant: 固定的非交互式常数信号源。