fusion2.dialog.recommendPal

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:推荐添加平台好友。
对于SNS类应用,如果用户在应用中的好友太少,就无法进行互动,从而导致用户流失。
应用如果发现用户在应用内的好友太少(可以通过“已安装了应用的好友”接口来判断用户的好友数量),可以调用本接口为用户推荐可以添加为好友的人。
3. 功能描述:
(1)调用本接口后在Fusion弹出框中列出平台推荐用户添加为好友的人的列表。
(2)用户可以自由选择列表中的用户,点击弹框底部的“添加好友”按钮后,即向目标对象发送添加为好友的请求。
(3)接收到好友申请的人会在对应的平台内收到好友申请tips,与用户在平台内正常加好友的tips保持一致。

4. 接口调用限制:
(1)支持的平台:本接口目前仅支持朋友平台。
(2)弹框限制:弹出框中显示的推荐好友最多为20个,若不足则留空。

5. 特别备注:
平台推荐用户添加为好友的人的算法为:
(1)不是当前用户的好友,但是是当前用户在该平台的2度或更广度的人脉;
(2)已经安装当前应用的用户。

2 场景说明

2.1 入口说明

应用在合适的地方放置添加好友的入口,用户点击后,即调用本接口,弹出“和可能认识的人一起玩”的弹框。

2.2 弹框效果展示

弹框中有如下元素:
(1)弹框中列出推荐添加的人,最多显示20个。
(2)弹框中会明确告诉用户,列表中的人也在玩这个应用,而且是你可能认识的人。
(3)单击弹框底部的“添加好友”按钮后,则会添加选择的人为实名朋友。
如下图所示:
fusion2.dialog.recommendPal.png


3 接口调用说明

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

3.1 参数说明

参数名称 是否必须 类型 描述
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.recommendPal(
{
    context : "recommendPal_12345", 


    onSuccess : function (opt) 
    { alert("Succeeded: " + opt.context); window.console && console.log(opt);}, 


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


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

})

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部