为了快速访问和管理元服务卡片信息,用户可以将常用的元服务卡片添加到桌面。应用可通过调用应用市场服务提供的loadService接口来加载元服务卡片加桌页面,用户点击“添加至桌面”按钮,将元服务卡片添加至桌面。

用户使用元服务卡片加桌功能。
应用调用AppGallery Kit的loadService接口。
AppGallery Kit API获取应用传入的信息,生成展示页面。
展示生成的页面给用户,用户点击“添加至桌面”按钮,将元服务卡片添加至桌面。
应用市场推荐服务不支持模拟器,请使用真机调试。在模拟器中使用该服务将会提示:无法获取内容,请点击屏幕重试。
应用市场推荐服务支持Phone、Tablet、PC/2in1设备。从6.0.2(22)版本开始,新增支持TV设备;并且从API版本26.0.1开始,新增支持Car设备。
详细接口说明可参考接口文档。
| 接口名 | 描述 |
|---|---|
| loadService(context: common.UIAbilityContext, want: Want, callback?: ServiceViewCallback): void | 加载元服务加桌页面接口。 |
导入productViewManager模块及相关公共模块。
import { common, Want } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { productViewManager } from '@kit.AppGalleryKit'; 构造元服务卡片参数。
const TAG: string = 'LoadService';
@Entry
@Component
struct LoadServiceView {
context = this.getUIContext().getHostContext() as common.UIAbilityContext;
build() {
Column() {
Button($r('app.string.load_service'))
.id('load_service')
.onClick(() => {
try {
const request: Want = {
// 此处填入要加载的元服务的加桌链接
uri: 'store://******'
};
const callback: productViewManager.ServiceViewCallback = {
// 接收元服务卡片加桌结果信息
onReceive: (data: productViewManager.ServiceViewReceiveData) => {
hilog.info(0, TAG,
`loadService onReceive.result is ${data.result}, msg is ${data.msg}, formInfo is ${JSON.stringify(
data.formInfo)}`);
},
onError: (error: BusinessError) => {
hilog.error(0, TAG,
`loadService onError.code is ${error.code}, message is ${error.message}`)
},
// 当元服务卡片加桌页成功打开时回调
onAppear: () => {
hilog.info(0, TAG, `loadService onAppear.`);
},
// 当元服务卡片加桌页关闭时回调
onDisappear: () => {
hilog.info(0, TAG, `loadService onDisappear.`);
}
};
// ...
} catch (error) {
hilog.error(0, TAG,
`loadService failed.code is ${(error as BusinessError).code}, message is ${(error as
BusinessError).message}`);
}
})
.width('100%')
}
.margin(16)
.height('100%')
.justifyContent(FlexAlign.Center)
}
} 调用productViewManager.loadService方法,将步骤2中构造的参数依次传入接口中。
// 调用接口,加载元服务加桌页面 productViewManager.loadService(this.context, request, callback);