定時(shí)刷新和定點(diǎn)刷新

當(dāng)前卡片框架提供了如下幾種按時(shí)間刷新卡片的方式：

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

  {
    "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, // 設(shè)置卡片定時(shí)刷新的更新周期（單位為30分鐘，取值為自然數(shù)）
        "defaultDimension": "2*2",
        "supportDimensions": ["2*2"]
      }
    ]
  }

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

  當(dāng)同時(shí)配置了定時(shí)刷新（updateDuration）和定點(diǎn)刷新（scheduledUpdateTime）時(shí)，定時(shí)刷新的優(yōu)先級(jí)更高。如果想要配置定點(diǎn)刷新，則需要將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", // 設(shè)置卡片的定點(diǎn)刷新的時(shí)刻
        "updateDuration": 0,
        "defaultDimension": "2*2",
        "supportDimensions": ["2*2"]
      }
    ]
  }

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

  import formProvider from '@ohos.app.form.formProvider';
  
  let formId = '123456789'; // 實(shí)際業(yè)務(wù)場(chǎng)景需要使用正確的formId
  try {
    // 設(shè)置過(guò)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ā)定時(shí)、定點(diǎn)或主動(dòng)刷新后，系統(tǒng)會(huì)調(diào)用FormExtensionAbility的onUpdateForm生命周期回調(diào)，在回調(diào)中，可以使用updateForm進(jìn)行提供方刷新卡片。onUpdateForm生命周期回調(diào)參考通過(guò)FormExtensionAbility刷新卡片內(nèi)容。