截屏（仅对系统应用开放）

介绍

本示例展示全屏截图和屏幕局部截图。

本示例通过screenshot模块实现屏幕截图 ，通过window模块实现隐私窗口切换，通过display模块查询当前隐私窗口。

效果预览

全屏截图	局部截图选择区域	局部截图

使用说明：

1. 点击右上角图标打开弹窗，选择截屏，展示全屏截图；选择局部截屏，选择截屏区域，点击右下角完成，展示局部截屏；
2. 点击滑块切换窗口隐私模式，隐私模式下截屏会弹出提示，拒绝截屏。

工程目录

entry/src/main/ets/
|---Application
|   |---MyAbilityStage.ets                    
|---MainAbility
|   |---MainAbility.ets
|---pages
|   |---Index.ets                      // 首页

具体实现

• 本示例通过screenshot接口实现屏幕截图 ，通过window接口实现隐私窗口切换，通过display接口查询当前隐私窗口。
• 源码链接：Screenshot.ets，WindowPrivacy.ets
• 接口参考：@ohos.screenshot，@ohos.window，@ohos.display

相关权限

获取屏幕截图权限：ohos.permission.CAPTURE_SCREEN

依赖

不涉及。

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：RK3568；
2. 本示例已适配 API version 9 版本 SDK，本示例涉及使用系统接口：@ohos.screenshot，需要手动替换 Full SDK 才能编译通过，具体操作可以参考替换指南 ；
3. 本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)及以上版本才可编译运行；
4. 本示例所配置的权限 ohos.permission.CAPTURE_SCREEN 为 system_core 级别( 相关权限级别可通过权限定义列表查看)，需要手动配置对应级别的权限签名(具体操作可查看自动化签名方案)；
5. 本示例需要设置为系统应用才可使用接口 hasPrivacyWindow 判断隐私窗口,签名文件中修改 app-feature 为 hos_system_app。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/SystemFeature/Media/Screenshot/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master