打开 APP 的某个页面,是智能交互的第一步。
但对于很多应用来说,用户更希望直接完成任务。例如,打开运动 APP 后,用户不需要再进入运动记录页面、选择日期、点击查询,而是希望直接问:“我上周跑了多少公里?”
这就需要应用提供可被系统调用的业务能力。
HarmonyOS 从 API version 20 开始支持通过 @InsightIntentFunctionMethod 将函数调用转换为系统意图。它适合将现有函数能力以意图形式开放出来。
先把业务函数独立出来
假设运动 APP 已经有一套运动数据服务:
class RunningService {
static async getWeeklyDistance(
week: string
): Promise<number> {
// 实际项目中从本地数据库或业务服务读取数据
return 32.5;
}
}
这里先把查询逻辑独立在业务层,而不是直接写在页面组件中。
这样做的好处是,无论用户从 APP 页面进入,还是通过意图触发,都可以复用同一套业务逻辑。
再研究函数意图的定义
官方装饰器体系提供了 @InsightIntentFunctionMethod,可以将函数方法转换为意图。开发者需要根据 API 参考配置意图描述、参数和执行方式。
工程实现时,建议先明确函数的输入输出契约:
interface WeeklyRunningResult {
week: string;
distanceKm: number;
runCount: number;
}
例如,用户请求“查询上周跑步记录”,应用需要确定“上周”的时间范围,再调用数据服务,最终返回距离和次数。
这段接口定义是业务层示意,不是官方意图参数 Schema。
参数设计决定了意图是否好用
如果用户说“查一下上周跑步情况”,应用至少需要处理:
- 时间范围:上周。
- 查询对象:跑步记录。
- 返回内容:距离、次数等指标。
如果用户只说“查一下我的运动”,就需要结合应用业务设计默认查询范围,或者进一步澄清。
参数不能全部设计为必填项,也不能把所有缺失值都当作空字符串处理。
查询和修改要采用不同策略
查询类函数通常可以在身份校验通过后执行。
但如果用户说“把上周跑步记录删除”,就涉及数据修改,需要增加权限校验和确认流程。
不要因为使用了意图调用,就让原本的业务安全机制失效。
验证重点
测试时不要只用一个固定表达方式。
至少准备以下几组请求:
- 查询上周跑步距离。
- 查一下最近七天跑了多少公里。
- 看看我这周运动了几次。
- 查询一个没有运动记录的时间段。
重点观察系统是否能够正确匹配意图、传递参数,以及应用是否能够返回真实业务结果。
技术价值: @InsightIntentFunctionMethod 的意义在于让应用已有的业务函数拥有新的系统级调用入口。开发者应优先选择边界清晰、参数明确、结果可验证的函数进行接入。
相关推荐
28
0
18
0泡面加蛋哲学
我还没有写个人简介......
帖子
提问
粉丝
API 26 新能力实战:把 APP 内的 ArkTS 业务函数封装成 Skill
2026-11-10 17:10:25 发布长安汽车申请基于鸿蒙系统的远程车控方法专利,降低了远程控车应用的开发成本和维护难度
2026-08-20 11:35:19 发布



京公网安备:11010502051901号