窗口

介绍

本示例主要展示了在子窗口中以悬浮窗模式拉起悬浮应用，并对新的应用设置窗口缩放比例，窗口以设置的比例进行缩放，并在界面显示窗口当前的宽度和高度。

本实例使用@ohos.window

效果预览

本示例拉起悬浮应用并设置窗口比例，按照设置的窗口比例缩放窗口并监听窗口大小。效果图如下：

拉起悬浮应用	设置窗口比例	监听窗口大小

使用说明

1.安装WindowRatio工程hap包(即本示例)和WindowManage工程hap包

2.打开WindowManage应用sample，点击窗口预览进入视频播放页面，点击主窗口后拉起子窗口。

2.点击拉起悬浮应用按钮后，将以悬浮窗模式拉起应用WindowRatio 。

3.点击悬浮应用中的下拉框，选择窗口缩放比例，点击确定按钮，以新的宽度/比例计算得到窗口宽高，监听到窗口缩放比例发生变化，窗口以设置的比例改变大小，窗口监听到大小发生变化，在页面上显示当前窗口的宽度和高度。另外，窗口不具备记忆之前位置大小的能力，当前sample所调用的接口展示结果不居中，若要使得窗口居中，则需调用resize接口指定成想要的大小。

工程目录

entry/src/main/ets/
|---Application
|---MainAbility
|   |---MainAbility.ts                     // 设置窗口模式，监听窗口大小等窗口管理的文件
|---pages
|   |---index.ets                          // 首页，设置

具体实现

• 设置窗口缩放比例的功能接口封装在Index，源码参考：Index
  • 使用windows.setAspectRatio来设置窗口缩放比例;
• 设置以悬浮窗模式显示窗口和设置监听窗口大小接口的功能封装在MainAbility，源码参考：MainAbility
  • 使用windows.setWindowMode来设置窗口为悬浮窗模式;
  • 使用windows.on('windowSizeChange', (data))来监听窗口大小信息；

相关权限

本示例需要在module.json5中配置如下权限:

允许应用使用悬浮窗的能力：ohos.permission.SYSTEM_FLOAT_WINDOW

此外，因为本示例使用了系统能力的接口，还需在SDK/10/toolchains/lib目录下的UnsgnedReleasedProfileTemplate.json中修改以下配置权限：

"bundle-info":{
  ...
  "apl":"system_core",
  "app-feature":"ohos_system_app"
}

依赖

本示例需要依赖WindowManage sample，WindowManage sample会在子窗口中拉起本应用，然后在本应用中设置窗口缩放比例并监听本应用的窗口大小。

约束与限制

1.本示例仅支持在标准系统上运行，仅支持设备：RK3568。

2.本示例为Stage模型，仅支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0Release)；本示例涉及使用系统接口：@ohos.window中的WindowMode属性，需要手动替换Full SDK才能编译通过，具体操作可参考替换指南。

3.本示例所配置的权限ohos.permission.SYSTEM_FLOAT_WINDOW为system_basic级别(相关权限级别可通过权限定义列表查看)，需要手动配置对应级别的权限签名(具体操作可查看自动化签名方案)。

4.本示例需要使用DevEco Studio 版本号(4.0Release)及以上版本才可编译运行。

下载

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

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