一、查询当前消息订阅状态

qg.querySubscribe(Object object)

获取当前用户的订阅消息状态信息：

1. 用户对于每条已定义的消息模板的订阅状态；2. 用户是否禁止订阅消息弹窗。

参数 Object object

success回调函数的参数 Object res

消息模板对象结构

代码示例

qg.querySubscribe({
  success: (res) => {
    console.log(res) 
  },
  fail: () => {},
  complete: () => {}
})

返回示例

{
    "disableSubscribePopup": 1,
    "msgTypeSettings": [
        {
            "msgTemplateID": "1",
            "templateName": "游玩提醒",
            "value": 1
        },
        {
            "msgTemplateID": "2",
            "templateName": "礼包领取提醒",
            "value": 1
        }
    ]
}

二、请求订阅消息弹窗（最小支持引擎版本1309+）

qg.openSubscribePopWindow(Object object)

调起小游戏请求订阅消息页面，返回用户订阅消息的操作结果。当用户勾选了订阅面板中的“总是保持以上选择，不再询问”时，对于该用户客户端永久不再显示请求订阅消息弹窗。

注意：在13090001以下版本快应用框架的用户不支持调起“请求消息订阅”弹窗。
参数 Object object

代码示例

const res = qg.openSubscribePopWindow({
    "msgTypeSettings": [
        {
            "msgTemplateID": "1",
        },
        {
            "msgTemplateID": "2",
        }   
    ]
})

返回示例（用户点击允许并修改了设置）

{
    "msgTypeSettings": [
        {
            "msgTemplateID": "1",
            "templateName": "游玩提醒",
            "value": 1
        },
        {
            "msgTemplateID": "2",
            "templateName": "礼包领取提醒",
            "value": 0
        }  
    ]
}

返回示例（用户点击拒绝，返回一个空Json）

{
    "msgTypeSettings": []
}

三、错误码列表

四、开发建议

1. 在调用openSubscribePopWindow前，建议先调用querySubscribe查询当前状态，避免不必要的弹窗
2. 处理接口返回结果时，应检查msgTypeSettings数组是否为空，以区分用户点击了允许还是拒绝
3. 对于错误码206，应在代码中做好状态管理，避免重复请求打开弹窗
4. 参数构造时，确保只传入已定义的模板ID，且数量不超过5个
5. 查询接口会有一个5分钟本地缓存，用户点击允许后成功修改了订阅状态后会刷新这个缓存。这里需要注意在订阅设置页面发生的修改不会去更新这个缓存
6. 建议在网络环境良好时调用订阅相关接口，减少因网络问题导致的失败