HarmonyOS NEXT 应用元服务开发 Intents Kit(意图框架服务)事件推荐接入方案
踏入鸿蒙世界的敲门砖,标志着您在技术征途上的全新起点,提升就业竞争力,获得行业认可,点亮职业成长先机,快人一步抢占未来应用开发赛道!https://developer.huawei.com/consumer/cn/training/dev-cert-detail/101666948302721398?ha_source=hmosclass-itzhijia&ha_sourceId=89000249
一、方案概述
当开发者有事件想要通知到用户时,可通过应用 / 元服务的云侧服务器向智慧分发平台推送事件内容(意图共享)。系统通过智慧决策判断事件发生的条件,在满足条件时,向用户推荐事件提醒卡片,当用户点击卡片后,可跳转到应用 / 元服务的详情页查看事件详情(意图调用)。
二、流程图
开发者获取云侧事件捐赠所需的 SID(Service OpenID)。
当用户有订单事件后,开发者云将事件内容和 SID 同步到业务云。
华为内部会根据事件和具体场景制定事件服务推出规则和时机。
在满足制定规则场景下展示对应用户事件,增加服务曝光率。
三、意图注册
以还款待办事件提醒特性为例,首先要注册查看还款意图(ViewRepayment)。开发者需要编辑对应的意图配置#PROJECT_HOME / entry / src / main / resources / base / profile / insight_intent.json 文件,实现意图注册。
四、获取 SID
云侧事件捐赠凭证 SID(Service OpenID)优先从缓存获取,当缓存获取失败可以强制从云侧获取新的 SID。
五、云侧意图共享
服务上架配置
云侧意图需要服务承载,需要先在 AppGallery Connect 上架应用 / 元服务,然后在小艺开放平台配置意图,具体步骤如下:
在 AppGallery Connect 中创建应用 / 元服务,具体操作步骤见应用开发准备,完成意图注册应用 / 元服务发布。应用 / 元服务中需包含意图注册声明文件。
在 AppGallery Connect 上架后,通过华为开发者联盟 > 管理中心 > 智慧服务 > 小艺开放平台 > 进入小艺开放平台。
选择待上架的意图,填写基本信息。
选择“意图”页签,可以新增、修改、删除,并保存配置。
选择“发布”页签,依次配置检查、测试。
测试成功后提交审核,等待审核通过。
服务上架配置完成后,进入意图共享和意图调用环节。
意图共享接口调用
应用 / 元服务通过云侧意图共享接口,把对应意图的相关事件数据共享给 Intents Kit,用于事件提醒服务。
事件撤销接口调用
当应用 / 元服务共享的意图相关事件数据超过时效期,Intents Kit 需要通过云侧事件撤销接口把相关事件数据撤销,以避免触发超过时效期的事件提醒。
六、端侧意图调用
开发者需要自己实现 InsightIntentExecutor,并在对应回调实现打开落地页(点击推荐卡片跳转的界面)的能力,ViewRepayment 的意图调用字段定义见对应垂域意图 Schema 定义表。
步骤如下:
继承 InsightIntentExecutor。
重写对应方法,例如目标拉起前台页面,则可重写 onExecuteInUIAbilityForegroundMode 方法。
通过意图名称,识别查看还款意图(ViewRepayment)。
在对应的方法中传递意图参数(param),并拉起对应落地页(如还款页面)。
本文主要参考鸿蒙官方网站材料。(文章转载自 51CTO,作者鸿蒙时代)