尧图网页设计 
HOScrcpy鸿蒙远程真机工具上手5分钟把鸿蒙设备画面搬上电脑还能反向操控【免费下载链接】鸿蒙远程真机工具该工具主要提供鸿蒙系统下基于视频流的投屏功能帧率基本持平真机帧率达到远程真机的效果。项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy你是不是也遇到过这样的尴尬手机明明就在工位可一上午被同事借去调试你想看一眼页面状态却连设备都摸不着或者你在北京写代码真机却放在深圳的机房里每次改一行 UI 都要远程求人截图。传统做法是接根 USB 线老老实实坐在设备旁边但鸿蒙远程真机工具 HOScrcpy给了你第二条路——基于视频流把设备画面实时搬到电脑上帧率基本持平真机帧率点哪儿设备跟着动哪儿延迟控制在 100 毫秒以内。读完这篇文章你会知道 HOScrcpy 能做什么、桌面版怎么一键投屏、SDK 怎么用三行代码接入自己的项目以及网页端如何让投屏脱离电脑桌面。全程不烧脑跟着步骤走就行。先想清楚HOScrcpy 到底是解决什么问题的一句话HOScrcpy 是一个基于视频流方案的 HarmonyOS NEXT 设备投屏工具核心价值是远程真机——设备不在手边也能像坐在它面前一样看画面、点屏幕、按按键。它面向两类人鸿蒙应用开发者调试 UI、跑自动化测试、排查问题不用守着设备团队或机房运维把一批鸿蒙设备集中部署开发者远程共享提高设备利用率为了让你直观感受它的价值我们把传统方案和 HOScrcpy 摆在一起对比对比项传统 USB 直连调试HOScrcpy 远程真机设备位置必须在身边本地或异地机房均可多人共享一次一人独占多开发者共享同一台设备画面实时性依赖厂商工具视频流采集帧率持平真机操作反控部分工具支持触摸、鼠标、滚轮、虚拟按键全支持二次开发通常闭源接口提供完整 Java API 和网页 demo说白了HOScrcpy 把投屏从本地演示功能升级成了远程真机基础设施。接下来我们分两条路走先看开发者最关心的SDK 三行代码接入再看普通用户开箱即用的桌面工具。三行代码接入视频流投屏HosRemoteDevice 入门示例HOScrcpy 把核心能力封装在com.huawei.hosscrcpy.api包下对开发者暴露三个类HosRemoteDevice设备对象、ScreenCapCallback视频流回调、HosRemoteConfig性能配置。Java 8 及以上版本即可使用。一个最简的投屏示例长这样import com.huawei.hosscrcpy.api.HosRemoteDevice; import com.huawei.hosscrcpy.api.ScreenCapCallback; import java.nio.ByteBuffer; // 1. 通过设备 SN 号创建设备对象 HosRemoteDevice device new HosRemoteDevice(设备SN号); // 2. 注册回调开始拉取视频流并开启实时反控 device.startCaptureScreen(new ScreenCapCallback() { Override public void onData(ByteBuffer byteBuffer) { // 拿到 H.264 视频流数据喂给解码器或播放器渲染 } Override public void onReady() { // 视频流就绪可以执行触摸/按键注入 device.onTouchDown(100, 200); // 模拟手指按下 device.onTouchUp(100, 200); // 模拟手指抬起 } Override public void onException(Throwable throwable) { // 拉流失败在这里处理异常 } });代码很直白onData负责收画面onReady负责告诉你可以开始操作了。这里有个容易踩的坑值得单独提醒如果设备已经亮屏且画面静止onData可能不会被调用因为视频流只在画面变动时才产生。所以官方在onReady里习惯性地动一下设备比如注入一次触摸事件来触发画面刷新——这也是很多人在第一次接入时发现画面黑屏的真正原因。拿到这段代码你就已经具备了自建鸿蒙远程真机平台的基础。但如果你只想快速用起来、不想写界面那就直接看下一节。桌面版免开发直接投屏三步走完从构建到连接HOScrcpy 自带的桌面工具基于 Java Swing 实现已经内置了 H.264 解码、画面渲染、按键面板和控件树拿到就能用。第一步获取并构建项目git clone https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy.git cd HOScrcpy mvn clean package如果你更习惯 IDEA也可以在 IDE 里通过工件Artifact配置打包构建完成后产物会输出到out目录下的HOScrcpy_jar文件夹里面所有 jar 运行时都会用到。第二步启动主程序启动前请确认系统环境变量里已配置JAVA_HOME注意不用包含 bin 目录。然后在 jar 所在目录执行java -jar HOScrcpy.jar -cp MainWindows 用户可以直接运行release/win_start.batmacOS 用户对应release/mac_start.sh。第三步连设备、进投屏打开界面后点刷新设备拉取已连接的鸿蒙设备列表选中你的设备点进入投屏稍等片刻画面就出来了。界面右侧还集成了电源键、音量加/减、返回键等虚拟按键相当于把手机的物理按键搬到了电脑上。到这里你已经完成了把鸿蒙设备画面搬上电脑这件最初的事。但真正的远程真机体验取决于参数调得好不好——下一节我们聊聊性能配置。帧率码率缩放怎么调HosRemoteConfig 性能调优指南HOScrcpy 允许你通过HosRemoteConfig精细化控制视频流质量所有参数都有默认值按需覆盖即可配置方法默认值说明setScale(int)原图分辨率缩放传 2 表示取 1/2、3 表示 1/3最大 5setFrameRate(int)120FPS视频流帧率setBitRate(int)30M视频流码率setPort(int)5000设备侧视频流转发端口setIFrameInterval(int)2000msI 帧间隔影响首帧出画速度setHdcPath(String)自动探测指定 hdc 可执行文件完整路径HosRemoteConfig config new HosRemoteConfig(设备SN号); config.setScale(2); // 分辨率取原图的 1/2 config.setFrameRate(60); // 帧率 60fps config.setBitRate(20); // 码率 20Mbps config.setIFrameInterval(1000);// I 帧间隔 1 秒 HosRemoteDevice device new HosRemoteDevice(config); device.startCaptureScreen(callback);不同场景的取舍建议开发调试高帧率 低缩放追求操作跟手肉眼看到的和真机几乎一致远程演示中等帧率 中等缩放流畅度够用网络占用也低弱网环境低帧率 大缩放倍数先把画面传得动放在第一位记住一个原则帧率和码率不是越高越好它们和你的网络带宽是此消彼长的关系找到平衡点才是远程真机的正确打开方式。视频流还是图片流两种投屏模式怎么选看到这里你可能发现HOScrcpy 还提供了startImageScreenCapture这套图片流接口。没错桌面工具本身就在投屏失败时自动降级到图片流模式。两种模式各有取舍维度视频流默认图片流数据格式H.264 编码JPEG 图片流畅度帧率持平真机丝滑画面刷新依赖设备变动网络开销低编码压缩后小相对更高适用场景常规投屏、反控视频流拉取失败的兼容方案用法上两者几乎一致只是回调里拿到的数据一个是视频帧、一个是图片字节流可直接用ImageIO.read转成BufferedImage渲染。如果你在部分系统版本上遇到视频流拉不起来比如报can not find scrcpy pid图片流就是那个兜底方案。控件树查看与 Layout 导入导出自动化测试的照妖镜HOScrcpy 桌面版另一个实用能力是控件元素查看。进入投屏后点击控件查看工具会调用getLayout()获取当前页面的 UI 结构 JSON并在右侧以树形展示所有控件。点击任意控件节点左侧画面会用红框标出它的位置右侧列出它的text、type、position、xpath等属性。这个功能对两类人特别有用UI 自动化测试先看控件结构再照着xpath或坐标写用例不用再猜控件 ID布局排查哪个控件超出了屏幕、哪个文案重叠了点一下就看得明明白白更贴心的是菜单里还提供了Layout 导入/导出。你可以把某页面的结构 JSON 和截图导出保存之后即使设备不在身边也能拖入 JSON 图片离线复盘页面结构——对跨团队协作排查线上 UI 问题非常实用。让网页也能投屏WebSocket 版远程真机 demo 三连HOScrcpy 不满足于桌面端web_demo模块展示了如何在浏览器里查看和控制设备。原理很简单本地起一个 WebSocket 服务端承载投屏服务网页端通过 WebSocket 接收视频流并渲染同时把鼠标事件回传设备。第一步启动 WebSocket 服务直接运行MyWebSocket.java的main方法服务默认监听 8899 端口。第二步改页面里的设备 SN打开resources/html下的h264.html把第 31 行socketUrl末尾的设备sn替换成你自己的设备序列号var socketUrl ws://127.0.0.1:8899/127.0.0.1/你的设备SN;第三步浏览器打开h264.html稍等片刻即可看到投屏画面鼠标在 video 区域按下、拖动、松开对应的触摸事件就会通过 WebSocket 注入到设备上。网页端实现的核心就一句话ws.onmessage收到二进制数据后交给JMuxer解码渲染到video标签鼠标事件则通过{type:touchEvent, ...}的消息格式回传。整个 demo 思路清晰适合想自建 Web 版远程真机平台的团队直接参考。这里同样有个小提示画面静止时不会自动刷新想看效果先滑动一下手机。常见坑位与解决思路根据项目资料和社区反馈把最高频的几个问题整理如下现象可能原因处理方式刷新不到设备设备 USB 调试未开启开启开发者选项和 USB 调试后重试投屏画面迟迟不出设备静止无新画面产生参考onReady的用法先注入一次触摸视频流拉取失败系统版本不兼容确认 SDK 版本与系统匹配或切换图片流模式鼠标拖拽不生效设备 uitest 版本过低升级系统版本低版本仅支持左右键单击远程设备连不上未添加远程 IP在管理远程 IP中添加设备所在主机 IP其中 SDK 版本兼容性要特别留意老版本系统需要1.0.0-beta新版系统用1.0.1-beta之后的版本1.0.4-beta还专门修复了 5.0.0.71 版本无法投屏的问题。接入前先对照一下设备系统版本。下一步行动清单从读到用只差三步到这里HOScrcpy 的全貌你已经清楚了。如果你也想体验远程真机的感觉按下面三步走先跑桌面版克隆项目、mvn clean package、启动连上你的鸿蒙设备先感受一下帧率持平真机的流畅度再试网页版跑起web_demo把投屏从桌面搬到浏览器理解 WebSocket 的完整链路最后接入自己的系统按上文的三行代码示例封装 SDK把投屏、反控、Layout 导出这些能力整合进你的测试平台或运维系统HOScrcpy 作为开源项目还在持续迭代帧率码率配置、HDC 路径指定、I 帧间隔调节、图片流、鼠标注入……这些能力都是一步步从真实使用场景里长出来的。如果你在接入过程中踩了新坑、或者有更好的想法欢迎在项目仓库提交 Issue 或 Pull Request——远程真机这件小事值得更多人一起把它做好。现在打开电脑连上设备HOScrcpy 已经在等你了。【免费下载链接】鸿蒙远程真机工具该工具主要提供鸿蒙系统下基于视频流的投屏功能帧率基本持平真机帧率达到远程真机的效果。项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 HOScrcpy鸿蒙远程真机工具上手：5分钟把鸿蒙设备画面搬上电脑，还能反向操控
HOScrcpy鸿蒙远程真机工具上手5分钟把鸿蒙设备画面搬上电脑还能反向操控【免费下载链接】鸿蒙远程真机工具该工具主要提供鸿蒙系统下基于视频流的投屏功能帧率基本持平真机帧率达到远程真机的效果。项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy你是不是也遇到过这样的尴尬手机明明就在工位可一上午被同事借去调试你想看一眼页面状态却连设备都摸不着或者你在北京写代码真机却放在深圳的机房里每次改一行 UI 都要远程求人截图。传统做法是接根 USB 线老老实实坐在设备旁边但鸿蒙远程真机工具 HOScrcpy给了你第二条路——基于视频流把设备画面实时搬到电脑上帧率基本持平真机帧率点哪儿设备跟着动哪儿延迟控制在 100 毫秒以内。读完这篇文章你会知道 HOScrcpy 能做什么、桌面版怎么一键投屏、SDK 怎么用三行代码接入自己的项目以及网页端如何让投屏脱离电脑桌面。全程不烧脑跟着步骤走就行。先想清楚HOScrcpy 到底是解决什么问题的一句话HOScrcpy 是一个基于视频流方案的 HarmonyOS NEXT 设备投屏工具核心价值是远程真机——设备不在手边也能像坐在它面前一样看画面、点屏幕、按按键。它面向两类人鸿蒙应用开发者调试 UI、跑自动化测试、排查问题不用守着设备团队或机房运维把一批鸿蒙设备集中部署开发者远程共享提高设备利用率为了让你直观感受它的价值我们把传统方案和 HOScrcpy 摆在一起对比对比项传统 USB 直连调试HOScrcpy 远程真机设备位置必须在身边本地或异地机房均可多人共享一次一人独占多开发者共享同一台设备画面实时性依赖厂商工具视频流采集帧率持平真机操作反控部分工具支持触摸、鼠标、滚轮、虚拟按键全支持二次开发通常闭源接口提供完整 Java API 和网页 demo说白了HOScrcpy 把投屏从本地演示功能升级成了远程真机基础设施。接下来我们分两条路走先看开发者最关心的SDK 三行代码接入再看普通用户开箱即用的桌面工具。三行代码接入视频流投屏HosRemoteDevice 入门示例HOScrcpy 把核心能力封装在com.huawei.hosscrcpy.api包下对开发者暴露三个类HosRemoteDevice设备对象、ScreenCapCallback视频流回调、HosRemoteConfig性能配置。Java 8 及以上版本即可使用。一个最简的投屏示例长这样import com.huawei.hosscrcpy.api.HosRemoteDevice; import com.huawei.hosscrcpy.api.ScreenCapCallback; import java.nio.ByteBuffer; // 1. 通过设备 SN 号创建设备对象 HosRemoteDevice device new HosRemoteDevice(设备SN号); // 2. 注册回调开始拉取视频流并开启实时反控 device.startCaptureScreen(new ScreenCapCallback() { Override public void onData(ByteBuffer byteBuffer) { // 拿到 H.264 视频流数据喂给解码器或播放器渲染 } Override public void onReady() { // 视频流就绪可以执行触摸/按键注入 device.onTouchDown(100, 200); // 模拟手指按下 device.onTouchUp(100, 200); // 模拟手指抬起 } Override public void onException(Throwable throwable) { // 拉流失败在这里处理异常 } });代码很直白onData负责收画面onReady负责告诉你可以开始操作了。这里有个容易踩的坑值得单独提醒如果设备已经亮屏且画面静止onData可能不会被调用因为视频流只在画面变动时才产生。所以官方在onReady里习惯性地动一下设备比如注入一次触摸事件来触发画面刷新——这也是很多人在第一次接入时发现画面黑屏的真正原因。拿到这段代码你就已经具备了自建鸿蒙远程真机平台的基础。但如果你只想快速用起来、不想写界面那就直接看下一节。桌面版免开发直接投屏三步走完从构建到连接HOScrcpy 自带的桌面工具基于 Java Swing 实现已经内置了 H.264 解码、画面渲染、按键面板和控件树拿到就能用。第一步获取并构建项目git clone https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy.git cd HOScrcpy mvn clean package如果你更习惯 IDEA也可以在 IDE 里通过工件Artifact配置打包构建完成后产物会输出到out目录下的HOScrcpy_jar文件夹里面所有 jar 运行时都会用到。第二步启动主程序启动前请确认系统环境变量里已配置JAVA_HOME注意不用包含 bin 目录。然后在 jar 所在目录执行java -jar HOScrcpy.jar -cp MainWindows 用户可以直接运行release/win_start.batmacOS 用户对应release/mac_start.sh。第三步连设备、进投屏打开界面后点刷新设备拉取已连接的鸿蒙设备列表选中你的设备点进入投屏稍等片刻画面就出来了。界面右侧还集成了电源键、音量加/减、返回键等虚拟按键相当于把手机的物理按键搬到了电脑上。到这里你已经完成了把鸿蒙设备画面搬上电脑这件最初的事。但真正的远程真机体验取决于参数调得好不好——下一节我们聊聊性能配置。帧率码率缩放怎么调HosRemoteConfig 性能调优指南HOScrcpy 允许你通过HosRemoteConfig精细化控制视频流质量所有参数都有默认值按需覆盖即可配置方法默认值说明setScale(int)原图分辨率缩放传 2 表示取 1/2、3 表示 1/3最大 5setFrameRate(int)120FPS视频流帧率setBitRate(int)30M视频流码率setPort(int)5000设备侧视频流转发端口setIFrameInterval(int)2000msI 帧间隔影响首帧出画速度setHdcPath(String)自动探测指定 hdc 可执行文件完整路径HosRemoteConfig config new HosRemoteConfig(设备SN号); config.setScale(2); // 分辨率取原图的 1/2 config.setFrameRate(60); // 帧率 60fps config.setBitRate(20); // 码率 20Mbps config.setIFrameInterval(1000);// I 帧间隔 1 秒 HosRemoteDevice device new HosRemoteDevice(config); device.startCaptureScreen(callback);不同场景的取舍建议开发调试高帧率 低缩放追求操作跟手肉眼看到的和真机几乎一致远程演示中等帧率 中等缩放流畅度够用网络占用也低弱网环境低帧率 大缩放倍数先把画面传得动放在第一位记住一个原则帧率和码率不是越高越好它们和你的网络带宽是此消彼长的关系找到平衡点才是远程真机的正确打开方式。视频流还是图片流两种投屏模式怎么选看到这里你可能发现HOScrcpy 还提供了startImageScreenCapture这套图片流接口。没错桌面工具本身就在投屏失败时自动降级到图片流模式。两种模式各有取舍维度视频流默认图片流数据格式H.264 编码JPEG 图片流畅度帧率持平真机丝滑画面刷新依赖设备变动网络开销低编码压缩后小相对更高适用场景常规投屏、反控视频流拉取失败的兼容方案用法上两者几乎一致只是回调里拿到的数据一个是视频帧、一个是图片字节流可直接用ImageIO.read转成BufferedImage渲染。如果你在部分系统版本上遇到视频流拉不起来比如报can not find scrcpy pid图片流就是那个兜底方案。控件树查看与 Layout 导入导出自动化测试的照妖镜HOScrcpy 桌面版另一个实用能力是控件元素查看。进入投屏后点击控件查看工具会调用getLayout()获取当前页面的 UI 结构 JSON并在右侧以树形展示所有控件。点击任意控件节点左侧画面会用红框标出它的位置右侧列出它的text、type、position、xpath等属性。这个功能对两类人特别有用UI 自动化测试先看控件结构再照着xpath或坐标写用例不用再猜控件 ID布局排查哪个控件超出了屏幕、哪个文案重叠了点一下就看得明明白白更贴心的是菜单里还提供了Layout 导入/导出。你可以把某页面的结构 JSON 和截图导出保存之后即使设备不在身边也能拖入 JSON 图片离线复盘页面结构——对跨团队协作排查线上 UI 问题非常实用。让网页也能投屏WebSocket 版远程真机 demo 三连HOScrcpy 不满足于桌面端web_demo模块展示了如何在浏览器里查看和控制设备。原理很简单本地起一个 WebSocket 服务端承载投屏服务网页端通过 WebSocket 接收视频流并渲染同时把鼠标事件回传设备。第一步启动 WebSocket 服务直接运行MyWebSocket.java的main方法服务默认监听 8899 端口。第二步改页面里的设备 SN打开resources/html下的h264.html把第 31 行socketUrl末尾的设备sn替换成你自己的设备序列号var socketUrl ws://127.0.0.1:8899/127.0.0.1/你的设备SN;第三步浏览器打开h264.html稍等片刻即可看到投屏画面鼠标在 video 区域按下、拖动、松开对应的触摸事件就会通过 WebSocket 注入到设备上。网页端实现的核心就一句话ws.onmessage收到二进制数据后交给JMuxer解码渲染到video标签鼠标事件则通过{type:touchEvent, ...}的消息格式回传。整个 demo 思路清晰适合想自建 Web 版远程真机平台的团队直接参考。这里同样有个小提示画面静止时不会自动刷新想看效果先滑动一下手机。常见坑位与解决思路根据项目资料和社区反馈把最高频的几个问题整理如下现象可能原因处理方式刷新不到设备设备 USB 调试未开启开启开发者选项和 USB 调试后重试投屏画面迟迟不出设备静止无新画面产生参考onReady的用法先注入一次触摸视频流拉取失败系统版本不兼容确认 SDK 版本与系统匹配或切换图片流模式鼠标拖拽不生效设备 uitest 版本过低升级系统版本低版本仅支持左右键单击远程设备连不上未添加远程 IP在管理远程 IP中添加设备所在主机 IP其中 SDK 版本兼容性要特别留意老版本系统需要1.0.0-beta新版系统用1.0.1-beta之后的版本1.0.4-beta还专门修复了 5.0.0.71 版本无法投屏的问题。接入前先对照一下设备系统版本。下一步行动清单从读到用只差三步到这里HOScrcpy 的全貌你已经清楚了。如果你也想体验远程真机的感觉按下面三步走先跑桌面版克隆项目、mvn clean package、启动连上你的鸿蒙设备先感受一下帧率持平真机的流畅度再试网页版跑起web_demo把投屏从桌面搬到浏览器理解 WebSocket 的完整链路最后接入自己的系统按上文的三行代码示例封装 SDK把投屏、反控、Layout 导出这些能力整合进你的测试平台或运维系统HOScrcpy 作为开源项目还在持续迭代帧率码率配置、HDC 路径指定、I 帧间隔调节、图片流、鼠标注入……这些能力都是一步步从真实使用场景里长出来的。如果你在接入过程中踩了新坑、或者有更好的想法欢迎在项目仓库提交 Issue 或 Pull Request——远程真机这件小事值得更多人一起把它做好。现在打开电脑连上设备HOScrcpy 已经在等你了。【免费下载链接】鸿蒙远程真机工具该工具主要提供鸿蒙系统下基于视频流的投屏功能帧率基本持平真机帧率达到远程真机的效果。项目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考