HarmonyOS鸿蒙Next中Stage模型中Ability与UIWindow的生命周期如何精确控制？

在Stage模型中，UIWindow的生命周期不完全依赖其创建者Ability。窗口的显示受系统窗口管理策略（如锁屏、最近任务清理）影响。关键在于为窗口申请正确的权限，并在Ability生命周期中妥善管理窗口状态。

// 1. 在Service Ability中创建和管理窗口
export default class FloatingService extends Ability {
  private windowStage: window.WindowStage | null = null;
  private windowClass: window.Window | null = null;
  onWindowStageCreate(windowStage: window.WindowStage): void {
    this.windowStage = windowStage;
    // 2. 申请悬浮窗权限 (必须在ability配置文件声明 ohos.permission.SYSTEM_FLOAT_WINDOW)
    let context = this.context;
    let permissions: Array<string> = ['ohos.permission.SYSTEM_FLOAT_WINDOW'];
    context.requestPermissionsFromUser(permissions, (result) => {
      if (result.granted.indexOf(permissions[0]) !== -1) {
        this.createFloatingWindow();
      }
    });
  }
  private async createFloatingWindow(): Promise<void> {
    // 3. 获取窗口管理器并创建窗口
    let windowClass = null;
    try {
      let windowManager = window.getWindowManager();
      // 配置窗口类型为悬浮窗
      let config: window.Configuration = {
        name: "float_window",
        windowType: window.WindowType.TYPE_FLOAT,
        ctx: this.context,
        displayId: 0 // 主屏幕
      };
      windowClass = await windowManager.createWindow(config);
      this.windowClass = windowClass;
      // 4. 设置窗口属性：大小、位置、焦点等
      windowClass.moveTo(300, 500).then(() => {});
      windowClass.resize(100, 100).then(() => {});
      windowClass.setFocusable(false); // 悬浮球通常不获取焦点，避免影响底层应用
      // 5. 最关键：注册窗口生命周期回调
      windowClass.on('windowStageEvent', (event) => {
        switch(event) {
          case window.WindowStageEvent.SHOWN: // 窗口显示
            console.info('Floating window shown');
            break;
          case window.WindowStageEvent.HIDDEN: // 窗口被系统隐藏（如锁屏）
            // 此处不自动销毁窗口，等待系统或Ability唤醒
            console.info('Floating window hidden by system');
            break;
          case window.WindowStageEvent.ACTIVE: // 窗口激活
            break;
        }
      });
      // 6. 为窗口加载UI
      let loadContent = this.windowStage?.loadContent('pages/FloatBall', (err) => {});
      windowClass.showWindow(); // 显示窗口
    } catch (error) {
      console.error(`Failed to create floating window. Code: ${error.code}, message: ${error.message}`);
    }
  }
  // 7. 在Service Ability的onBackground中，根据业务决定是否隐藏窗口（而非销毁）
  onBackground(): void {
    // 如果是省电模式或用户设置，可以隐藏
    // this.windowClass?.hideWindow();
    // 否则保持显示，由系统管理
    console.info('Service entered background, window state is managed by system.');
  }
  onWindowStageDestroy(): void {
    // 8. 仅在明确需要时（如服务停止）才销毁窗口
    if (this.windowClass) {
      this.windowClass.destroyWindow();
      this.windowClass = null;
    }
    this.windowStage = null;
  }
}