设备投屏
====

从26.0.0 Beta1版本开始，新增设备投屏功能，支持对已连接的设备进行投屏操作，方便查看设备屏幕内容并进行设备操控，提升开发调试效率。

#### 使用约束

*   仅支持HarmonyOS设备，并且已通过USB或Wi-Fi连接设备。
*   仅支持在中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）使用。

#### 操作步骤

1.  在DevEco Studio下方点击**Screen Mirroring，**或点击菜单栏**View > Tool Windows >** **Screen Mirroring**，打开设备投屏窗口。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/52/v3/O-qpXXEQTt69kANVRqrBXQ/zh-cn_image_0000002624994073.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=5AAA92F01410A9ACDDF94D00A735A38C71388755A1F568259DB54DCB8A7F2E15)
    
2.  从设备下拉列表中选择设备（设备需已连接），点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/eeNIB6XuRYO8Znm3FWSVWA/zh-cn_image_0000002624994075.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=3F5B37CB52E98014DD535B547085EDF2C920E08E580EDB180FF82B724BC1CAE5)按钮开始投屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/56/v3/Zs2THxnAQ3qeznrZP0bpyQ/zh-cn_image_0000002594474714.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=3CFDDED778C613C7117833D2A080F30B97C7F18C5F59479A7569959446FE661D)
    
3.  设备投屏后，支持对设备进行如下操作：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0f/v3/pelWCsfrRzWZ_ofjeDl8HQ/zh-cn_image_0000002625074217.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=9E57261F058F7D34387ED8E19D5D576B2F634420A41E2CF46FE3107C746409AA)：停止投屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/49/v3/yNTT-s28SL6SA8LqtFEOgA/zh-cn_image_0000002624994067.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=686D476BB4578C34606C7B342E980F8BB3E7F66B899E2B5206356CFFA4602ED7)：刷新重连设备。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2/v3/IwX277olSMe_DFBxmW5E0g/zh-cn_image_0000002624994069.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=BA3077C54DE768DA1C3D24222D990B0239C5F9FF456EFB01E3EC2906D0AFE85C)：对应设备返回键，返回上一屏幕或退出应用等。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bf/v3/4xCHiuW5SFWtSNDBGdUS_g/zh-cn_image_0000002594634636.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=7D47F8A0508457EB8B6AAE06E861499D5FCF3C0C7ED63A87A516751ECD629C7B)：查看最近使用的应用列表。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/87/v3/2pAwq73XRre_fTXcqdqocg/zh-cn_image_0000002624994071.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=589196EA9881E85FFF8A8D2CEB1BDFD37E5B3837014715B9DEF7388588EDD070)：对应Home键，返回主屏幕。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/BmeCba2SRoCIOnmT1Twtvg/zh-cn_image_0000002594634632.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=4C3B46A388C26F9340C16E5F4EEE3E9C793C84B67075FD9DEFEBB7DE4013C03C)：对应电源键，可以锁屏和亮屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/dvKCa4fGRBOk0qNdgEPLuQ/zh-cn_image_0000002594474712.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=E4BF572AF8B8F39A3A59E7956F8098D37FD0625B28EFDECE3B2A5AAAC1F2E245)：屏幕点击模式，默认为鼠标模式，点击按钮后切换为触摸屏模式，同时图标切换为![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/64/v3/iSCjQUs4R0m9bNBZrhkNJQ/zh-cn_image_0000002594634634.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=89A85E3BE1A2AE28FFD713169CD04E887025073504F62F7BE86E7BDEA6121D8C)。
    
4.  支持使用鼠标操控屏幕、使用键盘输入等，具体参考下文介绍。

#### 操控屏幕

支持使用鼠标来模拟手指/鼠标与设备屏幕界面进行交互的场景。

| 
常用操作

 | 

描述

 |
| :-- | :-- |
| 

单击屏幕

 | 

单击鼠标左键可以模拟点击操作，如点击应用图标等。

 |
| 

双击屏幕

 | 

双击鼠标左键可以模拟在2in1设备上的双击操作，如双击应用图标等。

 |
| 

单击/长按右键

 | 

单击/长按鼠标右键可以弹出菜单，操作方式和设备上弹出菜单的方式一致，例如设备上是通过长按弹出菜单的，在投屏中也通过长按鼠标右键弹出菜单。

 |
| 

拖动项目

 | 

长按鼠标左键可以模拟长按操作，例如长按图标进行拖动。

 |
| 

滑动屏幕

 | 

按下鼠标左键并滑动可以模拟滑动操作，鼠标模式下可用于选择文本等，触摸屏模式下可用于滚动列表、翻页等。

 |

#### 使用键盘输入

鼠标点击输入框，可以使用计算机键盘输入字符到设备上。

#### 安装应用和上传文件

通过拖拽文件可以安装应用和上传文件到设备上。

*   **安装应用：**拖拽HAP/HSP包会自动安装到设备上，支持一次性拖拽安装多个HAP/HSP包。
*   **上传文件：**支持将本地文件上传到设备中，只需将文件拖拽到屏幕即可。支持批量上传，上传的文件存放在设备的/storage/media/100/local/files/Docs/Download/目录下，同名文件会覆盖，如果文件总大小过大（10G以上）可能会上传失败。上传文件后，可以在设备的**文件管理 > 我的手机 > 下载**中查看。