HarmonyOS4.0系统性深入开发12 卡片数据交互说明

卡片数据交互说明

ArkTS卡片框架提供了updateForm()接口和requestForm()接口主动触发卡片的页面刷新。

点击放大

接口是否系统能力约束
updateForm否1. 提供方调用。2. 提供方仅允许刷新自己的卡片，其他提供方的卡片无法刷新。
requestForm是1. 使用方调用。2. 仅允许刷新添加到当前使用方的卡片，添加到其他使用方的卡片无法刷新。

下面介绍卡片页面刷新的典型场景。

定时刷新和定点刷新

当前卡片框架提供了如下几种按时间刷新卡片的方式：

  • 定时刷新：表示在一定时间间隔内调用

    onUpdateForm

    的生命周期回调函数自动刷新卡片内容。可以在form_config.json配置文件的

    updateDuration

    字段中进行设置。例如，可以将刷新时间设置为每小时一次。注意：updateDuration（定时刷新）优先级比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分钟，取值为自然数）"defaultDimension": "2*2","supportDimensions": ["2*2"]}]
}

  • 定点刷新：表示每天在某个时间点刷新，在form_config.json文件中配置，详见

    scheduledUpdateTime

    字段。例如，每天在10:30更新卡片内容。

    说明

    当同时配置了定时刷新（updateDuration）和定点刷新（scheduledUpdateTime）时，定时刷新的优先级更高。如果想要配置定点刷新，则需要将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分钟），例如，在接口调用的5分钟后刷新卡片内容。

    import formProvider from '@ohos.app.form.formProvider';let formId = '123456789'; // 实际业务场景需要使用正确的formId
try {// 设置过5分钟后更新卡片内容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}`);
}

在触发定时、定点或主动刷新后，系统会调用FormExtensionAbility的onUpdateForm生命周期回调，在回调中，可以使用updateForm进行提供方刷新卡片。onUpdateForm生命周期回调参考通过FormExtensionAbility刷新卡片内容。

说明

  1. 定时刷新有配额限制，每张卡片每天最多通过定时方式触发刷新50次，定时刷新包含卡片配置项updateDuration和调用setFormNextRefreshTime两种，当达到50次配额后，无法通过定时方式再次触发刷新，刷新次数会在每天的0点重置。
  2. 当前定时刷新使用同一个计时器进行计时，因此卡片定时刷新的第一次刷新会有最多30分钟的偏差。比如第一张卡片A(每隔半小时刷新一次)在3点20分添加成功，定时器启动并每隔半小时触发一次事件，第二张卡片B(每隔半小时刷新一次)在3点40分添加成功，在3点50分定时器事件触发时，卡片A触发定时刷新，卡片B会在下次事件(4点20分)中才会触发。
  3. 定时刷新和定点刷新仅在屏幕亮屏情况下才会触发，在灭屏场景下仅会将记录刷新动作，待亮屏时统一进行刷新。

刷新本地图片和网络图片

在卡片上通常需要展示本地图片或从网络上下载的图片，获取本地图片和网络图片需要通过FormExtensionAbility来实现，如下示例代码介绍了如何在卡片上显示本地图片和网络图片。

  1. 下载网络图片需要使用到网络能力，需要申请ohos.permission.INTERNET权限，配置方式请参见配置文件权限声明。

  2. 在EntryFormAbility中的onAddForm生命周期回调中实现本地文件的刷新。

    import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import request from '@ohos.request';
import fs from '@ohos.file.fs';export default class EntryFormAbility extends FormExtensionAbility {...// 在添加卡片时，打开一个本地图片并将图片内容传递给卡片页面显示onAddForm(want) {// 假设在当前卡片应用的tmp目录下有一个本地图片：head.PNGlet tempDir = this.context.getApplicationContext().tempDir;// 打开本地图片并获取其打开后的fdlet file;try {file = fs.openSync(tempDir + '/' + 'head.PNG');} catch (e) {console.error(`openSync failed: ${JSON.stringify(e)}`);}let formData = {'text': 'Image: Bear','imgName': 'imgBear','formImages': {'imgBear': file.fd},'loaded': true}// 将fd封装在formData中并返回至卡片页面return formBindingData.createFormBindingData(formData);}...
}

  3. 在EntryFormAbility中的onFormEvent生命周期回调中实现网络文件的刷新。

    import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import request from '@ohos.request';
import fs from '@ohos.file.fs';export default class EntryFormAbility extends FormExtensionAbility {// 在卡片页面触发message事件时，下载一个网络图片，并将网络图片内容传递给卡片页面显示onFormEvent(formId, message) {let formInfo = formBindingData.createFormBindingData({'text': '刷新中...'})formProvider.updateForm(formId, formInfo)// 注意：FormExtensionAbility在触发生命周期回调时被拉起，仅能在后台存在5秒// 建议下载能快速下载完成的小文件，如在5秒内未下载完成，则此次网络图片无法刷新至卡片页面上let netFile = 'https://xxxx/xxxx.png'; // 需要在此处使用真实的网络图片下载链接let tempDir = this.context.getApplicationContext().tempDir;let tmpFile = tempDir + '/file' + Date.now();request.downloadFile(this.context, {url: netFile, filePath: tmpFile}).then((task) => {task.on('complete', function callback() {console.info('ArkTSCard download complete:' + tmpFile);let file;try {file = fs.openSync(tmpFile);} catch (e) {console.error(`openSync failed: ${JSON.stringify(e)}`);}let formData = {'text': 'Image: Https','imgName': 'imgHttps','formImages': {'imgHttps': file.fd},'loaded': true}let formInfo = formBindingData.createFormBindingData(formData)formProvider.updateForm(formId, formInfo).then((data) => {console.info('FormAbility updateForm success.' + JSON.stringify(data));}).catch((error) => {console.error('FormAbility updateForm failed: ' + JSON.stringify(error));})})task.on('fail', function callBack(err) {console.info('ArkTSCard download task failed. Cause:' + err);let formInfo = formBindingData.createFormBindingData({'text': '刷新失败'})formProvider.updateForm(formId, formInfo)});}).catch((err) => {console.error('Failed to request the download. Cause: ' + JSON.stringify(err));});}...
};

  4. 在卡片页面通过Image组件展示EntryFormAbility传递过来的卡片内容。

    let storage = new LocalStorage();@Entry(storage)
@Component
struct WidgetCard {@LocalStorageProp('text') text: string = '加载中...';@LocalStorageProp('loaded') loaded: boolean = false;@LocalStorageProp('imgName') imgName: string = 'name';build() {Column() {Text(this.text).fontSize('12vp').textAlign(TextAlign.Center).width('100%').height('15%')Row() {if (this.loaded) {Image('memory://' + this.imgName).width('50%').height('50%').margin('5%')} else {Image('common/start.PNG').width('50%').height('50%').margin('5%')}}.alignItems(VerticalAlign.Center).justifyContent(FlexAlign.Center)Button('刷新').height('15%').onClick(() => {postCardAction(this, {'action': 'message','params': {'info': 'refreshImage'}});})}.width('100%').height('100%').alignItems(HorizontalAlign.Center).padding('5%')}
}

说明

  • Image组件通过入参(memory://fileName)中的memory://标识来进行远端内存图片显示，其中fileName需要和EntryFormAbility传递对象(‘formImages****’: {key****: fd})中的key相对应。
  • Image组件通过传入的参数是否有变化来决定是否刷新图片，因此EntryFormAbility每次传递过来的imgName都需要不同，连续传递两个相同的imgName时，图片不会刷新。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/592130.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

数字图像处理（3）——频域图像增强

数字图像处理（3）——频域图像增强

🔥博客主页：是dream 🚀系列专栏：深度学习环境搭建、环境配置问题解决、自然语言处理、语音信号处理、项目开发 💘每日语录：贤才，难进易出；庸才，易进易初出；…
阅读更多...
Character Controller Smooth

Character Controller Smooth

流畅的角色控制器 Unity的FPS解决方案！ 它是一种具有非常平滑运动和多种设置的解决方案： - 移动和跳跃 - 坐的能力 - 侧翻角度 - 不平整表面的处理 - 惯性守恒 - 重力 - 与物理物体的碰撞。 - 支持没有家长控制的平台 此解决方案适用于那些需要角色控制器…
阅读更多...
Jmeter的安装与快速使用（做并发测试）

Jmeter的安装与快速使用（做并发测试）

1、了解 JMeter是一款开源的性能测试工具，它主要用于模拟多种负载条件下的应用程序或服务器的性能和功能。JMeter可以发送不同类型的请求，如HTTP、HTTPS、FTP、SOAP、REST等，并且可以模拟多种负载类型，例如并发用户、线程组、定时…
阅读更多...
正则表达式 详解，10分钟学会

正则表达式 详解，10分钟学会

大家好，欢迎来到停止重构的频道。 本期我们讨论正则表达式。 正则表达式是一种用于匹配和操作文本的工具，常用于文本查找、文本替换、校验文本格式等场景。 正则表达式不仅是写代码时才会使用，在平常使用的很多文本编辑软件，都…
阅读更多...
关于Python里xlwings库对Excel表格的操作（二十五）

关于Python里xlwings库对Excel表格的操作（二十五）

这篇小笔记主要记录如何【如何使用xlwings库的“Chart”类创建一个新图表】。 前面的小笔记已整理成目录，可点链接去目录寻找所需更方便。 【目录部分内容如下】【点击此处可进入目录】 （1）如何安装导入xlwings库； （2…
阅读更多...
案例分享：Qt多国语言输入法软键盘

案例分享：Qt多国语言输入法软键盘

若该文为原创文章，转载请注明出处 本文章博客地址：https://hpzwl.blog.csdn.net/article/details/135346374 红胖子(红模仿)的博文大全：开发技术集合（包含Qt实用技术、树莓派、三维、OpenCV、OpenGL、ffmpeg、OSG、单片机、软硬结…
阅读更多...
aspose通过开始和结束位置关键词截取word另存为新文件

aspose通过开始和结束位置关键词截取word另存为新文件

关键词匹配实体类： Data EqualsAndHashCode(callSuper false) public class TextConfig implements Serializable {private static final long serialVersionUID 1L;/*** 开始关键词，多个逗号分隔*/private String textStart ;/*** 结束关键词&#x…
阅读更多...
【操作系统xv6】学习记录4 -CPU上下文：进程上下文、线程上下文、中断上下文

【操作系统xv6】学习记录4 -CPU上下文：进程上下文、线程上下文、中断上下文

什么是cpu上下文 CPU 寄存器和程序计数器就是 CPU 上下文，因为它们都是 CPU 在运行任何任务前，必须的依赖环境。 什么是 CPU 上下文切换 先把前一个任务的 CPU 上下文（也就是 CPU 寄存器和程序计数器）保存起来，然后…
阅读更多...
Flutter+Go_Router+Fluent_Ui仿阿里网盘桌面软件开发跨平台实战-买就送仿小米app开发

Flutter+Go_Router+Fluent_Ui仿阿里网盘桌面软件开发跨平台实战-买就送仿小米app开发

Flutter是谷歌公司开发的一款开源、免费的UI框架，可以让我们快速的在Android和iOS上构建高质量App。它最大的特点就是跨平台、以及高性能。 目前 Flutter 已经支持 iOS、Android、Web、Windows、macOS、Linux 的跨平台开发。 Flutter官方介绍，目前Flutte…
阅读更多...
ubuntu系统没有网络图标的解决办法

ubuntu系统没有网络图标的解决办法

参考文章:https://blog.csdn.net/qq_56922632/article/details/132309643 1. 执行关闭网络服务的命令，关闭网络服务sudo service NetworkManager stop2. 删除网络的状态文件sudo rm /var/lib/NetworkManager/NetworkManager.state3. 修改网络的配置文件sudo vi /etc…
阅读更多...
冒泡排序-排序算法

冒泡排序-排序算法

前言 如果有6个人站成一排，要将他们按从矮到高的顺序排列。你可能有多种方式来完成。但是如果其中有一个人特别高，比他身边的人高，在队伍中特别明显，你可以轻易看出那个最高的需要和身边的人交换位置，这是冒泡排序的核…
阅读更多...
二叉树的前序遍历 、二叉树的最大深度、平衡二叉树、二叉树遍历【LeetCode刷题日志】

二叉树的前序遍历 、二叉树的最大深度、平衡二叉树、二叉树遍历【LeetCode刷题日志】

目录 一、二叉树的前序遍历 方法一：全局变量记录节点个数 方法二：传址调用记录节点个数 二、二叉树的最大深度 三、平衡二叉树 四、二叉树遍历 一、二叉树的前序遍历 方法一：全局变量记录节点个数 计算树的节点数: 函数TreeSize用于…
阅读更多...
案例086:基于微信小程序的影院选座系统

案例086:基于微信小程序的影院选座系统

文末获取源码 开发语言：Java 框架：SSM JDK版本：JDK1.8 数据库：mysql 5.7 开发软件：eclipse/myeclipse/idea Maven包：Maven3.5.4 小程序框架：uniapp 小程序开发软件：HBuilder X 小程序…
阅读更多...
履机乘变，轻舟便楫：源启分布式PaaS深度赋能企业级技术平台建设

履机乘变，轻舟便楫：源启分布式PaaS深度赋能企业级技术平台建设

导语 源启分布式PaaS平台围绕应用视角为用户提供应用运行的全生命周期管控能力，提供注册中心、服务路由、网关、服务治理等中间件技术支持，实现应用之间的联通，解决客户多厂商产品不兼容、产品组合不可选择、孤岛效应等问题，满足…
阅读更多...
ros2 基础学习12 分布式通信

ros2 基础学习12 分布式通信

智能机器人的功能繁多，全都放在一个计算机里，经常会遇到计算能力不够、处理出现卡顿等情况，如果可以将这些任务拆解，分配到多个计算机中运行岂不是可以减轻压力？ 这就是分布式系统，可以实现多计算平台上的任…
阅读更多...
android开发百度地图api实现定位图标随手机方向转动

android开发百度地图api实现定位图标随手机方向转动

该功能的实现依赖于手机中的传感器元件如陀螺仪、加速度计等，具体开发详见android的官方开发文档： 传感器概览 | Android 开发者 | Android Developershttps://developer.android.com/guide/topics/sensors/sensors_overview?hlzh-cn要自定义一个传…
阅读更多...
Hive学习（13）lag和lead函数取偏移量

Hive学习（13）lag和lead函数取偏移量

hive里面lag函数 在数据处理和分析中，窗口函数是一种重要的技术，用于在数据集中执行聚合和分析操作。Hive作为一种大数据处理框架，也提供了窗口函数的支持。在Hive中，Lag函数是一种常用的窗口函数，可以用于计算前一行…
阅读更多...
《动手学深度学习》学习笔记 第6章 卷积神经网络

《动手学深度学习》学习笔记 第6章 卷积神经网络

本系列为《动手学深度学习》学习笔记 书籍链接：动手学深度学习 笔记是从第四章开始，前面三章为基础知道，有需要的可以自己去看看 关于本系列笔记： 书里为了让读者更好的理解，有大篇幅的描述性的文字，内容很…
阅读更多...
[足式机器人]Part2 Dr. CAN学习笔记-自动控制原理Ch1-9PID控制器

[足式机器人]Part2 Dr. CAN学习笔记-自动控制原理Ch1-9PID控制器

本文仅供学习使用 本文参考： B站：DR_CAN Dr. CAN学习笔记-自动控制原理Ch1-9PID控制器） P —— Proportional I —— Integral D —— Derivative 当前误差/过去误差/误差的变化趋势 K p ⋅ e K_{\mathrm{p}}\cdot e Kp​⋅e：比…
阅读更多...
golang并发编程-channel

golang并发编程-channel

在golang 并发编程里，经常会听到一句话：不要通过共享内存进行通信，通过通信来共享内存。下面我们会介绍下channel, 通过源码的方式去了解channel是怎么工作的。 基本结构 流程图 代码解读 type hchan struct {qcount uint // …
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023