HarmonyOS鸿蒙Next中如何监听应用前后台切换？

**详细回答：**重写 UIAbility 的 onForeground/onBackground 生命周期。

✅ 正确做法

// EntryAbility.ts
export default class EntryAbility extends UIAbility {
 onForeground() {
   // 通知页面恢复播放
   AppStorage.SetOrCreate('appState', 'foreground');
 }

 onBackground() {
   // 通知页面暂停播放
    AppStorage.SetOrCreate('appState', 'background');
  }
}

自定义VideoPlayer.ets

import { StandardTitleBar } from '../components/StandardTitleBar';

/**
 * @author J.query
 * @date 2025/12/24 8:43
 * @email j-query@foxmail.com
 Description:
 */

@Entry
@Component
struct VideoPlayer {
  @State [@Watch](/user/Watch)('onAppStateChange')
  appState: string = AppStorage.Get<string>('appState') || 'foreground';

  private controller: VideoController = new VideoController();
  private videoSrc: string = ''; // 初始化为空字符串，稍后设置为网络视频或应用沙箱路径
  private previewUri: string = ''; // 初始化为空字符串
  private isPlaying: boolean = false;
  private currentTime: number = 0;
  private duration: number = 0;
  private volume: number = 0.8;
  private isMute: boolean = false;
  private speedOptions: string[] = ['0.75x', '1.0x', '1.25x', '1.5x', '2.0x'];

  aboutToAppear() {
    // 页面即将出现时的初始化
    this.isPlaying = false;
    // 设置默认视频源，可以是网络视频或应用沙箱路径
    this.videoSrc = 'https://example.com/sample.mp4'; // 示例网络视频，实际使用时替换为真实URL
  }

  resumeVideo() {
    if (this.controller) {
      this.controller.start();
      this.isPlaying = true;
    }
  }

  pauseVideo() {
    if (this.controller) {
      this.controller.pause();
      this.isPlaying = false;
    }
  }

  build() {
    Column() {
      // 标题栏
      StandardTitleBar({
        title: '视频播放器',
        showBack: true
      })

      // 视频播放区域
      Column() {
        // 视频组件
        Video({
          src: this.videoSrc,
          previewUri: this.previewUri,
          controller: this.controller
        })
        .width('100%')
        .height(300)
        .autoPlay(false)
        .controls(true) // 显示默认控制栏
        .onPrepared((preparedInfo: PreparedInfo) => {
          this.duration = preparedInfo.duration;
        })
        .onUpdate((playbackInfo: PlaybackInfo) => {
          this.currentTime = playbackInfo.time;
        })
        .onFinish(() => {
          this.isPlaying = false;
        })
        .onError(() => {
          console.error('视频播放出错');
        })
      }
      .width('100%')
      .padding({ top: 10, bottom: 10 })
      .backgroundColor('#000000')

      // 控制面板
      Column() {
        // 播放/暂停按钮
        Row() {
          Button(this.isPlaying ? '⏸️ 暂停' : '▶️ 播放')
            .width('40%')
            .height(50)
            .backgroundColor('#45B7D1')
            .fontColor('#FFFFFF')
            .borderRadius(8)
            .onClick(() => {
              if (this.isPlaying) {
                this.pauseVideo();
              } else {
                this.resumeVideo();
              }
            })

          // 停止按钮
          Button('⏹️ 停止')
            .width('40%')
            .height(50)
            .backgroundColor('#FF6B6B')
            .fontColor('#FFFFFF')
            .borderRadius(8)
            .margin({ left: '5%' })
            .onClick(() => {
              if (this.controller) {
                this.controller.stop();
                this.isPlaying = false;
              }
            })
        }
        .width('100%')
        .margin({ bottom: 15 })

        // 进度条
        Column() {
          Text(`${this.formatTime(this.currentTime)} / ${this.formatTime(this.duration)}`)
            .fontSize(12)
            .fontColor('#666666')
            .width('100%')
            .textAlign(TextAlign.Start)

          Slider({
            value: this.currentTime,
            min: 0,
            max: this.duration > 0 ? this.duration : 100,
            step: 1
          })
          .width('100%')
          .showSteps(false)
          .onChange((value: number) => {
            this.currentTime = value;
            if (this.controller) {
              this.controller.setCurrentTime(value);
            }
          })
        }
        .width('100%')
        .margin({ bottom: 15 })

        // 音量控制
        Row() {
          Text('🔈')
            .fontSize(20)
            .width('10%')

          Slider({
            value: this.isMute ? 0 : this.volume * 100,
            min: 0,
            max: 100,
            step: 1
          })
          .width('80%')
          .showSteps(false)
          .onChange((value: number) => {
            this.volume = value / 100;
            this.isMute = (value === 0);
            // HarmonyOS VideoController 没有直接的 volume 属性
            // 可以通过其他方式实现音量控制，这里暂时保留变量
          })

          Text(this.isMute ? '🔇' : '🔊')
            .fontSize(20)
            .width('10%')
            .textAlign(TextAlign.Center)
        }
        .width('100%')
        .margin({ bottom: 15 })

        // 倍速播放
        Row() {
          Text('播放倍速:')
            .fontSize(14)
            .width('30%')
            .textAlign(TextAlign.Start)

          Row() {
            ForEach(this.speedOptions, (speed: string) => {
              Button(speed)
                .width(60)
                .height(35)
                .backgroundColor(this.getCurrentSpeed() === parseFloat(speed) ? '#45B7D1' : '#F0F0F0')
                .fontColor(this.getCurrentSpeed() === parseFloat(speed) ? '#FFFFFF' : '#333333')
                .borderRadius(6)
                .fontSize(12)
                .margin({ right: 10 })
                .onClick(() => {
                  this.setPlaybackSpeed(parseFloat(speed));
                })
            })
          }
          .width('70%')
          .justifyContent(FlexAlign.Start)
        }
        .width('100%')
      }
      .width('100%')
      .padding({ left: 20, right: 20 })
      .layoutWeight(1)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F5F5F5')
  }

  // 格式化时间显示 (毫秒转换为 mm:ss)
  formatTime(time: number): string {
    const totalSeconds = Math.floor(time / 1000);
    const minutes = Math.floor(totalSeconds / 60);
    const seconds = totalSeconds % 60;
    return `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`;
  }

  // 获取当前播放倍速
  getCurrentSpeed(): number {
    // 这里需要根据实际控制器状态获取当前播放速度
    return 1.0; // 默认值，实际实现中需要从控制器获取
  }

  // 设置播放倍速
  setPlaybackSpeed(speed: number) {
    if (this.controller) {
    }
  }

  onAppStateChange(changedPropertyName: string) {
    if (this.appState === 'background') {
      this.pauseVideo();
    } else {
      this.resumeVideo();
    }
  }
}

⚠️ 避坑指南

📡 onBackground 中不能执行耗时操作（系统 10 秒内杀进程）。

🔄 页面需用 @Watch 监听 AppStorage 变化。

🎵 后台播放音频需申请 ohos.permission.RUNNING_LOCK。

🎯 效果

应用切后台自动暂停视频，切回前台无缝续播，符合用户预期。

在HarmonyOS Next中，监听应用前后台切换可使用UIAbility的onWindowStageCreate和onWindowStageDestroy生命周期回调。
应用进入前台时触发onWindowStageCreate，进入后台时触发onWindowStageDestroy。
也可通过@State装饰器结合AppStorage中的AppState来管理应用状态。
具体实现需在UIAbility文件中定义这些回调方法。