pyphone

简介

pyphone是Python+PyQt5实现的跨平台Android手机投屏与操控工具，投屏使用minicap，操控使用minitouch

初始化

确认已安装了Python3.6或更高版本。
安装依赖库（推荐使用pipenv管理虚拟环境）：

pip install -r requirements.txt

将手机连接到电脑，并确认调试模式已打开。

cd tools
python install.py

install.py脚本尝试自动安装对应手机版本的minicap/minicap.so/minitouch
pyphone默认使用8081与8082端口与手机通信，请确保这两个端口未被其它进程占用。
若要支持中文输入，请参考下文的如何输入中文

环境变量

PYDROID_VIRTUAL_AS_SCREEN

取值true/false
当设置为true（默认值）时，压缩minicap输出图片尺寸为pyphone窗口控件的实际尺寸，此时图片较小，传输更快。
当设置为false时，不压缩minicap输出图片尺寸，此时图片较大（为手机实际分辨率尺寸），可用于高清录屏。

PYDROID_HEIGHT

取值为大于0且小于手机实际高度的整数，默认为720。

启动

python main.py

共享屏幕

请先确认你有一个可用的Redis服务器
共享开启后（File->Enable Share），pyphone将屏幕数据发送到Redis服务器队列。其它用户可通过pyphone的Connect remote screen菜单连接到该队列，实现屏幕共享。
默认的Redis服务器地址在config.py中的REDIS_HOST变量中定义（默认localhost:6379），用户可以修改此地址指向自己的主机。开启共享后，pyphone还允许用户往操控队列中发送控制指令，目前支持的指令和格式如下：

单击：{"cmd": "click", "x": 1, "y": 2}
滑动：{"cmd": "swipe", "direction": "up|down|left|right", "border": "yes|no"}
输入文本：{"cmd": "text", "text": "HelloWorld123!!"}
截屏：{"cmd": "screenshots", "filepath": "/tmp/test.jpg"}
Shell命令：{"cmd": "shell", "param": "getprop ro.build.version.sdk | tr -d '\r'"}
示例：

import redis
import json

r = redis.Redis("localhost", 6379, db=3)
r.ping()

op_str = json.dumps({"cmd": "click", "x": 123, "y": 456})
share_id = 1701
r.lpush("pp-touch:%d" % share_id, op_str)

如何输入中文

默认的adb shell input text无法输入中文，可使用开源工具ADBKeyBoard解决。安装与使用示例：

cd tools
adb install ADBKeyboard.apk # 注意有些安卓手机要求在手机上确认安装过程
adb shell ime set com.android.adbkeyboard/.AdbIME # 切换到ADBKeyboard输入法
adb shell am broadcast -a ADB_INPUT_TEXT --es msg '中文输入'

可能遇到的题

1. minicap\jni\minicap-shared\aosp\libs下找不到比较新版本AndroidSDK的so怎么办？

可直接去这个仓库下载：https://github.com/DeviceFarmer/minicap
仓库的作者编译好了N多版本的so

2. minitouch 启动失败怎么办？

可能会因为权限问题导致minitouch无法访问输入设备文件

open: Permission denied
Unable to open device /dev/input/event0 for inspectionopen: Permission denied
Unable to open device /dev/input/event5 for inspectionopen: Permission denied
Unable to open device /dev/input/event3 for inspectionopen: Permission denied
Unable to open device /dev/input/event4 for inspectionopen: Permission denied
Unable to open device /dev/input/mice for inspectionopen: Permission denied
Unable to open device /dev/input/mouse0 for inspectionopen: Permission denied
Unable to open device /dev/input/event1 for inspectionopen: Permission denied
Unable to open device /dev/input/event6 for inspectionopen: Permission denied

可以越狱手机，获得root权限，修改设备文件权限：

adb root
adb shell chmod 666 /dev/input/event*

推荐使用Pixel手机，刷入LineageOS，并通过刷入magisk获取root权限，获取root权限方法如下

访问https://magiskapp.com/apk/下载最新版magisk安装包（页面加载完成后，需要等待15秒左右才会出现“Download Magisk App (Latest)”按钮）
先在把刚刚下载的安装包，传到手机上正常安装，安装完成后打开Magisk应用，会提示“需要修复环境”，点击确认，之后会自动重启。进入Recovery模式，进入Apply Update->Apply from ADB，电脑上还是使用刚才下载的安装包，将文件后缀由apk改为zip，执行：

adb sideload <magisk filename>.zip

magisk没有使用LineageOS 的密钥签名，手机会弹出警告，选择yes即可，安装完成后重启手机。

littleningmeng / pyphone