HOScrcpy终极指南：5分钟实现鸿蒙设备远程投屏的完整教程

【免费下载链接】鸿蒙远程真机工具 该工具主要提供鸿蒙系统下基于视频流的投屏功能，帧率基本持平真机帧率，达到远程真机的效果。 项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy

想要在电脑上流畅操控鸿蒙设备吗？HOScrcpy作为一款专业的鸿蒙远程投屏工具，通过视频流技术实现了近乎原生的投屏体验。这款鸿蒙远程真机工具不仅帧率稳定，操作响应也极为迅速，是鸿蒙开发者进行应用调试的得力助手。

🎯 HOScrcpy核心功能解析

HOScrcpy是一款基于视频流的鸿蒙设备远程控制工具，主要提供以下核心能力：

• 实时屏幕镜像：将鸿蒙设备屏幕实时投射到电脑端
• 低延迟操作：支持鼠标点击、键盘输入等实时控制
• 高清视频流：帧率基本持平真机帧率，达到远程真机的效果
• 跨平台支持：兼容Windows和macOS系统

📊 技术架构与工作原理

HOScrcpy采用分层架构设计，通过以下组件协同工作：

组件层级	功能描述	对应源码位置
视频采集层	从鸿蒙设备采集屏幕视频流	src/main/java/utils/callbacks/
网络传输层	处理视频流数据传输	src/main/java/utils/
控制指令层	处理鼠标键盘输入事件	src/main/java/forms/
界面展示层	提供用户操作界面	src/main/java/forms/

🚀 快速开始：三步完成环境部署

第一步：获取项目源码

git clone https://link.gitcode.com/i/aaf10d209b10d05bb722835e3acb3cb7.git
cd HOScrcpy

第二步：一键构建项目

mvn clean package

第三步：启动投屏工具

java -jar target/HOScrcpy.jar

🛠️ 详细构建流程解析

Windows平台构建步骤

1. 配置构建工件 首先需要在IDE中配置构建工件，确保项目能够正确打包。

2. 设置工件参数 根据项目需求配置输出路径和依赖项。

3. 完成工件设置 确认所有配置项，准备开始构建。

4. 执行构建操作 开始构建过程，生成可执行文件。

5. 获取构建产物 构建完成后，产物会存放在项目的out文件夹下。

macOS平台构建注意事项

macOS平台的构建步骤与Windows基本相同，但需要修改一个关键依赖：

<!-- Windows平台依赖 -->
<dependency>
    <groupId>org.bytedeco</groupId>
    <artifactId>ffmpeg</artifactId>
    <version>6.0-1.5.9</version>
    <classifier>windows-x86_64</classifier>
</dependency>

<!-- macOS平台需要修改为 -->
<dependency>
    <groupId>org.bytedeco</groupId>
    <artifactId>ffmpeg</artifactId>
    <version>6.0-1.5.9</version>
    <classifier>macosx-x86_64</classifier>
</dependency>

🖥️ HOScrcpy主界面功能详解

启动HOScrcpy后，您将看到以下主界面：

界面功能区域说明

设备投屏显示区

• 实时显示鸿蒙设备屏幕内容
• 支持鼠标直接操作设备界面
• 显示设备当前状态信息

快捷控制面板

• 电源键：控制设备开关机
• 音量加/减：调节设备音量
• 返回键：返回上一级界面
• 主页键：返回设备主屏幕
• 多任务键：显示最近应用

高级功能选项

• 停止投屏：结束当前投屏会话
• 刷新设备：重新扫描可用设备
• 设置选项：调整投屏参数配置

🔧 使用前的重要配置

环境变量配置

使用前需要保证在系统环境变量中配置JAVA_HOME环境变量（注意：JAVA_HOME环境变量不需要包含bin目录）

启动命令说明

在构建出的工件jar包存放路径下，执行以下命令：

java -jar HOScrcpy.jar -cp Main

命令执行后将会出现投屏界面，刷新出设备后点击"进入投屏按钮"，稍等片刻，即会出现投屏画面。

🌐 Web端投屏演示

HOScrcpy还提供了Web端演示功能，让您可以在浏览器中体验鸿蒙设备投屏。

Web Demo项目结构

web_demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── MyWebSocket.java
│   │   └── resources/
│   │       ├── html/
│   │       │   ├── h264.html
│   │       │   └── jmuxer.min.js
│   │       └── libs/
│   │           └── hosscrcpy-1.0.4-beta.jar
└── pom.xml

Web端使用方法

1. 启动WebSocket服务 执行MyWebSocket.java中的main方法启动WebSocket服务端

2. 配置设备信息 修改resources/html/h264.html的第31行，填写自己本地设备的SN号

3. 打开浏览器查看 用浏览器打开h264.html，稍等片刻即可看到投屏画面

注意：静止画面下不会自动刷新，可以滑动下手机查看实时效果。

📊 HOScrcpy API功能概览

HOScrcpy提供了丰富的API接口，支持开发者进行二次开发：

核心API类

类名	主要功能	使用场景
HosRemoteDevice	设备连接与屏幕控制	创建投屏会话、注入输入事件
ScreenCapCallback	视频流回调处理	接收屏幕数据、处理异常
HosRemoteConfig	投屏参数配置	设置分辨率、帧率、码率等

常用API方法示例

// 创建设备连接
HosRemoteDevice device = new HosRemoteDevice("设备SN号");

// 配置投屏参数
HosRemoteConfig config = new HosRemoteConfig("设备SN号");
config.setScale(2);      // 分辨率缩放为1/2
config.setFrameRate(60); // 设置帧率为60FPS
config.setBitRate(20000); // 设置码率为20M

// 开始投屏
device.startCaptureScreen(new ScreenCapCallback() {
    @Override
    public void onData(ByteBuffer buffer) {
        // 处理视频流数据
    }
    
    @Override
    public void onReady() {
        // 投屏准备就绪
    }
});

⚡ 性能优化技巧

投屏参数调优建议

1. 分辨率设置

   • 网络良好：使用原始分辨率
   • 网络一般：使用2倍缩放
   • 网络较差：使用3-5倍缩放

2. 帧率优化

   • 静态应用：30-60FPS
   • 动态应用：60-120FPS
   • 游戏应用：120FPS以上

3. 码率调整

   • 局域网环境：20-30Mbps
   • 广域网环境：5-10Mbps
   • 移动网络：2-5Mbps

常见问题排查

问题现象	可能原因	解决方案
设备连接失败	USB调试未开启	检查设备开发者选项
投屏画面卡顿	网络带宽不足	降低分辨率或帧率
无法控制设备	权限配置问题	检查设备控制权限
画面延迟过高	网络延迟大	优化网络环境

🎉 开始您的鸿蒙投屏之旅

通过本教程，您已经掌握了HOScrcpy远程投屏工具的完整使用方法。无论是进行应用开发调试，还是简单的跨设备操作，这款工具都能为您提供稳定可靠的解决方案。

下一步建议

1. 体验基础功能：先从简单的设备投屏开始
2. 尝试Web演示：了解Web端集成方式
3. 探索API接口：根据需求进行二次开发
4. 优化性能参数：根据实际网络环境调整配置

立即动手尝试，体验在电脑上流畅操控鸿蒙设备的便捷感受！如果您在使用过程中遇到任何问题，可以参考项目文档或联系开发团队获取支持。

---

项目资源：

• 源码仓库：https://link.gitcode.com/i/aaf10d209b10d05bb722835e3acb3cb7
• API文档：hoscrcpy API介绍.md
• 示例代码：web_demo/

【免费下载链接】鸿蒙远程真机工具 该工具主要提供鸿蒙系统下基于视频流的投屏功能，帧率基本持平真机帧率，达到远程真机的效果。 项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy