问题现象
问题一:应用上滑,右上角未出现悬浮窗图标,确认应用不支持悬浮窗。
问题二:应用未适配悬浮窗,出现页面截断、图片挤压、组件堆叠等现象。
问题三:应用是横屏应用,打开了默认的竖向悬浮窗。
[h2]问题一
应用不支持悬浮窗模式。
检查应用是否支持悬浮窗模式。查看module.json5文件中abilities标签中supportWindowMode配置项,未缺省且未设置floating。
[h2]问题二
应用未适配悬浮窗模式。
- 检查是否开启窗口模式变化的监听,通过on('windowStatusChange')方法,根据窗口模式发生变化时返回值对应为WindowStatusType来判断当前界面状态,WindowStatusType=4为悬浮窗模式。
- 通过getWindowProperties方法返回的windowRect属性获取窗口尺寸,存入AppStorage。使用on('windowSizeChange')方法来监听窗口尺寸的变化。
onWindowStageCreate(windowStage: window.WindowStage): void {
console.info('Ability onWindowStageCreate.');
windowStage.getMainWindow().then((windowClass) => {
// 获取窗口尺寸,存入AppStorage
AppStorage.setOrCreate('winWidth', windowClass.getWindowProperties().windowRect.width);
AppStorage.setOrCreate('winHeight', windowClass.getWindowProperties().windowRect.height);
// 监听窗口尺寸变化
windowClass.on('windowSizeChange', (windowSize) => {
AppStorage.setOrCreate('winWidth', windowSize.width);
AppStorage.setOrCreate('winHeight', windowSize.height);
});
});
} - UI侧通过@StorageLink绑定窗口尺寸后,AppStorage中属性key值对应的数据一旦改变,UI侧会同步修改。通过@StorageLink装饰的数据在窗口尺寸发生变化时会引起组件的重新渲染,可以根据最新的窗口尺寸动态调整应用布局。
// Index.ets
@Entry
@Component
struct Index {
// 初始化参数,这里会初始化为AppStorage中存储的值
@StorageLink('winWidth') winWidth: number | undefined = AppStorage.get('winWidth');
@StorageLink('winHeight') winHeight: number | undefined = AppStorage.get('winHeight');
build() {
Row() {
// 根据winWidth、winHeight动态调整应用布局
}
.size({
width: this.getUIContext().px2vp(this.winWidth),
height: this.getUIContext().px2vp(this.winHeight)
})
}
}
[h2]问题三
应用未支持横向悬浮窗模式。搜索关键词module.json5文件中abilities标签中preferMultiWindowOrientation配置项,是否配置landscape值。
[h2]问题一
应用不支持悬浮窗模式:未在module.json5文件中abilities标签里supportWindowMode配置项中未缺省且未配置floating值。
[h2]问题二
未适配悬浮窗模式:未监听'windowStatusChange'事件或未监听'windowSizeChange'事件,并且动态调整布局。
[h2]问题三
不支持横向悬浮窗模式:未在module.json5文件中abilities标签里preferMultiWindowOrientation配置项配置landscape支持横向悬浮窗。
[h2]问题一
应用不支持悬浮窗模式:在module.json5文件中abilities标签里supportWindowMode配置项直接缺省(缺省时,缺省值为["fullscreen", "split", "floating"]),或配置时加上floating值。
[h2]问题二
未适配悬浮窗模式,监听windowStatusChange、windowSizeChange事件,需要动态调整布局。应用要保证页面布局能够完整显示,避免出现截断、挤压、堆叠等现象。
[h2]问题三
在module.json5文件中abilities标签里preferMultiWindowOrientation配置项配置支持横向悬浮窗的设置。(默认为竖向悬浮窗)可参考官方示例。