🕹️

Phone Controller

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

PhoneController(手机无线控制器)模块可将任何智能手机变为无线三轴仿真摇杆。将该模块放置在画布上时,它会自动生成一个配对二维码;通过手机移动端浏览器扫码即可打开带有虚拟触摸摇杆(或体感倾斜控制)以及独立水平偏航(Yaw)滑动条的控制页面。

手机端通过低延迟 WebRTC 点对点数据通道,以约 30 Hz 的刷新率流式传输 X、Y 和 Yaw 三轴的归一化控制信号(−1.0⋯+1.0-1.0\dots +1.0)。其 X 和 Y 端口与 Joystick2D 模块具有相同的接口规范,可直接无缝替换原有二维鼠标摇杆。

数学模型

移动终端设备发送归一化的三轴控制矢量:

u(tk)=[ux(tk),  uy(tk),  uyaw(tk)]T∈[−1,1]3\mathbf{u}(t_k) = [u_x(t_k), \; u_y(t_k), \; u_{\text{yaw}}(t_k)]^T \in [-1, 1]^3

死区阈值 δdead=0.02\delta_{\text{dead}} = 0.02 用于滤除手指在中心静止时的微小电容抖动:

ui(t)={0,∣ri(t)∣≤δdeadsign(ri(t))∣ri(t)∣−δdead1−δdead,∣ri(t)∣>δdeadu_i(t) = \begin{cases} 0, & |r_i(t)| \le \delta_{\text{dead}} \\[6pt] \text{sign}(r_i(t)) \dfrac{|r_i(t)| - \delta_{\text{dead}}}{1 - \delta_{\text{dead}}}, & |r_i(t)| > \delta_{\text{dead}} \end{cases}

结合网络播放缓冲延迟 τplayout=playoutDelay⋅10−3\tau_{\text{playout}} = \text{playoutDelay} \cdot 10^{-3} 秒,在仿真求解步长间重构出连续平滑信号:

yi(t)=interp({(tk,ui,k)},  t−τplayout)y_i(t) = \text{interp}\left( \{(t_k, u_{i,k})\}, \; t - \tau_{\text{playout}} \right)

输入与输出

Direction ID Label 类型 Status
← Out x X number Output
← Out y Y number Output
← Out yaw Yaw number Output

参数

参数 Label 类型 默认值 描述
playoutDelay Playout Delay (ms) number 80 Network jitter buffer. Lower = more responsive control, higher = smoother signal on flaky connections.
interpolation Interpolation select linear How to reconstruct the control signal between received joystick packets.
outputLabels Output Labels vector x,y,yaw

使用示例

示例 1: 无线四旋翼无人机飞行姿态遥控

操控仿真无人机的三维飞行姿态。将 x 端口连接至滚转角目标值,y 端口连接至俯仰角目标值,yaw 端口连接至偏航角速度,输入姿态控制 PID 并驱动 Gimbal3D 视图渲染。无人机能直接响应手机端的手指操控。

示例 2: 轮式移动机器人体感倾角转向控制

操控差速驱动地面移动机器人。在手机端切换至体感倾斜模式,手机的三维物理倾斜度即可直接映射为转向和行进速度指令,实现直观的物理遥控导航。

说明与最佳实践

  • 三路独立控制通道:在三个独立输出端口上分别输出 X(左/右,−1⋯+1-1\dots +1)、Y(后/前,−1⋯+1-1\dots +1)以及 Yaw(水平滑动条,−1⋯+1-1\dots +1)。
  • 零安装 WebRTC 配对:直接运行于手机自带的标准网页浏览器中,无需下载或安装任何独立 App。
  • 触摸与体感双模式切换:手机控制界面支持在虚拟触摸板和加速度计体感倾角控制之间自由切换。
  • 仿真启动门控:在半实物仿真模版中,仿真引擎会自动等待手机端 WebRTC 通道配对完成后才正式启动时间积分。

相关模块

  • Joystick2D:画布上的鼠标控制二维虚拟摇杆模块。
  • RemoteSensor:采集手机内置加速度计、陀螺仪与绝对姿态传感器原始数据。
  • Gimbal3D:实时三维飞行器姿态可视化云台模块。
  • Slider:单轴连续数值滑动输入器。