【亲测免费】 ws-scrcpy 安装与配置完全指南

---

项目基础介绍 ws-scrcpy 是一个基于Genymobile的scrcpy项目的Web客户端原型，旨在通过WebSocket提供远程控制和屏幕镜像功能。该工具支持Android设备，让用户能在浏览器中实时查看并操控Android设备。项目主要采用TypeScript开发，并且在客户端-服务器架构上，结合了WebSockets等前端技术及Node.js作为后端运行环境。

---

关键技术和框架

• 前端技术: TypeScript, JavaScript, HTML/CSS, WebSockets, Media Source Extensions (MSE), Web Workers, WebAssembly (WASM), possibly WebCodecs.
• 后端: Node.js。
• 库和组件: 引用了不同的解码器实现，如 MSE Player, Broadway Player, TinyH264 Player 及 WebCodecs Player，以适应不同浏览器的视频解码能力。
• Android交互: 利用ADB工具进行设备连接和调试，需要adb命令行工具的支持。
• 跨平台兼容性: 支持iOS设备的实验性功能，依赖特定配置和外部工具。

---

准备工作与详细安装步骤

环境准备

1. 系统要求: 任何可以安装Node.js的系统。
2. Node.js安装: 确保你的系统安装了Node.js v10或更高版本。
3. adb工具: 需要安装Android SDK中的Platform Tools，确保adb命令可在命令行中执行。
4. 环境变量: 确保adb路径已添加到系统的PATH环境中。
5. 可选: 对于iOS设备的支持，还需安装额外的工具和配置WebDriverAgent。

安装步骤

第一步：克隆仓库

打开终端或命令提示符，使用Git克隆项目：

git clone https://github.com/NetrisTV/ws-scrcpy.git
cd ws-scrcpy

第二步：安装依赖

进入项目目录后，使用npm安装所有必要的依赖：

npm install

第三步：配置ADB路径

确保adb可以在无须指定全路径的情况下被调用。如果遇到问题，可考虑在build/config/override.json文件中配置ADB路径（若需要自定义配置）。

第四步：启动服务

项目提供了多种播放器类型和特性，默认配置下使用所有功能。无需修改直接启动：

npm start

这将编译代码并启动服务器。如果需要定制功能，编辑build/config/override.json然后重新启动。

第五步：连接Android设备

1. 启用开发者选项并在您的Android设备上开启ADB调试。
2. USB连接设备到电脑，或如果已设置TCP/IP模式，则可以无线连接（通过adb tcpip 5555命令）。
3. 在设备列表中选择对应的设备，或确保ws-scrcpy-server能监听所有接口以从浏览器直接访问（需适当配置）。

第六步：访问Web界面

在浏览器中打开显示的地址（通常是http://localhost:8080或其他指定端口），您应能看到设备屏幕并能够进行控制。

---

注意事项

• 对于iOS设备的支持是实验性的，需要额外的设置。
• 确保在不安全的网络环境下时，考虑到项目提及的安全风险，如无加密通信。
• 浏览器可能对某些特性（如WebCodecs）有特定的支持需求，确保所使用的浏览器是最新的或至少满足项目文档的最低要求。

这样，您就成功地安装并配置了ws-scrcpy，可以开始享受远程控制和镜像功能了。