若订阅模板类型为“一次性订阅”,推送消息数量受控于元服务发起订阅请求并获得用户授权的次数。每次发送订阅消息都需要获取用户授权。当用户勾选 “总是保持以上选择” 之后,下次订阅调用serviceNotification.requestSubscribeNotification()不会再向用户弹窗,保持之前的选择。
若订阅模板类型为“长期性订阅”,推送消息数量将在服务通知的模板详情页说明,元服务可在模板限制的订阅周期及频次内多次下发通知,而无需用户再次进行订阅操作,详情见选用订阅模板。
推送订阅消息的消息示例如下,更多详情请见服务通知。
// Request URL
POST https://push-api.cloud.huawei.com/v1/[projectId]/service_notification/send
// Request Header
Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
// Request Body
{
"msgId": "20240514ABCDE",
"appId": "6**********972",
"toOpenId": "A**********O",
"templateId": "1**********2",
"templateParams": {
"thing_0": "待取号",
"time_1": "2024年5月30日 13:00~2024年5月30日 14:00",
"thing_2": "XX银行XX支行"
}
} 
templateParams中的参数项为元服务领用的模板中的配置参数。具体可配置项请见选用订阅模板。
填写templateParams时,请确保填入元服务领用模板的所有已勾选模板参数。
消息示例如下,更多详情请见服务通知。
// Request URL
POST https://push-api.cloud.huawei.com/v1/[projectId]/service_notification/send
// Request Header
Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
// Request Body
{
"msgId": "2**********80",
"appId": "6**********972",
"toOpenId": "A**********O",
"templateId": "1**********2",
"templateParams": {
"thing_0": "N0001",
"time_1": "2024年4月27日 22:22",
"thing_2": "软件大道101号"
},
"clickAction": {
"actionType": 0,
"data": { "testKey": "testValue" }
} 支持通过指定 data 参数跳转至该元服务内指定页面,详情请见调用方UIAbility指定启动页面。
import { UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class MainAbility extends UIAbility {
onCreate(want: Want): void {
// 获取消息中传递的data数据
const data = want.parameters;
hilog.info(0x0000, 'testTag', 'Succeeded in getting message data');
// 根据实际业务场景对data进行处理
}
} onNewWant()方法中覆写如下代码:
import { UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class MainAbility extends UIAbility {
onNewWant(want: Want): void {
// 获取消息中传递的data数据
const data = want.parameters;
hilog.info(0x0000, 'testTag', 'Succeeded in getting message data');
// 根据实际业务场景对data进行处理
}
}
onNewWant()方法仅在单例(singleton)模式下可用。
示例如下:
{
"clickAction": {
"actionType": 0,
"data": {
"ascfPara": {
"path" : "pages/index?key1=value1&key2=value2" // 指定携带数据{'key1':'value1', 'key2':'value2'}跳转到pages/index页面
}
}
}
} 元服务获取启动参数:
可以在ASCF元服务的App的onLaunch、onShow或Page的onLoad生命周期中获取传递的启动参数信息。
App({
onLaunch(options) {
let path = options.path; // 例如:pages/index
let data = options.query; // 例如:{'key1':'value1', 'key2':'value2'}
console.info('data = ', data);
console.info('path = ', path);
}
onShow(options) {
let path = options.path; // 例如:pages/index
let data = options.query; // 例如:{'key1':'value1', 'key2':'value2'}
console.info('data = ', data);
console.info('path = ', path);
}
});
Page({
onLoad(query)
{
console.info('query = ', query); // 例如:{'key1':'value1', 'key2':'value2'}
}
}); 业务响应码报错问题请参考业务响应码。