Discord 社交 SDK

info

本功能仅提供数据访问，不提供 UI。需根据 Discord UI 设计规范 自行设计界面。

Discord 社交 SDK 实现玩家与 Discord 好友的跨平台互动，增强游戏社交体验。

独立性：社交功能与登录功能互相独立，可登录任意渠道并绑定 Discord 好友关系。

主要功能

• 好友管理：列表、添加、删除、请求处理
• 文字聊天：向 Discord 好友发送消息
• 游戏状态：通过 Rich Presence 展示活动信息
• 游戏邀请：通过大厅发起邀请
• 语音聊天：暂未集成（如需使用请联系我们）

接入流程

功能详情

note

暂不支持 Discord 临时账号授权。使用前需引导玩家绑定 Discord 账号并授权 OAuth2 Scope。

好友列表

展示内容：

• 基本信息：ID、用户名、头像、在线状态等
• 好友类型：平台好友、同玩好友

支持操作：

• 添加/删除/屏蔽好友
• 管理好友请求

info

Discord 返回的列表无序。Player Network 提供 OpenID 最近在线时间供游戏排序。

文字聊天

note

接入此功能需在上线前向 Discord 额外说明，以开启现网权限。

• 游戏内向游戏外 Discord 好友发送消息
• Discord 不提供敏感词过滤，需游戏自行实现

游戏状态（Rich Presence）

功能：

• 显示游戏活动详情：状态、进度、自定义图标、互动按钮
• 好友可通过按钮加入游戏

配置要求：在 Discord 应用设置上传美术资源

游戏邀请

实现方式：

• 通过设置游戏状态 + 大厅功能实现跨平台邀请
• 大厅：可通过文本和语音交流的虚拟空间

流程示例：

1. 玩家开始游戏 → 自动创建大厅
2. 发布 Rich Presence → 设置加入密钥
3. 好友看到 Rich Presence → 请求加入
4. 请求通过 → 好友加入大厅