好友功能介绍
产品简介
TapTap 开发者服务（简称 TDS）为游戏提供了完整的好友解决方案，支持游戏灵活调用各类功能接口，帮助游戏快速形成社交网络，助力游戏运营。
产品优势
一站式接入好友能力，提升开发效率
好友产品为游戏开发者提供完整的添加、删除、查找好友的功能接口，游戏无需自建好友系统，大大降低开发成本。
数据实时追踪，精细化运营提升体验
开发者后台提供丰富的管理功能，支持开发者查询玩家的好友关系、接口调用等数据，帮助开发者实时管理玩家数据，跟踪好友接口使用情况。
连接 TapTap 生态，基于社交关系带动游戏活跃
游戏可获取到 TapTap 的互相关注好友关系，并用于丰富游戏的社交关系链，完成上线开黑、组队约玩、社交冷启等提升游戏体验。
概念解释
游戏好友
基于 TDS 内建账户系统，提供添加、删除、查找好友关系等接口。游戏好友关系模型分为「关注模式」和「好友模式」。
关注模式
玩家 A 可自主关注玩家 B，此时 A 为 B 的粉丝，B 为 A 的关注。此时如果 B 回关了 A，那么 A 和 B 称为互相关注关系。
好友模式
当玩家 A 添加玩家 B 为好友时，需要先发出加好友的申请添加好友申请，玩家 B 同意好友申请，AB 即为好友关系。
开发者仅可选择「关注模式」、「好友模式」其中一种好友模型接入，不可二者同时接入。
TapTap 平台好友
针对使用 TapTap 账号登录用户，支持获取 TapTap 同玩互关好友列表，作为游戏好友来源。详情请参考 TapTap 好友。
使用游戏好友需要接入 TDS 内建账号系统。
能力说明
游戏好友
关注模式
| 能力名称 | 应用场景 |
|---|---|
| 获取关注列表 | 提供获取用户关注列表接口，支持开发者查询当前用户的关注列表 |
| 获取互关列表 | 提供获取用户互关列表接口，支持开发者查询当前用户的关注列表 |
| 获取黑名单列表 | 提供获取用户黑名单列表接口，支持开发者查询当前用户的黑名单列表 |
| 添加关注 | 提供关注好友的接口，支持玩家在主页社交列表、游戏结算等场景直接关注对方 |
| 取消关注 | 提供取消关注的功能接口，支持玩家取消关注来解除关系 |
| 添加拉黑 | 提供添加拉黑的接口，支持玩家在主页社交列表、游戏结算等场景直接拉黑对方（当前黑名单最大限制为 100，暂不支持可配置） |
| 取消拉黑 | 提供取消拉黑的接口，支持玩家从黑名单中取消拉黑对方 |
| 查询并关注玩家 | 支持通过搜索昵称、好友码（每个玩家拥有唯一的 6 位纯小写好友码）、objectId 来查找并关注玩家 |
| 分享邀请关注 | 支持用户分享邀请关注链接至三方社交平台，邀请他人在游戏内关注自己 |
| 获取粉丝列表 | 提供获取用户粉丝列表接口，支持开发者查询当前用户的粉丝列表 |
| 富信息 | 富信息用于呈现玩家状态等信息，如在线状态、正在使用哪个英雄、正处于哪个游戏模式等 |
| 支持按照在线状态排序 | 关注列表，互关列表支持根据用户在线状态进行排序。（粉丝列表暂不支持） |
好友模式
| 能力名称 | 应用场景 |
|---|---|
| 获取好友列表 | 提供获取好友列表接口，支持开发者查询当前用户的好友列表 |
| 查询好友关系 | 提供查询好友关系接口，支持开发者在游戏的不同场景内查询不同玩家之间是否为好友 |
| 添加好友 | 提供发送申请添加好友的接口，支持游戏在玩家主页、游戏结算等场景直接申请添加对方为好友。同时支持玩家查看自己收到的添加好友申请玩家列表 |
| 查询并添加好友 | 支持通过搜索昵称、好友码（每个玩家拥有唯一的 6 位纯小写好友码）、objectId 来查找并添加好友 |
| 分享邀请添加好友 | 支持用户分享邀请好友链接至三方社交平台，邀请他人在游戏内成为自己的好友 |
| 删除好友 | 提供删除好友的功能接口，支持玩家删除好友来解除关系 |
| 查询好友申请列表 | 提供查询好友申请列表接口，支持开发者获取某个玩家收到好友申请的所有玩家列表 |
| 同意成为好友 | 提供同意成为好友接口，支持玩家收到好友申请后，同意成为好友 |
| 拒绝成为好友 | 提供拒绝成为好友接口，支持玩家收到好友申请后，拒绝成为好友 |
| 获取黑名单列表 | 提供获取用户黑名单列表接口，支持开发者查询当前用户的黑名单列表 |
| 添加拉黑 | 提供添加拉黑的接口，支持玩家在主页社交列表、游戏结算等场景直接拉黑对方（当前黑名单最大限制为 100，暂不支持可配置） |
| 取消拉黑 | 提供取消拉黑的接口，支持玩家从黑名单中取消拉黑对方 |
| 按照在线状态排序 | 好友列表支持根据用户在线状态进行排序 |
| 设置好友数量上限 | 可在控制台（开发者中心 > 游戏服务 > 云服务 > 好友 > 设置）配置「游戏内支持玩家最多添加的好友数量」，最大可配置为 2000 |
| 富信息 | 富信息用于呈现玩家状态等信息，如在线状态、正在使用哪个英雄、正处于哪个游戏模式等 |
收费方案
- 游戏好友服务根据接口请求次数计费，接口请求次数合并统计至数据存储服务，共享每天 3 万次免费额度，超出部分 1.0 元 / 万次。
常见 Q&A
Q：可以同时接入「关注模式」和「好友模式」两种好友模型吗？
A：不可以，开发者仅能选择一种好友模型接入，接入前请谨慎选择。
Q：「关注模式」下有关注上限吗？
A：有，关注模式下单个游戏最多支持关注 5000 人，关注限制暂不支持调整以及后台配置。
Q：分享链接邀请文案可支持自由配置吗？
A：支持；建议「关注模式」下文案为「xx 邀请你关注 Ta」，「好友模式」下文案为「xx 邀请你成为好友」。
如上述 FAQ 不能解答你的问题，欢迎前往开发者中心导航栏右上角提交工单联系我们。