显示商业组件
业务场景
微信官方的商品组件,通过提前设置好不同礼包,微信会根据不同的用户推送展示不同的购买弹窗
注意事项
- 在 game.json 中声明使用插件,MiniGameCommon 是插件名,直接复制 plugins 里面的内容,不要做任何改动
"plugins": {
"MiniGameCommon": {
"version": "latest",
"provider": "wxaed5ace05d92b218",
"contexts": [
{
"type": "isolatedContext"
}
]
}
}
- 首次使用需要把接了插件的游戏上传到体验版才能识别该游戏启用插件
- 未上线前,需要开发者/运营者权限才能打开该组件
- 如果调用失败的错误码是 10004,请检查下面的插件接入状态,还有调用的用户是否有运营者权限
流程图
无
接口介绍
SDKManager.showPopupActivity(PopupActivityInfo info)
调用示例
SDKManager.showPopupActivity({
actId: 'xxx',
onSuccess: (res) => {
// 如果res为空,即用户点了关闭弹窗,没有购买
// 调用成功,用户点击了弹窗的购买,会返回后台配置的 支付参数
},
onFailed: (res) => {
// 调用礼包弹窗失败
},
});
参数说明
入参
PopupActivityInfo info
参数名称 | 类型 | 说明 | 必传/可选 | 最低版本 |
---|---|---|---|---|
actId | string | 活动 id 置 | 必传 | |
levelList | int[] | 标记该用户当前已购买了哪些 level 的礼包,透传给微信(非首次购买,需要传入识别档位) | 可选 |
错误码
无
FAQ
Q: 可以不管 onSuccess 中的响应吗
A: 可以,在 1.2.3 之后的版本可直接处理 OnBuyProduct 的响应即可
Q: onSuccess 返回的 json 有什么内容
A: 返回的字段都是在微信后台-商业礼包配置-支付参数(如果用户关闭弹窗,则返回空对象),在里面填入 JSON 串,例如
{"amount":100,"productCount":10,"productId":"xxx}
,amount 礼包的价格,productCount 是商品数量,如需其他额外信息,可联系运营去配置,例如:{"amount":3000,"productCount":300,"productId":"xxx","customParam": "xxx"}
