# Mirror

**Repository Path**: hjess/mirror

## Basic Information

- **Project Name**: Mirror
- **Description**: 用于安卓设备有线或无线ADB连接宿主机后，向局域网内其他客户机提供投屏远控功能的服务应用
- **Primary Language**: Go
- **License**: BSD-3-Clause-Clear
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-11-10
- **Last Updated**: 2024-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mirror项目说明
Mirror是用于安卓设备有线或无线ADB连接宿主机后，向局域网内其他客户机提供投屏远控功能的服务应用

## 1、项目构成
按项目模块划分，本服务应用由三个部分构成：

1.1 宿主机服务程序：使用Go语言开发，包含ADB的Go语言包装、设备管理、客户机HTTP及WebSock服务器等

1.2 安卓设备插件应用：使用Android Java开发，包含ADB连接响应插件、画面捕获、触屏事件模拟、物理按键模拟、远控输入法及一个配置页面

1.3 客户机前端：使用Vue.js开发，包含使用说明首页、设备管理页面、设备投屏及操作页面

## 2、使用方法
本项目的使用方法如下：

2.1 使用USB连线或WIFIADB连接目标安卓设备到宿主机，宿主机可为Windows、Mac或Linux，请确保宿主机有安装目标安卓设备的USB驱动（因为部分品牌安卓设备可能使用非公安卓USB驱动，需要自行在这些品牌官站获取安装），并确保安卓设备有开启开发者模式及USB调试功能

2.2 在宿主机上启动Mirror宿主机服务程序（命令行程序），程序会自动从安卓官网下载最新的Platform-tools工具包（包含ADB程序，文件下载未屏蔽，无需你懂的），然后会自动启动ADB服务检测是否有设备连接，并在终端提示。同时会启动客户机服务器，提供客户机在远端浏览器访问

2.3 能连接到宿主机的远端客户机可以通过浏览器打开宿主服务程序提示的HTTP地址，然后查看、连接与操作宿主机上连接的安卓设备

2.4 客户机可以主动断开或由宿主机超时自动断开连接，并同时自动终止宿主机与对应安卓设备的ADB连接，释放资源

2.5 宿主机服务支持同时连接多台安卓设备，提供给单个或多个客户机同时浏览与操作

## 3、项目规划

待补充