Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
35442cc4
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
35442cc4
编写于
4月 13, 2023
作者:
O
openharmony_ci
提交者:
Gitee
4月 13, 2023
浏览文件
操作
浏览文件
下载
差异文件
!17119 【轻量级 PR】:update zh-cn/application-dev/application-models/arkts-ui-widget-update-by-time.md.
Merge pull request !17119 from zyjhandsome/N/A
上级
8b527174
bdec8cdc
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
18 addition
and
11 deletion
+18
-11
zh-cn/application-dev/application-models/arkts-ui-widget-update-by-time.md
...-dev/application-models/arkts-ui-widget-update-by-time.md
+18
-11
未找到文件。
zh-cn/application-dev/application-models/arkts-ui-widget-update-by-time.md
浏览文件 @
35442cc4
# 定时刷新和定点刷新
在使用定时和定点刷新功能之前,需要在form_config.json配置文件中设置
`updateEnabled`
字段为
`true`
,以启用周期性刷新功能。
当前卡片框架提供了如下几种按时间刷新卡片的方式:
-
定时刷新:表示每隔一段时间刷新卡片内容,在form_config.json文件中配置,详见
[
updateDuration
](
arkts-ui-widget-configuration.md
)
字段。例如,每小时刷新一次卡片内容。注意:updateDuration(定时刷新)优先级比scheduledUpdateTime(定点刷新)高,配置定时刷新后,定点刷新将失效。
-
定时刷新:表示在一定时间间隔内自动刷新卡片内容。可以在form_config.json配置文件的
[
updateDuration
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每小时一次。
> **说明:**
>
> 当配置了updateDuration(定时刷新)后,该设置会优先于scheduledUpdateTime(定点刷新)生效,即使同时配置了两者,定点刷新也会被忽略。
```
json
{
...
...
@@ -29,11 +34,13 @@
]
}
```
-
定点刷新:表示每天在某个时间点刷新,在form_config.json文件中配置,详见
[
scheduledUpdateTime
](
arkts-ui-widget-configuration.md
)
字段。例如,每天在10:30更新卡片内容。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 当同时配置了定时刷新(updateDuration)和定点刷新(scheduledUpdateTime)时,定时刷新的优先级更高。如果想要配置定点刷新,则需要将updateDuration配置为0。
-
定点刷新:表示在每天的某个特定时间点自动刷新卡片内容。可以在form_config.jso配置文件中的
[
scheduledUpdateTime
](
arkts-ui-widget-configuration.md
)
字段中进行设置。例如,可以将刷新时间设置为每天的上午10点30分。
> **说明:**
>
> 当同时配置了定时刷新(updateDuration)和定点刷新(scheduledUpdateTime)时,定时刷新的优先级更高。如果想要配置定点刷新,则需要将updateDuration配置为0。
```
json
{
...
...
@@ -58,8 +65,8 @@
]
}
```
-
下次刷新:
通过
[
setFormNextRefreshTime
](
../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime
)
接口指定卡片的下一次刷新时间(最短时间5分钟),例如,在接口调用的5分钟后
刷新卡片内容。
-
下次刷新:
表示指定卡片的下一次刷新时间。可以通过调用
[
`setFormNextRefreshTime()`
](
../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime
)
接口来实现。最短刷新时间为5分钟。例如,可以在接口调用后的5分钟内
刷新卡片内容。
```
ts
import
formProvider
from
'
@ohos.app.form.formProvider
'
;
...
...
@@ -81,12 +88,12 @@
```
在触发定时、定点或主动刷新后,系统会调用FormExtensionAbility的
[
onUpdateForm
](
../reference/apis/js-apis-app-form-formExtensionAbility.md#onupdateform
)
生命周期回调,在回调中,可以使用
[
updateForm
](
../reference/apis/js-apis-app-form-formProvider.md#updateform
)
进行提供方刷新卡片。onUpdateForm
生命周期回调参考
[
通过FormExtensionAbility刷新卡片内容
](
arkts-ui-widget-event-formextensionability.md
)
。
在触发定时、定点或主动刷新后,系统会调用FormExtensionAbility的
[
onUpdateForm
()
](
../reference/apis/js-apis-app-form-formExtensionAbility.md#onupdateform
)
生命周期回调,在回调中,可以使用
[
updateForm()
](
../reference/apis/js-apis-app-form-formProvider.md#updateform
)
进行提供方刷新卡片。onUpdateForm()
生命周期回调参考
[
通过FormExtensionAbility刷新卡片内容
](
arkts-ui-widget-event-formextensionability.md
)
。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 1. 定时刷新有配额限制,每张卡片每天最多通过定时方式触发刷新50次,定时刷新包含[卡片配置项updateDuration](arkts-ui-widget-configuration.md)和调用[setFormNextRefreshTime
](../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime)两种
,当达到50次配额后,无法通过定时方式再次触发刷新,刷新次数会在每天的0点重置。
> 1. 定时刷新有配额限制,每张卡片每天最多通过定时方式触发刷新50次,定时刷新包含[卡片配置项updateDuration](arkts-ui-widget-configuration.md)和调用[setFormNextRefreshTime
()](../reference/apis/js-apis-app-form-formProvider.md#setformnextrefreshtime)方法两种方式
,当达到50次配额后,无法通过定时方式再次触发刷新,刷新次数会在每天的0点重置。
>
> 2. 当前定时刷新使用同一个计时器进行计时,因此卡片定时刷新的第一次刷新会有最多30分钟的偏差。比如第一张卡片A
(每隔半小时刷新一次)在3点20分添加成功,定时器启动并每隔半小时触发一次事件,第二张卡片B(每隔半小时刷新一次)在3点40分添加成功,在3点50分定时器事件触发时,卡片A触发定时刷新,卡片B会在下次事件(4点20分)
中才会触发。
> 2. 当前定时刷新使用同一个计时器进行计时,因此卡片定时刷新的第一次刷新会有最多30分钟的偏差。比如第一张卡片A
(每隔半小时刷新一次)在3点20分添加成功,定时器启动并每隔半小时触发一次事件,第二张卡片B(每隔半小时刷新一次)在3点40分添加成功,在3点50分定时器事件触发时,卡片A触发定时刷新,卡片B会在下次事件(4点20分)
中才会触发。
>
> 3. 定时刷新和定点刷新仅在屏幕亮屏情况下才会触发,在灭屏场景下仅会将记录刷新动作,待亮屏时统一进行刷新。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录