📱 飞飞投屏帮助中心

🔌 USB连接快速入门

📱 部分机型连接问题

华为手机：连接后无反应/驱动异常

图示：华为手机开发者选项关键设置（关闭监控ADB安装应用）

1. 下载安装 华为手机助手，完成驱动更新
2. 进入开发者选项，设置以下内容：
   ✔ 开启「USB调试」
   ✖ 关闭「监控ADB安装应用」（图示中「这个不开」的选项）
   ✖ 关闭「使用ADB安装应用时需要用户确认」（图示中第二个「这个不开」）
   ✔ 开启「'仅充电'模式下允许ADB调试」（确保非充电模式也能调试）
3. 若仍无反应，尝试重启手机并更换电脑USB 2.0接口

华为/荣耀手机：电脑无法识别

图示：将允许HiSuite通过HDB连接设备的开关打开，即可完成HDB的授权

① 进入手机「设置」→「安全和隐私」
② 找到更多安全设置
③ 在更多安全设置页面，将允许HiSuite通过HDB连接设备的开关打开，即可完成HDB的授权

⚡ 如何连接主板机/机箱

图示：按步骤操作 ADB 授权文件，确保文件路径正确。若路径错误或文件缺失，将导致授权失败无法正常连接。

📡 无线WIFI连接核心配置

⚡ OTG机箱连接深方案

🤖 AI智控使用指南

AI智控通过接入大语言模型（LLM），实现用自然语言对话操控手机和电脑。你只需输入"打开抖音刷10分钟"，AI会自动分析屏幕、识别按钮、模拟点击滑动，全程无需手动操作。

📌 第一步：获取大模型 API 密钥

飞飞投屏不自带AI模型，需前往第三方平台购买大模型API服务。推荐以下平台（均支持 OpenAI 兼容接口）：

⚙️ 第二步：添加AI配置

🚀 第三步：使用AI智控执行任务

💡 使用技巧与最佳实践

🖥️ 核心ADB指令速查表

🌐 局域网共享

通过局域网共享功能，可实现多台电脑（同一路由器下）共同控制同一台移动设备，无需每台电脑单独通过USB连接。具体网络拓扑如下：

图示：移动设备通过USB连接PC1，PC1、PC2、PC3共连同一路由器，PC2/PC3可通过共享控制设备

操作方法（分两步完成）

1️⃣

PC1（主机）开启局域网服务

1. 在PC1上打开「飞飞投屏」软件，确保移动设备已通过USB正常连接并识别；
2. 点击软件左侧功能按钮「高级设置」→ 选择「开启ADB局域网服务」；
3. 若关闭软件共享功能将失效；

2️⃣

PC2/PC3（从机）配置并启用

1. 在PC2或PC3上打开「飞飞投屏」软件；
2. 点击软件左侧功能按钮「高级设置」→ 找到「设置ADB服务地址」；
3. 输入PC1的局域网IP地址（PC1IP查询方法：Win+R输入cmd，执行ipconfig命令，查看「无线局域网适配器WLAN」下的IPv4地址 一般在PC1电脑上默认的这个地方地址就是）；
4. 输入地址后，勾选「设置ADB服务地址」选项，软件将自动连接PC1共享的设备。

图示：PC2中设置「Adb服务器地址」为PC1的IPv4地址

⚠️ 全场景故障排查

🎬 视频功能演示

点击播放按钮查看软件操作演示视频

🔁 脚本执行演示

点击播放按钮查看脚本执行演示

⌨ 自定义键盘映射

按键映射文件为JSON格式，新增自己的按键映射文件需要放在Scripts目录中或者点击自定义选择json文件会自动导入到Scripts目录或者点击前往映射配置按钮。

按键映射文件的具体编写格式下面会介绍，也可以参考自带的按键映射文件。

按键映射脚本格式说明

通用说明

• 按键映射中的坐标位置都是用相对位置表示的，屏幕的宽高都用1表示，例如屏幕的像素为1920x1080，那么坐标(0.5,0.5)则表示的是 以屏幕左上角为原点，像素坐标(1920,1080)*(0.5,0.5)=(960,540)的位置。

  或者鼠标左键单击时控制台会输出此时的pos，直接使用这个pos即可

• 按键映射中的按键码是用Qt的枚举表示的，详细说明可以参考Qt文档(搜索 The key names used by Qt. 可以快速定位)。

• 开发人员选项中打开如下两个设置，可以方便的观察触摸点的坐标：

  

顶层字段说明

• switchKey：切换自定义按键映射的开关键。默认为普通映射，按此键在普通映射和自定义映射之间切换。例如 "Key_QuoteLeft"（~键）。

• switchKeyPos（可选）：按下切换键时，鼠标光标移动到的位置。格式: {"x": 0.5, "y": 0.5}

• width / height（可选）：配置适用的界面宽高，通常为背景图原始尺寸。

• mouseMoveMap：鼠标移动映射，将鼠标移动映射为手指拖动操作（开启后隐藏鼠标并限制移动范围）。 一般在FPS手游中控制人物视野。

  • startPos：手指拖动起始点（鼠标映射的锚点）
  • speedRatioX：鼠标X轴灵敏度，值必须 ≥ 0.001，数值越大越不灵敏
  • speedRatioY：鼠标Y轴灵敏度，值必须 ≥ 0.001
  • speedRatio（已废弃）：旧的统一灵敏度，建议使用独立的 X/Y
  • opacity（可选）：映射UI透明度，范围 0~1，默认 0.75
  • timedResetView（可选）：布尔值。是否启用定时视角回正——鼠标静止超过 2.5 秒后自动将触摸点移回 startPos，模拟手指回中。
  • comment（可选）：注释说明
  • smallEyes（可选）：小眼睛按键配置。支持单个对象或数组（多小眼睛支持）。 每个小眼睛对象包含：
    • key：触发小眼睛的按键码
    • pos：小眼睛的触摸位置（按下后鼠标移动以此为起点）
    • switchMap（可选）：是否同时释放鼠标
    • type（可选）：通常为 "KMT_CLICK"
    • comment（可选）：注释

• mouseWheel（可选）：滚轮映射配置，用于游戏中的缩放/翻页操作。

  • clickPos：滚轮起始点击位置
  • moveMinPos：滚轮最小滑动位置（向上滚动到达的位置）
  • moveMaxPos：滚轮最大滑动位置（向下滚动到达的位置）

• keyMapNodes：按键映射数组，所有按键映射都放在这个数组中。

通用可选字段（所有类型适用）

• opacity：映射UI透明度，范围 0~1，默认 1
• comment：注释说明文本
• switchMap：布尔值，是否在触发此按键时释放鼠标光标（如打开背包/地图时）
• switchMapPos：切换映射后鼠标移动到的位置，格式 {"x": 0.5, "y": 0.5}
• resetMove：布尔值，操作前是否重置鼠标移动累积量，默认 false

一般按键映射有如下几种类型：

• type：按键映射的类型，每个keyMapNodes中的元素都需要指明：

  • KMT_CLICK：普通点击，按键按下模拟手指按下，按键抬起模拟手指抬起
  • KMT_CLICK_TWICE：两次点击，按键按下模拟手指按下再抬起，按键抬起再模拟一次按下抬起
  • KMT_CLICK_MULTI：多次点击，根据 clickNodes 数组实现一键多点连续点击
  • KMT_DRAG：拖拽，按键按下模拟手指按下并拖动一段距离，按键抬起模拟手指抬起
  • KMT_STEER_WHEEL：方向盘映射，专用于FPS游戏人物移动，需要4个方向键配合

不同类型的专有属性说明：

• KMT_CLICK

  • key：要映射的按键码
  • pos：模拟触摸的位置

• KMT_CLICK_TWICE

  • key：要映射的按键码
  • pos：模拟触摸的位置（按下和释放共用的默认位置）
  • pressPos（可选）：按键按下时的触摸位置（如未设置则使用 pos）
  • releasePos（可选）：按键释放时的触摸位置（如未设置则使用 pos）

• KMT_CLICK_MULTI

  • key：要映射的按键码
  • clickNodes：点击节点数组，每个元素包含：
    • order：点击顺序（从0开始）
    • delay：延迟多少毫秒后执行此点击
    • pos：此点击的触摸位置

• KMT_DRAG

  • key：要映射的按键码
  • startPos：拖动的起始触摸位置
  • endPos：拖动的结束触摸位置
  • dragSpeed：拖动速度（范围 0~1，默认 1.0），越大越快
  • startDelay（可选）：开始拖动前的延迟时间（毫秒）

• KMT_STEER_WHEEL — 方向盘映射

  • centerPos：方向盘中心点（摇杆锚点）
  • leftKey：左方向键
  • rightKey：右方向键
  • upKey：上方向键
  • downKey：下方向键
  • leftOffset：向左的最大偏移距离
  • rightOffset：向右的最大偏移距离
  • upOffset：向上的最大偏移距离
  • downOffset：向下的最大偏移距离
  • extendOffset（可选）：冲刺/加速扩展。按下指定修饰键时扩大偏移范围。格式：
    • key：修饰键，如 "Key_Shift"
    • offset：扩展后的最小偏移量（取原偏移与此值的较大者），如 0.2
  • steerWheelAlgorithm（可选）：方向盘滑动算法，控制手指轨迹的生成方式：
    • "bezier"（默认）：弧线滑动 — 手指沿三次贝塞尔曲线自然画弧，最接近人手操作
    • "simple"：轻微弧线 — 弧线幅度减半，近乎直线但带微弧
    • "linear"：直线滑动 — 纯直线移动，无弧度

完整示例（和平精英）

{
  "switchKey": "Key_QuoteLeft",
  "switchKeyPos": { "x": 0.5, "y": 0.5 },
  "mouseMoveMap": {
    "startPos": { "x": 0.57, "y": 0.26 },
    "speedRatioX": 0.25,
    "speedRatioY": 0.25,
    "opacity": 0.75,
    "timedResetView": false,
    "comment": "Camera control",
    "smallEyes": [
      { "key": "Key_Alt", "pos": { "x": 0.8, "y": 0.31 }, "switchMap": false },
      { "key": "Key_5",   "pos": { "x": 0.9, "y": 0.33 }, "switchMap": false }
    ]
  },
  "mouseWheel": {
    "clickPos":   { "x": 0.27, "y": 0.2 },
    "moveMinPos": { "x": 0.27, "y": 0.248 },
    "moveMaxPos": { "x": 0.27, "y": 0.644 }
  },
  "keyMapNodes": [
    {
      "type": "KMT_STEER_WHEEL",
      "centerPos": { "x": 0.18, "y": 0.75 },
      "leftKey": "Key_A",  "leftOffset": 0.089,
      "rightKey": "Key_D", "rightOffset": 0.089,
      "upKey": "Key_W",    "upOffset": 0.15,
      "downKey": "Key_S",  "downOffset": 0.15,
      "extendOffset": { "key": "Key_Shift", "offset": 0.2 },
      "steerWheelAlgorithm": "bezier",
      "resetMove": false,
      "comment": "Move around"
    },
    {
      "type": "KMT_CLICK",
      "key": "Key_Space",
      "pos": { "x": 0.95, "y": 0.7 },
      "comment": "Jump"
    },
    {
      "type": "KMT_CLICK_TWICE",
      "key": "Key_Q",
      "pressPos": { "x": 0.12, "y": 0.35 },
      "releasePos": { "x": 0.12, "y": 0.35 },
      "comment": "Peek Left"
    },
    {
      "type": "KMT_CLICK_MULTI",
      "key": "Key_F",
      "clickNodes": [
        { "order": 0, "delay": 100, "pos": { "x": 0.6, "y": 0.4 } },
        { "order": 1, "delay": 200, "pos": { "x": 0.7, "y": 0.5 } }
      ],
      "comment": "Multi-action"
    },
    {
      "type": "KMT_DRAG",
      "key": "Key_G",
      "startPos": { "x": 0.3, "y": 0.7 },
      "endPos": { "x": 0.5, "y": 0.7 },
      "dragSpeed": 0.8,
      "startDelay": 50,
      "comment": "Swipe"
    }
  ]
}

🖱 按键映射工具使用教程

飞飞投屏内置了可视化按键映射配置工具（ScrcpyKeyMapper），无需手写JSON即可通过拖拽方式创建和编辑按键映射。

在飞飞投屏中，点击设备控制栏的"前往映射配置"按钮即可打开该工具。

界面概览

• 左侧画布：可拖拽背景图（通常是游戏截图），在此拖放和调整映射元素位置
• 右上角 Types 面板：可拖放的映射类型列表，双击或拖拽到画布创建新元素
• 右侧 Node List 面板：已创建的映射元素列表，可调整缩放和层级
• 右侧 Properties 面板：选中元素后显示其属性配置（按键、位置、透明度等）
• 顶部工具栏：切换键设置、保存/加载JSON、上传背景图、主题切换、语言切换

快速上手（5步完成映射）

第1步：上传背景图

点击顶部 按钮上传游戏截图（建议先在手机上截一张游戏界面图传到电脑）。背景图确定了所有坐标的相对参考。

第2步：创建方向盘

在 Types 面板中找到"方向盘"（Steer Wheel），双击它。画布中央会出现一个带4个方向键的方向盘。拖拽中心圆到游戏摇杆位置，然后拖拽4个方向的小圆到摇杆的各方向边界处。在 Properties 面板中可以修改每个方向的按键和算法。

第3步：创建按键映射

从 Types 面板拖拽"单击"（KMT_CLICK）到画布上对应游戏按钮的位置。选中后按键盘上的目标键将其绑定。重复此步骤为每个游戏按钮创建映射。

• 单击：常规按钮——开火、跳跃、换弹等
• 双击：按下和释放各触发一次——适合探头、开关镜等
• 多点点击：一键触发多次点击——适合组合操作
• 拖动：模拟手指滑动——适合划屏操作

第4步：创建鼠标视野映射

从 Types 面板拖拽"鼠标移动"（Mouse Move）到画布上。这个只有一个——鼠标的移动将被映射为以 startPos 为起点的触摸拖动。在 Properties 面板中可调整 X/Y 灵敏度和小眼睛按键。

第5步：保存并使用

点击顶部 保存按钮。如果在飞飞投屏中打开，配置会通过 WebSocket 直接发送到设备；如果是在浏览器中打开，会下载一个 JSON 文件到 Scripts 目录。

键盘快捷键

方向盘配置要点

• 中心点拖到游戏摇杆的正中心位置
• 4个方向的小圆拖到摇杆的各方向最大移动边界
• 偏移量（Offset）会自动计算，显示在 Properties 面板中
• 冲刺扩展：勾选 extendEnabled，设置修饰键（如 Shift）和扩展偏移量。按住修饰键+方向键时，偏移范围自动扩大
• 滑动算法：在下拉框中选择弧线滑动（默认）、轻微弧线或直线滑动
• 方向键默认绑定为 WASD，可点击方向键按钮后按键盘更换

鼠标视野映射配置要点

• startPos 锚点放在屏幕中央偏上位置（右手拇指自然触摸区域）
• speedRatioX/Y 值越大鼠标越"沉"（灵敏度越低），建议从 0.25 开始调试
• 小眼睛：点击小眼睛按钮新增，支持多个小眼睛按键。按下小眼睛键时，鼠标移动以该键的 pos 为起点
• 定时视角回正：勾选 timedResetView 后，鼠标静止 2.5 秒自动将视角归中

其他功能

• 切换键：顶部输入框设置，默认为 Key_Control（Ctrl键）。游戏中按住此键在普通模式和映射模式间切换
• 滚轮映射：勾选 Mouse Wheel 后配置点击位置和滚动范围，用于游戏中的地图缩放
• 节点缩放：Node List 面板右侧的 +/- 按钮可调整所有映射元素的大小
• 层级调整：选中元素后可用上下箭头按钮调整前后层级
• 透明度：Properties 面板中的滑块可调整单个元素的透明度
• 加载JSON：可导入已有的按键映射文件进行编辑
• 暗黑模式：右上角太阳/月亮图标切换主题
• 多语言：支持中文、English、العربية

📺 虚拟投屏应用教程

虚拟投屏（虚拟屏）会在手机上创建一个独立的虚拟显示器，并把指定应用启动到这个虚拟屏上。它和手机主屏幕互不干扰：主屏可以做别的事、甚至锁屏，虚拟屏上的应用照常运行，电脑端单独操控这个虚拟屏。

🚀 使用步骤

⚠️ 注意事项

📄 wsapi接口文档