50人办公室网络搭建_陕西网站推广费用_seo网站优化方案摘要_百度一下官网首页百度一下

方案概述

当用户在应用/元服务内使用功能时，开发者需要按照标准意图Schema向系统共享行为数据，并支持意图调用（空调用与传参调用），以实现用户点击模板卡后跳转回对应页面。

意图注册

以歌曲续听推荐特性为例，首先要注册播放歌曲意图（PlayMusic），其他意图见各垂域意图Schema。开发者需要编辑对应的意图配置 PROJECT_HOME/entry/src/main/resources/base/profile/insight_intent.json文件，实现意图注册。

{
// 应用支持的意图列表
// 必须声明应用支持插件包含的必选意图，应用上架时会进行校验
"insightIntents": [
{
// 意图名称
// 名称应当遵循意图框架规范，当前仅支持预置垂域意图，不允许自定义
// 应用内意图名称唯一，不允许出现相同的名称定义
"intentName": "PlayMusic",
// 意图所属的垂域
"domain": "MusicDomain",
// 意图版本号
// 插件引用意图时会校验该版本号，只有和插件定义的版本号一致才能正常调用
"intentVersion": "1.0.1",
// 意图调用逻辑入口
"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets",
"uiAbility": {
// 意图所在module、ability，以及代码相对路径入口
"ability": "EntryAbility",
// UIAbility支持前后台两种执行模式
"executeMode": [
"background",
"foreground"
]
}
}
]
}

端侧意图共享

构建意图对象，并且调用shareIntent()，实现意图共享。可同时构建多个PlayMusic或PlayMusicList的意图对象。

import { insightIntent } from '@kit.IntentsKit';
import { BusinessError } from '@kit.BasicServicesKit';
let playMusicIntent1: insightIntent.InsightIntent;
let playMusicIntent2: insightIntent.InsightIntent;
// 共享数据接口意图数组可以是更多的实体
// 根据实际代码上下文自行传入合适的context
insightIntent.shareIntent(context, [playMusicIntent1, playMusicIntent2]).then(() => {
console.info('shareIntent succeed');
}).catch((err: BusinessError) => {
console.error(`error.code: ${err?.code}, failed because ${err?.message}`);
});

PlayMusic的意图共享字段定义见各垂域意图Schema定义，代码示例如下：

import { insightIntent } from '@kit.IntentsKit';
let playMusicIntent: insightIntent.InsightIntent = {
intentName: "PlayMusic",
intentVersion: "1.0",
identifier: "52dac3b0-6520-4974-81e5-25f0879449b5",
intentActionInfo: {
actionMode: "EXECUTED",
executedTimeSlots: {
executedStartTime: 1637393212000,
executedEndTime: 1637393112000,
},
currentPercentage: 50,
},
intentEntityInfo: {
entityName: "Music",
entityId: "C10194368",
entityGroupId: "C10194321312",
displayName: "测试歌曲1",
description: "NA",
logoURL: "https://www-file.abc.com/-/media/corporate/images/home/logo/abc_logo.png",
keywords: ["华为音乐", "化妆"],
rankingHint: 99,
expirationTime: 1637393212000,
metadataModificationTime: 1637393212000,
activityType: ["1", "2", "3"],
artist: ["测试歌手1", "测试歌手2"],
lyricist: ["测试词作者1", "测试词作者2"],
composer: ["测试曲作者1", "测试曲作者2"],
albumName: "测试专辑",
duration: 244000,
playCount: 100000,
musicalGenre: ["流行", "华语", "金曲", "00后"],
isPublicData: false,
}
}

完整的意图共享示例如下所示，该示例构建了一个PlayMusic意图，并进行了shareIntent调用。

import { insightIntent } from '@kit.IntentsKit';
import { BusinessError } from '@kit.BasicServicesKit';
let playMusicIntent: insightIntent.InsightIntent = {
intentName: "PlayMusic",
intentVersion: "1.0",
identifier: "52dac3b0-6520-4974-81e5-25f0879449b5",
intentActionInfo: {
actionMode: "EXECUTED",
executedTimeSlots: {
executedStartTime: 1637393212000,
executedEndTime: 1637393112000,
},
currentPercentage: 50,
},
intentEntityInfo: {
entityName: "Music",
entityId: "C10194368",
entityGroupId: "C10194321312",
displayName: "测试歌曲1",
description: "NA",
logoURL: "https://www-file.abc.com/-/media/corporate/images/home/logo/abc_logo.png",
keywords: ["华为音乐", "化妆"],
rankingHint: 99,
expirationTime: 1637393212000,
metadataModificationTime: 1637393212000,
activityType: ["1", "2", "3"],
artist: ["测试歌手1", "测试歌手2"],
lyricist: ["测试词作者1", "测试词作者2"],
composer: ["测试曲作者1", "测试曲作者2"],
albumName: "测试专辑",
duration: 244000,
playCount: 100000,
musicalGenre: ["流行", "华语", "金曲", "00后"],
isPublicData: false,
}
}
// 共享数据接口意图数组可以是更多的实体
// 根据实际代码上下文自行传入合适的context
insightIntent.shareIntent(context, [playMusicIntent]).then(() => {
console.info('shareIntent succeed');
}).catch((err: BusinessError) => {
console.error(`error.code: ${err?.code}, failed because ${err?.message}`);
});

端侧意图调用

意图执行组件为uiAbility的意图调用

如上文意图注册，当开发者注册的意图承载的运行组件为uiAbility时，开发者需要自己实现InsightIntentExecutor，并在对应回调实现打开落地页（点击推荐卡片跳转的界面）的能力，PlayMusic的意图调用字段定义见各垂域意图Schema。

步骤如下：

继承InsightIntentExecutor。
重写对应方法，例如目标拉起前台页面，则可重写onExecuteInUIAbilityForegroundMode方法。
通过意图名称，识别播放歌曲意图（PlayMusic），在对应的方法中传递意图参数（param），并拉起对应落地页（如歌曲落地页）。
1. import { insightIntent, InsightIntentExecutor } from '@kit.AbilityKit';
2. import { window } from '@kit.ArkUI';
3. import { BusinessError } from '@kit.BasicServicesKit';
5. /**
6. * 意图调用样例
7. */
8. export default class InsightIntentExecutorImpl extends InsightIntentExecutor {
9. private static readonly PLAY_MUSIC = 'PlayMusic';
10. /**
11. * override 执行前台UIAbility意图
12. *
13. * @param name 意图名称
14. * @param param 意图参数
15. * @param pageLoader 窗口
16. * @returns 意图调用结果
17. */
18. onExecuteInUIAbilityForegroundMode(name: string, param: Record<string, Object>, pageLoader: window.WindowStage):
19. Promise<insightIntent.ExecuteResult> {
20. // 根据意图名称分发处理逻辑
21. switch (name) {
22. case InsightIntentExecutorImpl.PLAY_MUSIC:
23. return this.playMusic(param, pageLoader);
24. default:
25. break;
26. }
27. return Promise.resolve({
28. code: -1,
29. result: {
30. message: 'unknown intent'
31. }
32. } as insightIntent.ExecuteResult)
33. }
34. /**
35. * 实现调用播放歌曲功能
36. *
37. * @param param 意图参数
38. * @param pageLoader 窗口
39. */
40. private playMusic(param: Record<string, Object>, pageLoader: window.WindowStage): Promise<insightIntent.ExecuteResult> {
41. return new Promise((resolve, reject) => {
42. let para: Record<string, string> = {
43. 'result': JSON.stringify(param)
44. };
45. let localStorage: LocalStorage = new LocalStorage(para);
46. // TODO 实现意图调用，loadContent的入参为歌曲落地页路径，例如：pages/Index
47. pageLoader.loadContent('pages/Index', localStorage)
48. .then(() => {
49. let entityId: string = (param.items as Array<object>)?.[0]?.['entityId'];
50. // TODO 调用成功的情况，此处可以打印日志
51. resolve({
52. code: 0,
53. result: {
54. message: 'Intent execute succeed'
55. }
56. });
57. })
58. .catch((err: BusinessError) => {
59. // TODO 调用失败的情况
60. resolve({
61. code: -1,
62. result: {
63. message: 'Intent execute failed'
64. }
65. })
66. });
67. })
68. }
69. }

意图执行组件为form的意图调用

如上文意图注册，当开发者注册的意图承载的运行组件为form（运行组件FormExtensionAbility）时，则需要开发者在实现的FormExtensionAbility中从want中获取并解析意图名和执行参数，用于卡片展示。