HarmonyOS入门之延迟任务和代理-CFANZ编程社区

在HarmonyOS应用开发中，应用即使在后台或处于低优先级状态，也能保持某些重要功能的持续运行，比如定时获取数据或发送提醒。本文将详细介绍如何使用延迟任务和代理提醒来增强应用的后台行为。

延迟任务：实现后台非实时任务

延迟任务允许应用在满足特定条件时执行非实时任务，例如在有Wi-Fi连接时下载数据。这不仅提升了用户体验，还优化了资源分配和功耗管理。

HarmonyOS入门之延迟任务和代理_延迟任务

开发步骤

实现WorkSchedulerExtensionAbility

在你的应用中，首先创建一个WorkSchedulerExtensionAbility的子类，它将处理任务的启动和停止事件。

import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility';
import workScheduler from '@ohos.resourceschedule.workScheduler';

export default class MyWorkSchedulerExtensionAbility extends WorkSchedulerExtensionAbility {
  onWorkStart(workInfo) {
    console.info('Delay task started with info:', JSON.stringify(workInfo));
    // 在这里执行你的任务逻辑
  }

  onWorkStop(workInfo) {
    console.info('Delay task stopped with info:', JSON.stringify(workInfo));
    // 清理或记录任务结束的信息
  }
}

配置WorkSchedulerExtensionAbility

在你的module.json5文件中，注册WorkSchedulerExtensionAbility。

{
  "module": {
    "extensionAbilities": [
      {
        "name": "MyWorkSchedulerExtensionAbility",
        "srcEntry": "./ets/WorkSchedulerExtension/WorkSchedulerExtension.ets",
        "type": "workScheduler"
      }
    ]
  }
}

调用延迟任务接口

在应用中，使用workScheduler模块来添加、取消和查询延迟任务。

import workScheduler from '@ohos.resourceschedule.workScheduler';

const workInfo = {
  workId: 1,
  bundleName: 'com.example.application',
  abilityName: 'MyWorkSchedulerExtensionAbility',
  networkType: workScheduler.NetworkType.NETWORK_TYPE_WIFI
};

try {
  workScheduler.startWork(workInfo);
  console.info('Delay task scheduled successfully.');
} catch (error) {
  console.error('Failed to schedule delay task:', error.message);
}

代理提醒

代理提醒确保了应用在后台或关闭时仍能向用户发送重要的提醒通知，如倒计时、日历事件和闹钟。

开发步骤

申请权限

确保你的应用具有ohos.permission.PUBLISH_AGENT_REMINDER权限。

定义提醒

定义不同类型的提醒，如倒计时、日历和闹钟。

import reminderAgentManager from '@ohos.reminderAgentManager';
import notificationManager from '@ohos.notificationManager';

const timerReminder = {
  reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_TIMER,
  triggerTimeInSeconds: 60 * 60, // 1小时后触发
  title: '倒计时提醒',
  content: '这是倒计时提醒的内容。',
  notificationId: 1,
  slotType: notificationManager.SlotType.SOCIAL_COMMUNICATION
};

发布和管理提醒

使用reminderAgentManager来发布、取消或获取有效提醒。

reminderAgentManager.publishReminder(timerReminder)
  .then((reminderId) => {
    console.log('Reminder published with ID:', reminderId);
  })
  .catch((error) => {
    console.error('Failed to publish reminder:', error.message);
  });