# MobileControl

**Repository Path**: qq714081644/MobileControl

## Basic Information

- **Project Name**: MobileControl
- **Description**: 基于Minicap和Minitouch实现仿Webkey远程控屏软件，需Root权限
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2021-06-08
- **Last Updated**: 2024-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MobileControl
Android端基于minicap和minitouch实现仿Webkey远程控屏软件，需Root权限。
> 此项目仅做功能展示，可能存在bug。
## 实现功能
- 支持查看手机画面、远程控制
- 支持上传文件到设备
## 项目引入框架
|    框架   |主要功能                          
|:-----------:|:-----------:
|[minicap](https://github.com/openstf/minicap)|手机截屏            
|[minitouch](https://github.com/openstf/minitouch)|手机模拟触摸          
|[nanohttpd](https://github.com/NanoHttpd/nanohttpd)|搭建HTTP服务器
|[Java-WebSocket](https://hub.fastgit.org/TooTallNate/Java-WebSocket)|搭建WebSocket服务器
## 项目运行效果
浏览器输入`http://ip:9099`，**ip**为设备ip地址，确保在同一网络。  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%88%AA%E5%9B%BE.png)  
触摸方向旋转0°  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%89%8B%E6%9C%BA%E6%8E%A7%E5%88%B60%C2%B0.gif)  
触摸方向旋转90°  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%89%8B%E6%9C%BA%E6%8E%A7%E5%88%B690%C2%B0.gif)  
触摸方向旋转180°  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%89%8B%E6%9C%BA%E6%8E%A7%E5%88%B6180%C2%B0.gif)  
触摸方向旋转270°  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%89%8B%E6%9C%BA%E6%8E%A7%E5%88%B6270%C2%B0.gif)  
查看控制台日志  
![MobileControl](https://github.com/shenbengit/MobileControl/blob/master/screenshots/%E6%89%8B%E6%9C%BA%E6%8E%A7%E5%88%B6%E6%8E%A7%E5%88%B6%E5%8F%B0%E6%88%AA%E5%9B%BE.png)

## 使用流程
### minicap和minitouch
- 编译
  - 若您不想编译，则可以在[这里](https://github.com/shenbengit/MobileControl/tree/master/app/src/main/assets)直接使用已经编译好的。
  - 手动编译，具体参考[minicap](https://github.com/openstf/minicap)和[minitouch](https://github.com/openstf/minitouch)项目说明。
- 通信协议
  - adb shell 命令
  获取屏幕分辨率
  ```shell
  adb wm size
  ```
  获取cpu的arm架构
  ```shell
  adb shell getprop ro.product.cpu.abi
  ```
  根据不同的arm架构拷贝对应的文件到文件`/data/local/tmp/`目录下，[详见](https://github.com/shenbengit/MobileControl/blob/dcda9e57962a076e74ad873a84ba248dc0ba33cc/app/src/main/java/com/example/mobilecontrol/manager/MobileControlManager.kt#L179)
  - minicap
  测试minicap是否可用（-P 后面的参数: {真实宽度}x{真实高度}@{虚拟宽度}x{虚拟高度}/{方向}.）
  ```shell
  adb shell LD_LIBRARY_PATH=/data/local/tmp /data/local/tmp/minicap -P 1080x1920@1080x1920/0 -t
  ```
  若最后输出OK，则表示支持可用。
  启动minicap（-P 后面的参数: {真实宽度}x{真实高度}@{虚拟宽度}x{虚拟高度}/{方向}.）
  ```shell
  adb shell LD_LIBRARY_PATH=/data/local/tmp /data/local/tmp/minicap -P 1080x1920@1080x1920/0
  ```
    - 数据协议  
    首次接收到的信息（24字节）
    
    |    字节   |长度                          |注释
    |:----------------:|:-------------------------------:|:-----------------------------:|
    |0|1|版本号|
    |1|1|长度|
    |2-5|4|低位优先，进程pid|
    |6-9|4|低位优先，实际显示宽度（以像素为单位）|
    |10-13|4|低位优先，实际显示高度（以像素为单位）|
    |14-17|4|低位优先，虚拟显示宽度（以像素为单位）|
    |18-21|4|低位优先，虚拟显示高度（以像素为单位）|
    |22|1|方向|
    |23|1|怪异的位标志|
## 目前存在问题
- minicap或minitouch有时候会失效，具体问题是用`adb`初始化时无数据返回，已经添加`刷新`功能用于兼容。
- 无法上传大文件，Websocket会断，经过测试100M以内可以。