logo
积分中心
Intents Kit 实战——让系统帮你把用户"带"进 App 原创
头像 87年的鸿蒙开发者 2026-11-16 15:37:20    发布
29 浏览 3 收藏


先说一个容易被忽略的问题

很多开发者做完一个功能,第一反应是"怎么让用户知道我们有这个功能",于是去做推送、做运营位、做引导页。

但用户真正的需求往往是:我现在就想干一件事,不想先打开某个 App。

比如:

"帮我订一张明天去上海的机票"

"把这张照片发给张三"

"打开上次的会议纪要"

用户说这句话的时候,并不关心是哪个 App 提供的能力,他只想事情被办成。

Intents Kit 解决的就是这件事:把你的 App 能力声明给系统,让系统(小艺、负一屏、搜索、快捷操作)在合适的时机,主动把你的能力推到用户面前。

Intents Kit 到底是什么?

一句话:它让你的 App 能力变成系统可调用的"原子服务"。

传统 App 的入口是图标,用户得先找到你、点开你、再在 App 里找功能。

Intents Kit 的入口是意图,用户说一句话或点一下,系统直接把你需要的页面拉起来,甚至带着参数。

举个例子:

传统方式Intents Kit 方式
打开 App → 找订单 → 点物流对小艺说"查我的快递" → 直接跳到物流页
打开相册 → 找照片 → 分享长按照片 → 系统推荐"用 XX App 编辑"
打开笔记 App → 搜索 → 打开文档小艺说"打开上周的会议纪要" → 直接打开

用户少走了 3 步,你的 App 多了一个入口。

核心概念:Intent 和 Ability

Intents Kit 的核心是两个东西:

Intent:描述"用户想干什么",比如 VIEW_ORDER、SHARE_PHOTO、CREATE_NOTE

Ability:你的 App 里真正干活的组件,接收 Intent 并执行

系统负责匹配:用户说了一句话 → 系统解析出 Intent → 找到能处理这个 Intent 的 Ability → 启动它。

你不需要自己写匹配逻辑,只需要声明:我能处理哪些 Intent。

实战场景:电商 App 的"快捷查物流"

假设你做了一个电商 App,用户经常问"我的快递到哪了"。

传统做法:用户打开 App → 我的订单 → 找到订单 → 点物流。

用 Intents Kit 改造后:用户对小艺说"查我的快递",系统直接拉起你的物流页面,甚至自动定位到最新订单。

第一步:声明你能处理的 Intent

在 module.json5 里声明你的 Ability 能响应哪些 Intent:

{
"module": {
"abilities": [
{
"name": "LogisticsAbility",
"srcEntry": "./ets/logistics/LogisticsAbility.ets",
"description": "查看订单物流信息",
"exported": true,
"skills": [
{
"actions": [
"ohos.action.VIEW",
"myapp.action.CHECK_LOGISTICS"
],
"entities": [
"ohos.entity.VIEW_ORDER"
],
"uri": {
"scheme": "myapp",
"host": "logistics"
}
}
]
}
]
}
}

几个关键字段:

actions:你能响应的动作类型,比如查看、分享、创建

entities:你能处理的实体类型,比如订单、照片、联系人

uri:你的 App 内部路由,系统通过它找到具体页面

exported: true:允许外部(小艺、其他 App)调用你

第二步:在 Ability 里接收 Intent 参数

当系统拉起你的 Ability 时,会把参数通过 want 传进来:

// LogisticsAbility.ets
import { Ability, Want } from '@kit.AbilityKit';
export default class LogisticsAbility extends Ability {
onWant(want: Want) {
// 1. 解析 Intent 携带的参数
const orderId = want.parameters?.orderId as string;
const source = want.parameters?.source as string; // 来源:小艺/快捷方式/其他App
// 2. 根据参数决定展示什么
if (orderId) {
// 有指定订单,直接展示该订单物流
this.loadLogistics(orderId);
} else {
// 没指定,展示最新订单
this.loadLatestOrder();
}
// 3. 埋点:统计从哪个入口进来的
this.reportEntry(source);
}
private loadLogistics(orderId: string) {
// 加载指定订单物流
}
private loadLatestOrder() {
// 加载最新订单
}
private reportEntry(source: string) {
hilog.info(0x0000, 'LogisticsAbility', `入口来源: ${source}`);
}
}

第三步:让小艺能"发现"你的能力

光声明还不够,你得告诉系统你的能力描述,这样小艺才能理解什么时候该调用你。

在 resources/base/profile/ 下创建 intent_config.json:

{
"intents": [
{
"action": "myapp.action.CHECK_LOGISTICS",
"description": "查看订单物流信息",
"parameters": [
{
"name": "orderId",
"type": "string",
"description": "订单编号,可选",
"required": false
}
],
"examples": [
"查我的快递",
"订单到哪了",
"物流信息"
]
}
]
}

这样小艺在解析用户语音时,就能匹配到你的能力。

进阶:跨 App 调用

Intents Kit 不只是给小艺用的,其他 App 也能调用你的能力。

比如你的 App 支持"分享图片到 XX 社区",其他 App 可以这样调用:

// 其他 App 的代码
import { common } from '@kit.AbilityKit';
const context = getContext() as common.UIAbilityContext;
await context.startAbility({
bundleName: 'com.example.myapp',
abilityName: 'ShareAbility',
action: 'myapp.action.SHARE_IMAGE',
parameters: {
imagePath: '/data/media/photo.jpg',
title: '好看的照片'
}
});

你的 App 不需要知道是谁在调用,只需要处理 Want 里的参数。

踩坑提醒

Intent 命名要规范   系统预置的 action 用 ohos.action.xxx,自定义的用 你的包名.action.xxx,别混用。

exported 字段要谨慎   如果设为 true,其他 App 也能调用你的能力,要注意参数校验和权限控制。

参数要有默认值   用户说"查快递"时可能没指定订单号,你的 Ability 要能处理"无参数"的情况,别直接崩溃。

入口来源要埋点   从 want.parameters.source 能拿到调用来源,统计一下小艺带来的流量占比,对运营很有价值。

为什么 Intents Kit 值得做?

它解决的是一个很实际的问题:用户越来越不愿意打开 App 了。

当用户习惯了对小艺说"帮我订机票"、"查快递"、"打开文档",你的 App 如果只能靠图标入口,就会慢慢被边缘化。

Intents Kit 让你的能力变成系统的一部分,用户不需要记住你的 App 叫什么,只要说出需求,系统就能找到你。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
其它

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255