【HarmonyOS】元服务卡片展示动态数据,并定点更新卡片数据

发布时间 2023-10-25 14:38:35作者: Mayism123

 【关键字】

元服务卡片、卡片展示动态数据、更新卡片数据

 

【写在前面】

本篇文章主要介绍开发元服务卡片时,如何实现卡片中动态显示数据功能,并实现定时数据刷新。本篇文章通过实现定时刷新卡片中日期数据为例,讲述展示动态数据与更新数据功能。

 

【开发步骤】

1、在卡片的index.html页面中定义动态数据,并在index.json中定义变量,此处以curDate为例,定义默认值1990-01-01。

cke_948.png

cke_1349.png

2、在卡片第一次添加时,需要curDate显示当前日期,需要在MainAbility.java的onCreateForm中进行数据传递。通过查看onCreateForm中默认代码发现,最终会走到formController.bindFormData方法中,即对应WidgetImpl.java文件的bindFormData方法,此处可以通过两种方式修改代码传递数据:

1)更改WidgetImpl.java文件的bindFormData方法内容;

2)更改MainAbility.java文件的onCreateForm方法内容,不返回formController.bindFormData(formId);,直接构造ProviderFormInfo数据返回;

上述两种方式,都需要构造FormBindingData数据,通过providerFormInfo.setJsBindingData(formBindingData)设置卡片数据。此处以第一种方式为例,添加如下代码,卡片添加时会默认显示当前日期。

@Override
    public ProviderFormInfo bindFormData(long formId) {
        HiLog.info(TAG, "bindFormData start");
        // 获取当前日期,此处也可修改为通过http接口动态获取数据
        Date date = new Date();
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
        String curDateStr = simpleDateFormat.format(date);

        // 将需要刷新的数据通过ZSONObject放入formBindingData中
        ZSONObject object = new ZSONObject();
        object.put("curDate", curDateStr);
        FormBindingData formBindingData = new FormBindingData(object);
        HiLog.info(TAG, "formBindingData: " + ZSONObject.toZSONString(formBindingData));

        // onCreateForm方法会返回providerFormInfo,所以通过providerFormInfo.setJsBindingData刷新卡片数据
        ProviderFormInfo providerFormInfo = new ProviderFormInfo();
        providerFormInfo.setJsBindingData(formBindingData);
        return providerFormInfo;
    }

3、接下来需实现更新curDate数据功能。若卡片已经添加,如何实现定时更新卡片数据。此时需先了解卡片更新机制,参考此文档“配置卡片配置文件”了解卡片的定时刷新updateDuration和定点刷新scheduledUpdateTime机制,本篇文章便于调试,采用定点刷新机制进行卡片数据刷新。

了解刷新机制后,通过配置触发卡片数据刷新,代码会走到MainAbility.java的onUpdateForm方法中,通过构造FormBindingData数据通过updateForm方法实现数据刷新,代码如下所示:

@Override
    protected void onUpdateForm(long formId) {
        HiLog.info(TAG, "onUpdateForm");
        super.onUpdateForm(formId);

        // 获取当前日期
        Date date = new Date();
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
        String curDateStr = simpleDateFormat.format(date);

        // 将需要刷新的数据通过ZSONObject放入formBindingData中
        ZSONObject object = new ZSONObject();
        object.put("curDate", "2024-01-01"); // 此处为了调试,将更新的数据设置为定值,可在此处修改为从http接口获取的结果进行数据更新
        FormBindingData formBindingData = new FormBindingData(object);
        HiLog.info(TAG, "formBindingData: " + ZSONObject.toZSONString(formBindingData));

        // 更新卡片onUpdateForm方法无返回值,所以通过updateForm设置数据
        try {
            boolean isUpdate = updateForm(formId, formBindingData);
            HiLog.info(TAG, "onUpdateForm isUpdate:" + isUpdate);
        } catch (FormException e) {
            HiLog.info(TAG, "onUpdateForm FormException");
            // todo 抛异常返回默认数据,此部分自行处理,可设置默认值
        }
    }

4、此时即可运行工程项目,会发现首次添加卡片时,卡片会显示当前日期。

但是如何调试才能测试更新卡片数据功能呢?步骤3中了解了卡片更新机制后,可将config.json中scheduledUpdateTime修改当前时间后2分钟,如当前是5:12,可设置为5:14,updateDuration设置为1,运行工程添加卡片;然后将updateDuration设置为0,此时再次运行工程,添加卡片。

现象为:5:14前卡片当前日期显示今天日期,有代码获取当前日志,等到5:14时,卡片显示日期就会变成onUpdateForm中传递的默认日期“2024-01-01”了。

请注意config.json中更新机制已实际功能需要为准,此处仅用于功能调试。

到这里就完成了卡片动态数据显示与定点更新卡片数据功能。

cke_8269.png

 

【服务卡片开发相关文档】

(3.0)服务卡片开发指导(包含基于JS UI和Java UI开发卡片):https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ability-service-widget-overview-0000001062607955

(3.0)Java服务卡片JS UI组件:https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-service-widget-file-0000001153028529

(3.1/4.0)FA模型服务卡片开发指导:https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/widget-development-fa-0000001427902244-V3

(3.1/4.0)Stage模型服务卡片开发指导:https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/service-widget-overview-0000001536226057-V3