定時刷新和定點刷新

當前卡片框架提供了如下幾種按時間刷新卡片的方式：

• 定時刷新：表示在一定時間間隔內(nèi)調(diào)用onUpdateForm的生命周期回調(diào)函數(shù)自動刷新卡片內(nèi)容。可以在form_config.json配置文件的updateDuration字段中進行設置。例如，可以將刷新時間設置為每小時一次。注意：updateDuration（定時刷新）優(yōu)先級比scheduledUpdateTime（定點刷新）高，配置定時刷新后，定點刷新將失效。

  {
    "forms": [
      {
        "name": "widget",
        "description": "This is a service widget.",
        "src": "./ets/widget/pages/WidgetCard.ets",
        "uiSyntax": "arkts",
        "window": {
          "designWidth": 720,
          "autoDesignWidth": true
        },
        "colorMode": "auto",
        "isDefault": true,
        "updateEnabled": true, // 使能刷新功能
        "scheduledUpdateTime": "10:30",                               
        "updateDuration": 2, // 設置卡片定時刷新的更新周期（單位為30分鐘，取值為自然數(shù)）
        "defaultDimension": "2*2",
        "supportDimensions": ["2*2"]
      }
    ]
  }

• 定點刷新：表示每天在某個時間點刷新，在form_config.json文件中配置，詳見scheduledUpdateTime字段。例如，每天在10:30更新卡片內(nèi)容。
  說明

  當同時配置了定時刷新（updateDuration）和定點刷新（scheduledUpdateTime）時，定時刷新的優(yōu)先級更高。如果想要配置定點刷新，則需要將updateDuration配置為0。

  {
    "forms": [
      {
        "name": "widget",
        "description": "This is a service widget.",
        "src": "./ets/widget/pages/WidgetCard.ets",
        "uiSyntax": "arkts",
        "window": {
          "designWidth": 720,
          "autoDesignWidth": true
        },
        "colorMode": "auto",
        "isDefault": true,
        "updateEnabled": true, // 使能刷新功能
        "scheduledUpdateTime": "10:30", // 設置卡片的定點刷新的時刻
        "updateDuration": 0,
        "defaultDimension": "2*2",
        "supportDimensions": ["2*2"]
      }
    ]
  }

• 下次刷新：通過setFormNextRefreshTime接口指定卡片的下一次刷新時間（最短時間5分鐘），例如，在接口調(diào)用的5分鐘后刷新卡片內(nèi)容。

  import formProvider from '@ohos.app.form.formProvider';
  
  let formId = '123456789'; // 實際業(yè)務場景需要使用正確的formId
  try {
    // 設置過5分鐘后更新卡片內(nèi)容
    formProvider.setFormNextRefreshTime(formId, 5, (err, data) => {
      if (err) {
        console.error(`Failed to setFormNextRefreshTime. Code: ${err.code}, message: ${err.message}`);
        return;
      } else {
        console.info('Succeeded in setFormNextRefreshTimeing.');
      }
    });
  } catch (err) {
    console.error(`Failed to setFormNextRefreshTime. Code: ${err.code}, message: ${err.message}`);
  }

在觸發(fā)定時、定點或主動刷新后，系統(tǒng)會調(diào)用FormExtensionAbility的onUpdateForm生命周期回調(diào)，在回調(diào)中，可以使用updateForm進行提供方刷新卡片。onUpdateForm生命周期回調(diào)參考通過FormExtensionAbility刷新卡片內(nèi)容。