【HarmonyOS NEXT】鸿蒙应用使用后台任务之长时任务，解决屏幕录制音乐播放等操作不被挂起原创

George_wu_

发布于 2025-3-24 22:24

3072浏览

0收藏

【HarmonyOS NEXT】鸿蒙应用使用后台任务之长时任务，解决屏幕录制音乐播放等操作不被挂起

一、前言

1.后台是什么？
了解后台任务和长时任务前，我们需要先明白鸿蒙的后台特性：所谓的后台，指的是设备返回主界面、锁屏、应用切换等操作会使应用退至后台这个状态。

2.鸿蒙系统为什么这么做？
当应用退至后台后，如果继续活动，可能会造成设备耗电快、用户界面卡顿等现象。鸿蒙系统为了降低设备耗电速度、保障用户使用流畅度，系统会对退至后台的应用进行管控，包括进程挂起和进程终止。

3.会有什么问题？
当系统将应用挂起后，应用进程无法使用软件资源（如公共事件、定时器等）和硬件资源（CPU、网络、GPS、蓝牙等）。

综上所述，所以才会有标题存在的问题和对应的解决方案。
当我们应用正在使用蓝牙扫描或者音乐播放或者屏幕录制等类似的操作时，只要应用退到了后台超过三秒，就会被系统挂起，强制暂停。影响我们的逻辑业务。
所以这种情况下，鸿蒙提供了后台任务来解决。

二、后台任务是什么

后台任务是鸿蒙系统提供给有在后台，做业务操作不想被挂起需求的应用，提供的一套解决方案。

根据应用业务类型不同，也分为不同的后台任务：
【HarmonyOS NEXT】鸿蒙应用使用后台任务之长时任务，解决屏幕录制音乐播放等操作不被挂起-鸿蒙开发者社区
根据我们的常规使用场景，例如屏幕录制举例，就需要使用长时任务来解决应用被挂起的问题。

三、长时任务的使用：

1.首先我们需要根据自己的业务类型，选择对应的长时任务类型：
【HarmonyOS NEXT】鸿蒙应用使用后台任务之长时任务，解决屏幕录制音乐播放等操作不被挂起-鸿蒙开发者社区
我们以屏幕录制举例，选择AUDIO_RECORDING

2.在module.json5配置后台任务权限和长时任务能力类型：

   "abilities": [
      {
        "backgroundModes": ["audioRecording"],
		}
1.
2.
3.
4.

      // 申请长时任务
      {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "always"
        }
      },

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.

3.在录屏开启前，调用开启长时任务，退出录屏后取消长时任务。【开启和取消的两个调用时机需要注意，相当于长时任务的生命周期，是包裹住整个后台业务的生命周期。】

开启长时任务

import { backgroundTaskManager } from '@kit.BackgroundTasksKit';
import { wantAgent, WantAgent } from '@kit.AbilityKit';
  /**
   * 开启长时任务
   */
  startContinuousTask() {
    let wantAgentInfo: wantAgent.WantAgentInfo = {
      // 点击通知后，将要执行的动作列表
      // 添加需要被拉起应用的bundleName和abilityName
      wants: [
        {
          bundleName: "com.test.basedemo",
          abilityName: "EntryAbility"
        }
      ],
      // 指定点击通知栏消息后的动作是拉起ability
      actionType: wantAgent.OperationType.START_ABILITY,
      // 使用者自定义的一个私有值
      requestCode: 0,
      // 点击通知后，动作执行属性
      actionFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
    };

    try {
      // 通过wantAgent模块下getWantAgent方法获取WantAgent对象
      wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj: WantAgent) => {
          try {
            backgroundTaskManager.startBackgroundRunning(getContext(),
              backgroundTaskManager.BackgroundMode.AUDIO_RECORDING, wantAgentObj, (error: BusinessError)=>{
                if (error) {
                  console.error(this.TAG,`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
                } else {
                  console.info(this.TAG,"Operation startBackgroundRunning succeeded");
                  promptAction.showToast({
                    message: "开启长时任务成功！"
                  });
                  // // 此处执行具体的长时任务逻辑，如录音，录制等。
                  // this.startRecording();
                }
              })
          } catch (error) {
            console.error(this.TAG,`Operation startBackgroundRunning failed. code is ${(error as BusinessError).code} message is ${(error as BusinessError).message}`);
          }
      });
    } catch (error) {
      console.error(this.TAG, `Failed to Operation getWantAgent. code is ${(error as BusinessError).code} message is ${(error as BusinessError).message}`);
    }
  }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.

关闭长时任务

  /**
   * 暂停长时任务
   */
  stopContinuousTask() {
    backgroundTaskManager.stopBackgroundRunning(getContext()).then(() => {
      console.info(this.TAG, `Succeeded in operationing stopBackgroundRunning.`);
      promptAction.showToast({
        message: "取消长时任务！"
      });
    }).catch((err: BusinessError) => {
      console.error(this.TAG, `Failed to operation stopBackgroundRunning. Code is ${err.code}, message is ${err.message}`);
    });
  }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

源码示例：

【HarmonyOS NEXT】鸿蒙应用使用后台任务之长时任务，解决屏幕录制音乐播放等操作不被挂起-鸿蒙开发者社区

module.json5

   "abilities": [
      {
        "backgroundModes": ["audioRecording"],
		}
1.
2.
3.
4.

      // 申请长时任务
      {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "always"
        }
      },
      // 申请麦克风
      {
        "name": "ohos.permission.MICROPHONE",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "always"
        }
      },
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.

BackTaskTestPage.ets


import media from '@ohos.multimedia.media';
import { backgroundTaskManager } from '@kit.BackgroundTasksKit';
import { abilityAccessCtrl, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { wantAgent, WantAgent } from '@kit.AbilityKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { promptAction } from '@kit.ArkUI';

@Entry
@Component
struct BackTaskTestPage {

  private TAG: string = "BackTaskTestPage";

  // 录屏沙箱文件
  private mFile: fs.File | null = null;

  aboutToAppear(): void {
    // 为了录屏可以采集麦克风，需要申请麦克风权限
    const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    try {
      atManager.requestPermissionsFromUser(getContext(), ["ohos.permission.MICROPHONE"]).then((data) => {
        if (data.authResults[0] === 0) {

        } else {
          console.log(this.TAG, "user rejected")
        }
      }).catch((err: BusinessError) => {
        console.log(this.TAG, "BusinessError err: " + JSON.stringify(err))
      })
    } catch (err) {
      console.log(this.TAG, "catch err: " + JSON.stringify(err))
    }

    // 创建录制视频的沙箱文件地址
    let context = getContext(this) as common.UIAbilityContext; // 获取设备A的UIAbilityContext信息
    let pathDir: string = context.filesDir; // /data/storage/el2/base/haps/entry/files
    let filePath: string = pathDir + '/testBG.mp4';
    // 若文件不存在，则创建文件。
    let fileTarget = fs.openSync(filePath, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);
    console.info(this.TAG, "file done: " + JSON.stringify(fileTarget.fd));
    this.mFile = fileTarget;

  }

  /**
   * 开启长时任务
   */
  startContinuousTask() {
    let wantAgentInfo: wantAgent.WantAgentInfo = {
      // 点击通知后，将要执行的动作列表
      // 添加需要被拉起应用的bundleName和abilityName
      wants: [
        {
          bundleName: "com.test.basedemo",
          abilityName: "EntryAbility"
        }
      ],
      // 指定点击通知栏消息后的动作是拉起ability
      actionType: wantAgent.OperationType.START_ABILITY,
      // 使用者自定义的一个私有值
      requestCode: 0,
      // 点击通知后，动作执行属性
      actionFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
    };

    try {
      // 通过wantAgent模块下getWantAgent方法获取WantAgent对象
      wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj: WantAgent) => {
          try {
            backgroundTaskManager.startBackgroundRunning(getContext(),
              backgroundTaskManager.BackgroundMode.AUDIO_RECORDING, wantAgentObj, (error: BusinessError)=>{
                if (error) {
                  console.error(this.TAG,`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
                } else {
                  console.info(this.TAG,"Operation startBackgroundRunning succeeded");
                  promptAction.showToast({
                    message: "开启长时任务成功！"
                  });
                  // // 此处执行具体的长时任务逻辑，如录音，录制等。
                  // this.startRecording();
                }
              })
          } catch (error) {
            console.error(this.TAG,`Operation startBackgroundRunning failed. code is ${(error as BusinessError).code} message is ${(error as BusinessError).message}`);
          }
      });
    } catch (error) {
      console.error(this.TAG, `Failed to Operation getWantAgent. code is ${(error as BusinessError).code} message is ${(error as BusinessError).message}`);
    }
  }

  /**
   * 暂停长时任务
   */
  stopContinuousTask() {
    backgroundTaskManager.stopBackgroundRunning(getContext()).then(() => {
      console.info(this.TAG, `Succeeded in operationing stopBackgroundRunning.`);
      promptAction.showToast({
        message: "取消长时任务！"
      });
    }).catch((err: BusinessError) => {
      console.error(this.TAG, `Failed to operation stopBackgroundRunning. Code is ${err.code}, message is ${err.message}`);
    });
  }

  build() {
    Row() {
      Column() {
        Button() {
          Text('申请长时任务').fontSize(25).fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({ top: 10 })
        .backgroundColor('#0D9FFB')
        .width(250)
        .height(40)
        .onClick(() => {
          // 通过按钮申请长时任务
          this.startContinuousTask();
        })

        Button() {
          Text('取消长时任务').fontSize(25).fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({ top: 10 })
        .backgroundColor('#0D9FFB')
        .width(250)
        .height(40)
        .onClick(() => {
          // 通过按钮取消长时任务
          this.stopContinuousTask();
        })

        Button() {
          Text('开始录制').fontSize(25).fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({ top: 10 })
        .backgroundColor('#0D9FFB')
        .width(250)
        .height(40)
        .onClick(async () => {
          this.startRecording();
        })

        Button() {
          Text('暂停录制').fontSize(25).fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({ top: 10 })
        .backgroundColor('#0D9FFB')
        .width(250)
        .height(40)
        .onClick(() => {
          this.stopRecording();
        })
      }
      .width('100%')
    }
    .height('100%')
  }

  private screenCapture?: media.AVScreenCaptureRecorder;

  // 调用startRecording方法可以开始一次录屏存文件的流程，结束录屏可以通过点击录屏胶囊停止按钮进行操作。
  public async startRecording() {
    this.screenCapture = await media.createAVScreenCaptureRecorder();
    console.info(this.TAG,"startRecording screenCapture on done" );
    try {
      let avCaptureConfig: media.AVScreenCaptureRecordConfig = {
        fd: this.mFile?.fd ?? 0, // 文件需要先有调用者创建，赋予写权限，将文件fd传给此参数
      }
      await this.screenCapture?.init(avCaptureConfig); // avCaptureConfig captureConfig
      console.info(this.TAG,"startRecording screenCapture init done" );
    } catch (err) {
      console.info(this.TAG,"startRecording init err: " + JSON.stringify(err) );
    }
    await this.screenCapture?.startRecording();
    console.info(this.TAG,"startRecording screenCapture startRecording" );
  }

  // 可以主动调用stopRecording方法来停止录屏。
  public async stopRecording() {
    if (this.screenCapture == undefined) {
      // Error
      return;
    }
    await this.screenCapture?.stopRecording();

    // 调用release()方法销毁实例，释放资源。
    await this.screenCapture?.release();

    // 最后需要关闭创建的录屏文件fd, fs.close(fd);
    fs.closeSync(this.mFile);
  }
}


1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
120.
121.
122.
123.
124.
125.
126.
127.
128.
129.
130.
131.
132.
133.
134.
135.
136.
137.
138.
139.
140.
141.
142.
143.
144.
145.
146.
147.
148.
149.
150.
151.
152.
153.
154.
155.
156.
157.
158.
159.
160.
161.
162.
163.
164.
165.
166.
167.
168.
169.
170.
171.
172.
173.
174.
175.
176.
177.
178.
179.
180.
181.
182.
183.
184.
185.
186.
187.
188.
189.
190.
191.
192.
193.
194.
195.
196.
197.
198.
199.
200.
201.