写给 Infinite Flight 工作人员的 SkyYoke 说明
面向 Infinite Flight 工作人员和审核者的 SkyYoke 技术概览：如何使用 Connect API v2、读写哪些数据、安全设计与隐私。
本页为 Infinite Flight 团队、版主和审核者概述 SkyYoke。
它是什么#
SkyYoke 是一款独立的 iPhone App，作为 Infinite Flight 的外接控制器使用。它与 Infinite Flight LLC 没有关联，也未获其背书。它只使用 Infinite Flight 为第三方控制器提供的公开 Infinite Flight Connect API v2；不修改模拟器、不注入代码，也不读取内存。
连接方式#
| 步骤 | 详情 |
|---|---|
| 发现 | 在端口 15000 上监听 Infinite Flight 的 UDP 广播（开启 Enable Infinite Flight Connect 时发送） |
| 连接 | 通过端口 10112 与设备建立 TCP 连接（Connect API v2） |
| 备用方式 | 用户可以手动输入设备的 IP 地址 |
| 范围 | 仅限局域网；任何数据都不经过 SkyYoke 的服务器 |
读取的数据#
来自实时 API 清单（manifest）、按机型以路径解析的状态：位置、姿态、速度、高度、垂直速度、自动驾驶目标和模式、构型（起落架、襟翼、扰流板、刹车）、发动机、系统和灯光、飞行计划、附近交通、风和气温，以及 ATC 消息。操纵相关的关键数值最高以 30 Hz 采样，显示数据为 10 Hz。
发送的数据#
| 类型 | 方式 |
|---|---|
| 飞行操纵 | Infinite Flight 的虚拟摇杆轴（横滚、俯仰、油门、偏航）和按键（反推、视角帽键），由用户在 Settings → Controllers 中绑定 |
| 离散操纵 | 具名的 API 命令，如起落架、襟翼、扰流板、停机刹车、灯光和 Auto Start |
| 自动驾驶 | 写入自动驾驶的目标和模式状态（高度、垂直速度、速度、航向、LNAV、VNAV、进近） |
| ATC | 由用户选择的带编号 ATC 选项命令 |
输入经过处理后由一个 60 Hz 的循环发送，但只在数值真正变化时才发送，以减少链路上的流量。
安全设计#
- 失效安全自动驾驶：连接中断或 App 进入后台时，SkyYoke 会释放所有按住的操纵并接通自动驾驶（用户设置，默认开启）。
- 暂停锁定：Infinite Flight 暂停时操纵会被锁定，直到用户继续。
- 空中反推保护：空中禁止使用反推。
- 起落架保护：在地面上无法收起起落架。
- 限速：可选的违规规避系统让空客和波音飞机在一万英尺以下保持在 250 kt 以内。
- 多人飞行礼仪：App 会提醒飞行员优先遵从 Infinite Flight ATC 的指令。
隐私#
操纵输入和飞行数据只在两台设备之间的局域网中传输。语音指令在 iPhone 上处理。账号为可选项，只保存邮箱、账号 ID 和订阅状态。参见账号、登录与隐私。
联系方式#
可以通过 App 连接页面上的链接（Discord、网站和邮箱）或 ifkits.com 联系开发者。