[文章]HarmonyOS服务卡片开发-API接口简析
0
0
HarmonyOS中的服务卡片为卡片提供方开发者提供以下接口能力。
| 类名 | 接口名 | 描述 |
Ability | ProviderFormInfo onCreateForm(Intent intent) | 卡片提供方接收创建卡片通知接口。 |
Void onUpdateForm(long formId) | 卡片提供方接收更新卡片通知接口。 | |
Void onDeleteForm(long formId) | 卡片提供方接收删除卡片通知接口。 | |
void onTriggerFormEvent(long formId, String message) | 卡片提供方处理卡片事件接口（JS卡片使用）。 | |
boolean updateForm(long formId, ComponentProvider component) | 卡片提供方主动更新卡片（Java卡片使用）。 | |
boolean updateForm(long formId, FormBindingData formBindingData) | 卡片提供方主动更新卡片（JS卡片使用），仅更新formBindingData中携带的信息，卡片中其余信息保持不变。 | |
void onCastTempForm(long formId) | 卡片提供方接收临时卡片转常态卡片通知（预留接口，当前版本无触发场景，不会回调）。 | |
void onEventNotify(Map<Long, Integer> formEvents) | 卡片提供方接收到事件通知，其中Ability.FORM_VISIBLE表示卡片可见通知， Ability.FORM_INVISIBLE表示卡片不可见通知。 | |
FormState onAcquireFormState(Intent intent) | 卡片提供方接收查询卡片状态通知接口。默认返回卡片初始状态。 | |
ProviderFormInfo | ProviderFormInfo(int resId, Context context) | Java卡片返回对象构造函数。 |
ProviderFormInfo() | JS卡片返回对象构造函数。 | |
void mergeActions(ComponentProvider componentProviderActions) | 在提供方侧调用该接口，将开发者在ComponentProvider中设置的actions配置数据合并到当前对象中。 | |
void setJsBindingData(FormBindingData data) | 设置JS卡片的内容信息(JS卡片使用)。 | |
类名 | 接口名 | 描述 |
其中，onEventNotify仅系统应用才会回调，其他接口回调时机如下图：
说明
卡片管理服务不负责保持卡片的活跃状态（设置了定时更新的除外），当使用方作出相应的请求时，管理服务会拉起提供方并回调相应接口。
本文主要参考HarmonyOS官方文档材料整理。
附件：
回帖高级模式
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容图片侵权或者其他问题，请联系本站作侵删。 侵权投诉