fusion2.dialog.authReminder

这个接口已经不再提供服务

目录

1 功能说明

“QQ提醒”前端JS接口,弹框模式。
应用获得用户授权后,向用户发送提醒,适用于有冷却时间玩法的应用场景,以拉取回流用户,详见:QQ提醒渠道简介#2. 效果展示
本接口需与后台接口 v3/spread/is_reminder_setv3/spread/set_reminder 配套使用,完成QQ提醒功能。

注:
本接口目前只支持QQ空间平台,朋友和微博平台暂不支持。

2 接口调用说明

调用本前端接口前,应用中应该部署Fusion2的跨域文件以及引用脚本,请参阅:Fusion2文档

2.1 接口说明

fusion2.dialog.authReminder

({

//可选。
//需要用户授权时,用户授权设置成功(指“开启提醒”或“关闭提醒”)后的回调方法,其中opt的参数结构请参见下面的说明

onSuccess : function (opt) { alert(opt.context);},


//可选。
//需要用户授权时,展示授权对话框时的回调方法,其中opt.context为调用该接口时的context对象。

onShown : function (opt) { alert(opt.context);},


//可选。
//提醒发送出错时的回调方法,其中opt的参数结构请参见下面的说明

onError : function (opt) { alert(opt.context);},


//可选。
//需要用户授权时,用户关闭授权窗口或者取消授权时的回调方法,请先回调onCancel再回调onClose。
//其中opt的参数结构请参见下面的说明
onCancel : function (opt) { alert(opt.context); },


//可选。
//对话框关闭时的回调方法。
//主要用于对话框关闭后进行UI方面的调整,onSuccess和onCancel则用于应用逻辑的处理,避免过度耦合。

onClose : function (opt) { }


});

2.2 opt参数结构说明

在用户授权设置成功时的回调方法onSuccess中,opt的参数定义如下:

参数名称 描述
code 用户授权设置成功的返回码,返回值为“0”。
on 提醒的开关状态,返回值为“0”或“1”。

0:表示用户关闭了提醒;
1:表示用户开启了提醒。

context 透传参数,onSuccess回调时传入的参数,用于识别请求。


在提醒发送出错时的回调方法onError中,opt的参数定义如下:

参数名称 描述
code 提醒发送出错的返回码,返回值为非0的整数。

-1:查询设置状态失败;
100:用户已设置过提醒,无需再次设置;
2001:非法应用。

msg 表示提醒发送出错的提示消息。
context 透传参数,onError回调时传入的参数,用于识别请求。

3 联调说明

详见:QQ提醒渠道开发联调说明#2. 测试联调说明

4 效果展示

应用中放置QQ提醒设置入口,用户点击后,应用调用前台接口弹出授权弹框,询问用户是否要开启提醒。
用户点击“开启提醒”,开启QQ提醒。然后应用调用后台接口将提醒信息上报到后台。
用户点击“取消”,或直接关闭弹框,则忽略本次询问,相当于未设置QQ提醒。可下一次点击QQ提醒后在弹出中设置。
为了避免骚扰用户,授权的提示框只会在用户从来没有设置过QQ提醒的情况下弹出。用户一旦授权,后续都不会再弹出提示框。
fusion2.dialog.authReminder.png

详见:QQ提醒渠道简介#1.3 效果展示

相关文档

下一步:v3/spread/is_reminder_set

相关文档:QQ提醒渠道开发联调说明 | faq/QQ提醒渠道相关常见问题

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部