⌨

Keyboard Input

Sources
运行在线示例 免费 · 无需注册 · 直接在浏览器中运行

KeyboardInput 模块支持使用标准计算机键盘(方向键或 WASD 键)在仿真运行期间对模型进行实时手动遥控。在画布上点击该模块图块可激活键盘焦点;按下方向按键即可同步操纵两个独立的坐标输出通道(XX 和 YY)。在模型中放置 KeyboardInput 模块会自动将仿真引擎速率锁定为物理真实时钟步进,非常适用于交互式飞行仿真、机器人遥操作、游戏化展示以及实时手动扰动注入测试。

数学模型

键盘事件监听器将按键按下 (keydown) 与按键释放 (keyup) 动作解析为离散的方向状态 sx(t),sy(t)∈{−1,0,1}s_x(t), s_y(t) \in \{-1, 0, 1\}:

sx(t)={−1,ArrowLeft / A+1,ArrowRight / D0,其他,sy(t)={+1,ArrowUp / W−1,ArrowDown / S0,其他s_x(t) = \begin{cases} -1, & \text{ArrowLeft / A} \\ +1, & \text{ArrowRight / D} \\ 0, & \text{其他} \end{cases}, \quad s_y(t) = \begin{cases} +1, & \text{ArrowUp / W} \\ -1, & \text{ArrowDown / S} \\ 0, & \text{其他} \end{cases}

从右侧两个端口输出的控制信号按比例增益 gain (KK) 缩放:

xout(t)=K⋅sx(t)yout(t)=K⋅sy(t)\begin{aligned} x_{\text{out}}(t) &= K \cdot s_x(t) \\ y_{\text{out}}(t) &= K \cdot s_y(t) \end{aligned}

当用户点击画布任意其他区域时,模块焦点自动失活,两个按键状态安全归零(sx=0,sy=0s_x = 0, s_y = 0)。

输入与输出

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: 类似赛车游戏的车辆转向与油门控制

遥操作一辆受控虚拟电动地面小车。端口 yy 提供驱动扭矩设定值,配置 gain = 50.0 (Nm);端口 xx 操纵前轮转向角,配置 gain = 25.0(度)。将端口 xx 级联接入 RateLimiter(变化率限制器)模块,可将突变阶跃转化为平滑真实的方向盘回转动态。

示例 2: 闭环控制系统抗扰能力的交互式动态脉冲测试

在操作人员实时介入下评估闭环控制器的抗扰动性能。将端口 yy 经过一个增益为 10.010.0 的 Gain 模块后,直接接入磁悬浮或倒立摆受控对象的受力求和节点。点按键盘上下键即可注入标定的冲击推力,实时检验系统的自稳定恢复能力。

说明与最佳实践

  • 点击激活安全焦点机制: 模块要求显式点击画布图块以激活键盘捕获。点击画布其他区域会立即解除焦点并复位输出至零,杜绝因焦点丢失造成的按键卡死隐患。
  • 双键映射支持: 同时支持标准方向箭头键与 WASD 键,契合双手人体工学操作习惯。
  • 滤波平滑过渡: 键盘按键产生的是阶跃突变(±K\pm K),级联连接 RateLimiter、TransferFunction 或 LeadLag 模块可实现平滑的模拟量控制手感。
  • 自动物理实时同步: 引入 KeyboardInput 模块会自动锁定仿真步进与物理真实时钟保持 1:1 速率。

相关模块

  • Joystick2D: 连续二维模拟量摇杆控件,支持鼠标与触控屏操作。
  • Slider: 单轴连续滑动条控件,支持全局项目变量驱动。
  • RateLimiter: 限制键盘输入阶跃突变信号的变化率。
  • Constant: 固定的非交互式常数信号源。