fusion2.dialog.addPal

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:在应用内添加平台好友。
3. 功能描述:
(1)调用本接口后,用户即可在应用内向某个人发送请求,添加为平台的好友。
(2)接收者收到请求消息后,点击消息即打开处理弹框,同意后即可相互添加为平台好友。
(3)用户不再需要去QQ空间内发送加好友的请求,直接在应用内就可以完成,这样可以方便用户拓展关系链,从而更进一步的拓展应用的用户安装量以及提升活跃度。
4. 接口调用限制:
支持的平台:本接口目前仅支持QQ空间平台。

2 场景说明

2.1 入口说明

在应用的合适地方放置入口,例如用户在应用内点击某个人的头像,出现“加为QQ好友”的链接。
用户点击“加为QQ好友”的链接,即出现“添加好友”的弹框。

2.2 弹框效果展示

弹框的体验与在QQ空间内加好友的弹框体验是类似的,对方可能需要申请者发送验证消息,或者需要回答设置的问题才能被加为好友。
弹框样式如下图所示:
fusion2.dialog.addPal.png

用户确认申请加对方为好友后,后台即发送“申请成为QQ好友”的申请到对方的QQ消息盒子,该消息与正常加QQ好友的消息体验是一样的。
接受者点击消息后即打开该请求并进行处理,如下图所示:
fusion2.dialog.addPal2.png


3 接口调用说明

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

3.1 参数说明

参数名称 是否必须 类型 描述
openid 必须 string 要添加为好友的人的openid。
context string 参数描述:透传参数,用于onSuccess和onCancel回调,以识别请求。

透传方式:调用本接口时传入该参数,onSuccess或onCancel回调时,在JS中使用opt.context即可获取该透传参数(opt为本接口的回调函数形参)。
例如用户操作成功后,会回调onSuccess时获取该参数的值:

onSuccess : function (opt) 
  {       
      alert("Succeeded: " + opt.context);  
  }
onSuccess 参数描述:用户操作成功后的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击弹出框中的“添加好友”按钮,提示成功,弹出框关闭。

onCancel 参数描述:用户取消操作后的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击取消或弹出框右上角的×按钮,弹出框关闭。用户取消时将同时关闭对话框,因此将先触发onCancel回调再触发onClose回调。

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

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击取消或弹出框右上角的×按钮,弹出框关闭。用户取消时将同时关闭对话框,因此将先触发onCancel回调再触发onClose回调。

3.2 调用示例

fusion2.dialog.addPal (

{
    openid : "95D8EDAC48EC5EC70D93083B3AAA05EF", 


    context : "addPal _12345", 


    onSuccess : function (opt) 
    { alert(fusion.JSON.stringify(opt)); },


    onCancel : function (opt) 
    { alert("Cancelled: " + opt.context); }, 


    onClose : function (opt) 
    { alert("Closed") }
})

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部