/FreeControl

在PC上控制Android设备。

Primary LanguageC#MIT LicenseMIT

FreeControl

介绍

[ 中文 | English ]

基于开源项目scrcpy,提供简洁的交互界面。

  • 编码语言 C#
  • 开发工具 Visual Studio 2022
  • 运行环境 .NET Framework 4.7.2

界面

下载

GitHub Release

https://github.com/pdone/FreeControl/releases/latest/download/FreeControl.exe

ghproxy

https://mirror.ghproxy.com/github.com/pdone/FreeControl/releases/latest/download/FreeControl.exe

代码存储库

更新记录

常见问题

输入法问题

个人测试发现,目前支持跨屏进行拼音输入的 手机输入法APP 如下:

  • 搜狗输入法
  • QQ输入法
  • 谷歌拼音输入法
  • Gboard
  • 微信输入法

此功能需要输入法APP适配,有更好用的输入法欢迎留言推荐。

⭐自动切换输入法功能说明

由于大多数朋友日常使用的输入法不支持跨屏输入,所以增加了启动时自动切换输入法的功能,用于自动切换到非日常使用、但支持跨屏输入的输入法。

在主界面中设置启动时要切换的输入法,点击启动按钮便会自动切换(确保手机上已安装对应输入法APP)。

关闭窗口时,会切换回原来的输入法。

设备连接问题

USB 连接

通过 USB 连接来正常使用 adb 需要保证几点:

  1. 硬件状态正常。

    包括 Android 设备处于正常开机状态,USB 连接线和各种接口完好。

  2. Android 设备的开发者选项和 USB 调试模式已开启。

    可以到「设置」-「开发者选项」-「Android 调试」查看。

    如果在设置里找不到开发者选项,那需要通过一个彩蛋来让它显示出来:在「设置」-「关于手机」连续点击「版本号」7 次。

  3. 设备驱动状态正常。

    这一点貌似在 Linux 和 Mac OS X 下不用操心,在 Windows 下有可能遇到需要安装驱动的情况,确认这一点可以右键「计算机」-「属性」,到「设备管理器」里查看相关设备上是否有黄色感叹号或问号,如果没有就说明驱动状态已经好了。否则可以下载一个手机助手类程序来安装驱动先。

  4. 通过 USB 线连接好电脑和设备后确认状态。

    adb devices

    如果能看到

    6d56e83a device

    说明连接成功。

无线连接(Android11 及以上)

Android 11 及更高版本支持使用 Android 调试桥 (adb) 从工作站以无线方式部署和调试应用。例如,您可以将可调试应用部署到多台远程设备,而无需通过 USB 实际连接设备。这样就可以避免常见的 USB 连接问题,例如驱动程序安装方面的问题。

官方文档

操作步骤:

  1. 更新到最新版本的 SDK 平台工具(至少30.0.0)。

  2. 将 Android 设备与要运行 adb 的电脑连接到同一个局域网,比如连到同一个 WiFi。

  3. 在开发者选项中启用无线调试

  4. 在询问要允许在此网络上进行无线调试吗?的对话框中,点击允许。

  5. 选择使用配对码配对设备,使用弹窗中的 IP 地址和端口号。

    adb pair ipaddr:port
  6. 提示 Enter pairing code: 时输入弹窗中的配对码,成功后会显示 Successfully paired to ...

  7. 使用无线调试下的 IP 地址和端口

    adb connect ipaddr:port
  8. 确认连接状态。

    adb devices

    如果能看到

    ipaddr:port device

    说明连接成功。

无线连接(需要借助 USB 线)

除了可以通过 USB 连接设备与电脑来使用 adb,也可以通过无线连接——虽然连接过程中也有需要使用 USB 的步骤,但是连接成功之后你的设备就可以在一定范围内摆脱 USB 连接线的限制啦!

操作步骤:

  1. 将 Android 设备与要运行 adb 的电脑连接到同一个局域网,比如连到同一个 WiFi。

  2. 将设备与电脑通过 USB 线连接。

    应确保连接成功(可运行 adb devices 看是否能列出该设备)。

  3. 让设备在 5555 端口监听 TCP/IP 连接:

    adb tcpip 5555
  4. 断开 USB 连接。

  5. 找到设备的 IP 地址。

    一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到。

  6. 通过 IP 地址连接设备。

    adb connect <device-ip-address>

    这里的 <device-ip-address> 就是上一步中找到的设备 IP 地址。

  7. 确认连接状态。

    adb devices

    如果能看到

    <device-ip-address>:5555 device

    说明连接成功。

如果连接不了,请确认 Android 设备与电脑是连接到了同一个 WiFi,然后再次执行 adb connect <device-ip-address> 那一步;

如果还是不行的话,通过 adb kill-server 重新启动 adb 然后从头再来一次试试。

无线连接(无需借助 USB 线)

需要 root 权限,此处不做详细说明,有需要的朋友可参考此处

保持唤醒功能

仅在手机充电时有效。

音频转发功能

使用 Android 11 或更高版本的设备支持音频转发,并且默认情况下启用:

  • 对于 Android 12 或更高版本,它开箱即用。
  • 对于 Android 11 ,您需要确保在启动scrcpy时设备屏幕已解锁。假的弹出窗口将短暂出现,使系统认为shell应用程序处于前台。没有这个,音频捕获将失败。
  • 对于 Android 10 或更早版本,无法捕获音频并自动禁用。

捐赠

如果您觉得这个项目对您有帮助,欢迎请作者喝杯咖啡。☕

展开

Stargazers Over Time

Stargazers over time