录屏
==

在应用开发过程中，可以使用录屏功能录制应用的运行状态，并通过录屏文件向他人展示正在开发的应用的各种功能效果。

#### 使用约束

*   如果设置了锁屏密码，录屏开始前请解锁设备屏幕，锁屏状态下录屏应用无法正常拉起。
*   如果设置了锁屏密码，录屏时请保持设备的屏幕解锁状态，若录屏过程中锁屏将导致录屏应用退出。
*   模拟器不支持录屏。

#### 通过DevEco Studio录屏

1.  连接真机设备，并在其中运行应用。
2.  在DevEco Studio底部切换到**Log**页签。
3.  点击左侧工具栏中![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/Wci6Uf3cRhaUJq1-dOtjPw/zh-cn_image_0000002594635114.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=49A789339458FEC524D48F3494FBEC134C85E6A0E9B2D7B141E6735DC08653BA "点击放大")，即可开始录屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/GARpvyDSRp2MdvokcFK74w/zh-cn_image_0000002594635116.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=F958659D84268EBCF56607F3A480E7A24F1C033D0BF01DE6C88032F9424356A9)
    
4.  录屏时，需要先选择录屏文件的保存路径，开发者可使用默认路径或[设置自定义路径](#section89111791511)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1a/v3/Xkpm3ioTQgWOxPiKBG_tZg/zh-cn_image_0000002594475192.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=C43D86BB24EAC34D308CB5EB954811F055D9B9F575566FE2B17A0C9E7B39F85F)
    
5.  路径选择完毕后，点击**Start Recording**开始录屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8f/v3/oZIWPf64T5W5zkLvbMZ_IA/zh-cn_image_0000002625074693.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=26C373FDC59D9420A153198F4161FA9B9B3985D3BDF3D6A8AA1EF0EA9334132F "点击放大")
    
6.  录制完操作流程之后，点击**Stop Recording**结束录屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/84/v3/VNx_rD1uRGKzKozD4Yi_OQ/zh-cn_image_0000002594635118.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=04FC5C11E7B390D77C1D6A7974F3B04EA47FC0A36685DA2B3BDB4672F1BCB42D "点击放大")
    
7.  结束录屏后，录屏文件将会保存到之前选择的路径下，可以选择调用系统播放器播放视频文件或打开文件所在的文件夹。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b2/v3/Qta5N3DSQ1SrT0leBILA0g/zh-cn_image_0000002624994547.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=9D3762CD38ED6CDDEBF97EA173AE2FB21B1C9FCCBABE82BA091BF665F9518A91 "点击放大")
    

#### 设置录屏自定义路径

1.  点击DevEco Studio底部**Log**页签，选择**HiLog >** **Settings** **>** **Record Screen**选项。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7d/v3/8Oc0s0uOTna4jswZ8qlD9Q/zh-cn_image_0000002625074699.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=56E30D949BC384DD4E11CDBEAF478AB36F298542275AF98CAC80F11AF7980152)
    
2.  在弹出的界面选择自定义路径，当设置好路径并勾选“Use the selected path and auto-generated file name as defaults and don't ask again”选项后，录屏时将自动使用此时设置的路径以及以录屏时的时间戳构造的文件名作为录屏文件的保存地址及文件名。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/13/v3/l8dA_IhHRQWe6M5kHU0WUg/zh-cn_image_0000002594635122.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=B6FAE16D78DEBDD888EBFA52DDC7C36F13309A16F579476F0EC95C72C9C8B20C)
    

#### 通过命令行方式录屏

hdc是可以用于调试的命令行工具，通过该工具可以实现录屏功能。更多关于命令行工具hdc的说明请参见[hdc工具使用指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc)。

1.  启动录屏。
    
    hdc shell aa start -b com.huawei.hmos.screenrecorder -a com.huawei.hmos.screenrecorder.ServiceExtAbility --ps "CustomizedFileName" "test.mp4"   // 指定录屏文件名称为test.mp4
    
2.  停止录屏。
    
    hdc shell aa start -b com.huawei.hmos.screenrecorder -a com.huawei.hmos.screenrecorder.ServiceExtAbility
    
3.  获取录屏文件位置，记录为{RecordFile}。
    
    hdc shell mediatool query test.mp4 -u
    
    *   如果查询的结果中包含uri字段，则返回值第三行对应的录屏文件路径不允许直接下载。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/76/v3/es0Ukpf8Rr6PGPCVGq89FQ/zh-cn_image_0000002624994559.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=86D667E044A2BDE852E1294553049C4DCFB389814B5E959A257DBDFAFB2352EB)
        
        需要再执行如下命令，指定该uri，将录屏文件复制到有下载权限的路径中（如/data/local/tmp）。
        
        hdc shell mediatool recv "file://media/Photo/2/VID\_1736853237\_001/test.mp4" /data/local/tmp
        
        命令返回值第二行即为录屏文件路径{RecordFile}。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/eCbwbNQPTpuRJk3xzRK7Sw/zh-cn_image_0000002594475196.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=59092393C3E47804B300C9078D9DB30A191ED7442B1B5B56F0B1A65CD9B14B65)
        
    
    *   如果查询结果不包含uri字段，则返回值第二行即为录屏文件路径{RecordFile}。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e2/v3/rd_tevqERjS8C7vpV300cQ/zh-cn_image_0000002594475198.png?HW-CC-KV=V1&HW-CC-Date=20260612T073901Z&HW-CC-Expire=86400&HW-CC-Sign=14318F7171381E4B8A2A9952897F5EAA1CFE4499AD8A658E5C7C2FFB6105306F)
        
    
4.  指定上一个步骤中获取到的录屏文件路径{RecordFile}，下载录屏文件到本地。
    
    hdc file recv {RecordFile} d:\\test.mp4