[文章]鸿蒙应用/元服务开发-窗口（Stage模型）体验窗口沉浸式能力

一、体验窗口沉浸式能力说明
在看视频、玩游戏等场景下，用户往往希望隐藏状态栏、导航栏等不必要的系统窗口，从而获得更佳的沉浸式体验。此时可以借助窗口沉浸式能力（窗口沉浸式能力都是针对应用主窗口而言的），达到预期效果。
二、开发步骤
1.获取应用主窗口。
通过getMainWindow接口获取应用主窗口。

2.实现沉浸式效果。
调用setWindowSystemBarEnable接口，设置导航栏、状态栏不显示，从而达到沉浸式效果。

3.加载显示沉浸式窗口的具体内容。
通过loadContent接口加载沉浸式窗口的具体内容。

import UIAbility from '@ohos.app.ability.UIAbility';

 

export default class EntryAbility extends UIAbility {

    onWindowStageCreate(windowStage) {

        // 1.获取应用主窗口。

        let windowClass = null;

        windowStage.getMainWindow((err, data) => {

            if (err.code) {

                console.error('Failed to obtain the main window. Cause: ' + JSON.stringify(err));

                return;

            }

            windowClass = data;

            console.info('Succeeded in obtaining the main window. Data: ' + JSON.stringify(data));

 

            // 2.实现沉浸式效果：设置导航栏、状态栏不显示。

            let names = [];

            windowClass.setWindowSystemBarEnable(names, (err) => {

                if (err.code) {

                    console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));

                    return;

                }

                console.info('Succeeded in setting the system bar to be visible.');

            });

        })

        // 3.为沉浸式窗口加载对应的目标页面。

        windowStage.loadContent("pages/page2", (err) => {

            if (err.code) {

                console.error('Failed to load the content. Cause:' + JSON.stringify(err));

                return;

            }

            console.info('Succeeded in loading the content.');

        });

    }

};

本文主要参考HarmonyOS4.0官方开发文档整理