📱 飞飞投屏帮助中心
🔌 USB连接快速入门
1. 手机基础设置
① 打开「设置」→「关于手机」，连续点击「版本号」7次激活开发者选项
② 开发者选项中开启：
✅ USB调试
✅ USB调试(安全设置)（小米手机必需）
③ USB连接模式选择「传输文件(MTP)」（下拉通知栏切换）
2. 物理连接与授权
① 使用USB 2.0数据线连接手机与电脑主机背面接口
② 手机弹出「允许USB调试」提示时，勾选「始终允许」并点击「确定」
3. 软件识别设备
① 打开飞飞投屏软件，等待软件自动识别显示
② 无显示设备？ 打开软件设备列表查看原因
📱 部分机型连接问题
小米手机：能投屏但无法控制
现象：可以看到手机画面，但鼠标点击无反应
核心原因：未开启安全调试模式，导致无法模拟点击操作
① 进入手机「设置」→「开发者选项」
② 找到「USB调试(安全设置)」选项并勾选（部分机型路径：设置→更多设置→开发者选项）
③ 断开重新连接，确保授权提示中勾选「允许模拟点击」
华为手机：连接后无反应/驱动异常
图示：华为手机开发者选项关键设置（关闭监控ADB安装应用）
- 下载安装 华为手机助手，完成驱动更新
-
进入开发者选项，设置以下内容：
✔ 开启「USB调试」
✖ 关闭「监控ADB安装应用」（图示中「这个不开」的选项）
✖ 关闭「使用ADB安装应用时需要用户确认」（图示中第二个「这个不开」）
✔ 开启「'仅充电'模式下允许ADB调试」（确保非充电模式也能调试） - 若仍无反应，尝试重启手机并更换电脑USB 2.0接口
华为/荣耀手机：电脑无法识别
图示：将允许HiSuite通过HDB连接设备的开关打开，即可完成HDB的授权
① 进入手机「设置」→「安全和隐私」
② 找到更多安全设置
③ 在更多安全设置页面，将允许HiSuite通过HDB连接设备的开关打开，即可完成HDB的授权
⚡ 如何连接主板机/机箱
✅1. 连接电脑接口
将连接线连接到电脑，推荐使用 **USB 2.0 接口**，确保连接稳定，避免因接口兼容性问题导致连接异常。
✅2. 使用授权文件 ADBKEY 授权
联系主板机商家索要 adbkey 和 adbkey.pub 两个文件，并按以下步骤操作：
- 打开文件资源管理器，找到文件夹
C:\用户\你的计算机用户名\.android（若文件夹未显示，需在“查看”选项中勾选“显示隐藏项目”） - 将获取的两个文件复制到该文件夹内
- 重启计算机，完成授权初始化
重要提示：
- 请务必妥善备份
adbkey和adbkey.pub，后续重装系统或更换电脑时需重新使用这两个文件完成授权。 - 若文件丢失，连接时需通过手机屏幕手动点击“允许”授权，操作复杂度增加且可能影响连接效率。
- 推荐使用 飞飞软件「更多功能」中的「ADB授权合并」，功能便捷处理
图示：按步骤操作 ADB 授权文件，确保文件路径正确。若路径错误或文件缺失，将导致授权失败无法正常连接。
📡 无线WIFI连接核心配置
连接必备条件
- ✔ 手机与电脑连接同一局域网（如家庭/企业WIFI）
- ✔ 手机已通过USB完成首次授权（获取ADB权限）
普通手机操作步骤
① 通过USB将飞飞软件与手机连接
② 右键点击软件内手机窗口，选择「转为无线模式OTG(WIFI ADB)」
③ 转换成功后可断开USB线
高级自动模式
飞飞软件「高级设置」中勾选「自动将USB设备转为无线模式」，后续连接无需手动操作
飞飞软件通过「设备分享」功能共可将本地连接的所有手机设备跨网分享给其他用户
⚡ OTG机箱连接深方案
OTG机箱工作原理
通过OTG转接头将手机网络转为以太网，实现与电脑的有线网络互通（无需WIFI）
即插即用设备（刷ROM机型）
① 连接OTG机箱与手机
② 开机自动启动WIFI ADB 5555端口
③ 飞飞软件点击「WIFI扫描」自动发现设备
普通OTG设备（未刷ROM）
① 先用USB模式连接手机到飞飞软件
② 按前文步骤开启WIFI ADB 5555
③ 断开USB，保持OTG机箱供电和网络连接
网段扫描设置
飞飞软件操作：
① 点击顶部「WIFI 扫描」按钮
② 输入手机显示的局域网IP段（例：192.168.0.1-192.168.0.255）
③ 点击「开始扫描」等待设备列表更新
🖥️ 核心ADB指令速查表
WIFI ADB操作指令
| 功能 | 指令 | 备注 |
|---|---|---|
| 开启WIFI ADB | adb tcpip 5555 |
需先通过USB连接，端口固定为5555 |
| 关闭WIFI ADB | adb usb |
断开无线连接，恢复USB调试模式 |
| 手动连接设备 | adb connect 192.168.0.100:5555 |
需知道手机IP地址（可在手机「设置→关于手机→状态信息」查看） |
功能类指令
| 名称 | 命令 | 备注 |
|---|---|---|
| 重启 | adb reboot |
|
| 重启手机到recovery刷机模式 | adb reboot recovery |
|
| 重启手机到bootloader界面 | adb reboot bootloader |
|
| 关机 | adb shell reboot -p |
|
| 恢复设备DPI | adb shell wm density reset |
|
| 修改设备DPI | adb shell wm density 320 |
320（自定义dpi） |
| 查看设备DPI | adb shell wm density |
|
| 恢复设备分辨率 | adb shell wm size reset |
|
| 修改设备分辨率 | adb shell wm size 1080x1920 |
1080x1920（自定义分辨率） |
| 查看设备分辨率 | adb shell wm size |
|
| 查看设备序列号 | adb get-serialno |
|
| 查看设备详情列表 | adb devices -l |
|
| 查看第三方应用包名 | adb shell pm list packages -3 |
|
| 查看系统应用的所有包名 | adb shell pm list packages -s |
|
| 查看所有应用包名 | adb shell pm list packages |
|
| 查看内存使用情况 | adb shell dumpsys meminfo |
|
| 清除应用数据与缓存，需要指定包 | adb shell pm clear cn.com.test.mobile |
cn.com.test.mobile（自定义包名） |
| 卸载应用，需要指定包 | adb uninstall cn.com.test.mobile |
cn.com.test.mobile（自定义包名） |
| 卸载应用，但保留数据，需要指定包 | adb uninstall -k cn.com.test.mobile |
cn.com.test.mobile（自定义包名） |
| 强制停止应用 | adb shell am force-stop cn.com.test.mobile |
cn.com.test.mobile（自定义包名） |
| 截屏 | adb shell screencap -p /sdcard/01.png |
01.png（自定义截屏名称） |
| 安装apk | adb install d:/temp/1.apk |
d:/temp/1.apk（apk绝对路径） |
| 设置电量百分比 | adb shell dumpsys battery set level 100 |
100(自定义电量百分比) |
| 启动应用 | adb shell am start -n cn.com.test.mobile/.ui.SplashActivity |
-n cn.com.test.mobile（包名）.ui.SplashActivity |
| 查看Android 系统版本 | adb shell getprop ro.build.version.release |
|
| 查看占用内存前10的应用 | adb shell top -s 10 |
|
| 查看设备品牌 | adb shell getprop ro.product.brand |
|
| 开启 WiFi | adb shell svc wifi enable |
|
| 关闭 WiFi | adb shell svc wifi disable |
|
| 开启指针显示 | adb shell settings put system pointer_location 1 |
|
| 关闭指针显示 | adb shell settings put system pointer_location 0 |
|
| 模拟点击 | adb shell input tap x坐标 y坐标 |
|
| 关闭更新 | adb shell pm disable-user com.wssyncmldm |
|
| 黑屏时执行 | adb shell settings put system screen_off_timeout 2147483647 |
每次重启软件执行一次（在不是黑屏状态下执行） |
按键类指令
| 名称 | 命令 | 备注 |
|---|---|---|
| 电源键 | adb shell input keyevent 26 |
|
| 菜单键 | adb shell input keyevent 82 |
|
| HOME 键 | adb shell input keyevent 3 |
|
| 返回键 | adb shell input keyevent 4 |
|
| 增加音量 | adb shell input keyevent 24 |
|
| 降低音量 | adb shell input keyevent 25 |
|
| 静音 | adb shell input keyevent 164 |
|
| 播放/暂停 | adb shell input keyevent 85 |
|
| 停止播放 | adb shell input keyevent 86 |
|
| 播放下一首 | adb shell input keyevent 87 |
|
| 播放上一首 | adb shell input keyevent 88 |
|
| 恢复播放 | adb shell input keyevent 126 |
|
| 暂停播放 | adb shell input keyevent 127 |
|
| 点亮屏幕 | adb shell input keyevent 224 |
|
| 熄灭屏幕 | adb shell input keyevent 223 |
|
| 滑动解锁，向上滑动手势解锁 | adb shell input swipe 300 1000 300 500 |
参数 300 1000 300 500 分别表示起始点x坐标 起始点y坐标 结束点x坐标 结束点y坐标 |
| 焦点处于某文本框时输入文本 | adb shell input text hello |
小米MIUI优化指令
| 名称 | 命令 | 备注 |
|---|---|---|
| 禁用智能服务 | adb shell pm disable-user com.miui.systemAdSolution |
|
| 禁用小米电商 | adb shell pm disable-user com.xiaomi.ab |
|
| 禁用用户反馈 | adb shell pm disable-user com.miui.bugreport |
|
| 禁用系统毒瘤 | adb shell pm disable-user com.miui.analytics |
|
| 删除开屏广告 | adb shell rm -f -r /sdcard/Android/data/com.miui.systemAdSolution/files |
|
| 防止开屏广告再生 | adb shell touch /sdcard/Android/data/com.miui.systemAdSolution/files |
常见问题指令
查看设备列表：adb devices
结束ADB进程：adb kill-server
重启ADB服务：adb start-server
查看设备IP：adb shell ifconfig wlan0 | grep inet
⚠️ 全场景故障排查
场景1：无线连接失败
① 确认手机与电脑同网段（IP前缀一致，如均为192.168.0.x）
② 检查路由器防火墙设置，允许ADB端口（5555）通信
③ 重启手机WIFI和电脑网络适配器
场景2：OTG机箱扫描不到设备
① 确认OTG转接头指示灯正常（常亮表示连接正常）
② 手动输入手机IP段（如192.168.1.1-192.168.1.255）
③ 检查手机是否开启「仅充电模式下允许ADB调试」
场景3：ADB冲突报错
① 任务管理器结束所有adb.exe进程
② 卸载冲突软件：安卓模拟器、360手机助手、酷狗音乐等
③ 重启电脑后重新连接
场景4：在输入密码时，手机黑屏
① 手机->系统设置->输入法设置->关闭安全输入（安全键盘）进程
② 没有安全键盘设置，或者关了安全输入依然黑屏的话就只能root了
🎬 视频功能演示
点击播放按钮查看软件操作演示视频
🔁 脚本执行演示
点击播放按钮查看脚本执行演示
⌨ 自定义键盘映射
按键映射文件为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：切换自定义按键映射的开关键，默认为普通映射，需要使用这个按键在普通映射和自定义映射之间切换。
-
mouseMoveMap：鼠标移动映射，鼠标的移动将被映射为以startPos为起点，以鼠标移动方向为移动方向的手指拖动操作（开启鼠标移动映射以后会隐藏鼠标，限制鼠标移动范围）。 一般在FPS手游中用来调整人物视野。
- startPos：手指拖动起始点
- speedRatio：鼠标移动映射为手指拖动的比例，可以控制鼠标灵敏度，数值要大于0.00225，数值越大，灵敏度越低，Y轴以2.25的比率平移。如果这不适合您的手机屏幕，请使用以下两种设置来设置单个灵敏度值。
- speedRatioX：鼠标X轴的速度比灵敏度。此值必须至少为0.001。
- speedRatioY：鼠标Y轴的速度比灵敏度。此值必须至少为0.001。
- smallEyes：触发小眼睛的按键，按下此按键以后，鼠标的移动将被映射为以smallEyes.pos为起点，以鼠标移动方向为移动方向的手指拖动操作
-
keyMapNodes：一般按键的映射，JSON数组，所有一般按键映射都放在这个数组中，将键盘的按键映射为普通的手指点击。
一般按键映射有如下几种类型：
-
type：按键映射的类型，每个keyMapNodes中的元素都需要指明，可以是如下类型：
- KMT_CLICK：普通点击，按键按下模拟为手指按下，按键抬起模拟为手指抬起
- KMT_CLICK_TWICE：两次点击，按键按下模拟为手指按下再抬起，按键抬起模拟为手指按下再抬起
- KMT_CLICK_MULTI：多次点击，根据clickNodes数组中的delay和pos实现一个按键多次点击
- KMT_DRAG：拖拽，按键按下模拟为手指按下并拖动一段距离，按键抬起模拟为手指抬起
- KMT_STEER_WHEEL：方向盘映射，专用于FPS游戏中移动人物脚步的方向盘的映射，需要4个按键来配合。
不同按键映射类型的专有属性说明：
-
KMT_CLICK
- key：要映射的按键码
- pos：模拟触摸的位置
- switchMap：是否释放出鼠标，点击此按键后，除了默认的模拟触摸映射，是否释放出鼠标操作。（可以参考和平精英映射中M地图映射的效果）
-
KMT_CLICK_TWICE
- key：要映射的按键码
- pos：模拟触摸的位置
-
KMT_CLICK_MULTI
- delay：延迟delay毫秒以后再模拟触摸
- pos：模拟触摸的位置
-
KMT_DRAG
- key：要映射的按键码
- startPos：模拟触摸拖动的开始位置
- endPos：模拟触摸拖动的结束位置
- dragSpeed：拖动移动的速度（范围0-1，默认1.0）。数值越大，移动越快
- startDelay：可选的延迟时间（毫秒），在开始拖动移动之前等待指定的时间
-
KMT_STEER_WHEEL
- centerPos：方向盘中心点
- leftKey：左方向的按键控制
- rightKey：右方向的按键控制
- upKey：上方向的按键控制
- downKey：下方向的按键控制
- leftOffset：按下左方向键后模拟拖动到相对centerPos位置水平偏左leftOffset处
- rightOffset：按下右方向键后模拟拖动到相对centerPos位置水平偏右rightOffset处
- upOffset：按下上方向键后模拟拖动到相对centerPos位置水平偏上upOffset处
- downOffset：按下下方向键后模拟拖动到相对centerPos位置水平偏下downOffset处