Social Overlay Overview

社交覆层（Social Overlay） 使用web技术，并通过 内容分发网络（CDN） 在全球范围内分发。这使我们能够独立于你的游戏所运行的Epic在线服务（EOS）SDK版本来推送新功能和修复错误。

EOS SDK会加载并初始化社交覆层，然后用户请求将最新版本的社交覆层部署到我们的CDN。EOS SDK和社交覆层通过网桥进行通信。初始化期间，EOS SDK会通知社交覆层你的EOS SDK所包含的功能。EOS SDK还会通知社交覆层你已启用或禁用的功能。

在某些极端情况下，服务可能会出现中断，这时Epic能够在社交覆层中启用或禁用功能，以便让用户在出现中断时获得良好的体验。请参阅导航条一节了解更多详情。

我们的目标是为使用社交覆层的用户，以及所有将游戏与社交覆层集成的开发人员提供最佳用户体验。为了给所有用户提供最佳体验，我们将在未来增加新功能并改进设计。核心功能总体上会保持稳定，但文本、外观、覆层的使用体验等方面将随着时间的推移不断改进和润色。

一旦应用加载并初始化社交覆层后，它会显示一条消息：你现已登录Epic社交面板。按下消息中显示的热键组合即可打开社交覆层。

当你首次打开社交覆层时，它会显示你的 好友列表。如果你导航到另一个页面，关闭再打开覆层，你会发现你会回到最后打开的那个页面上。为改善用户体验，这种情况将来可能会改变。

下表列出了社交覆层目前支持的所有语言。

导航条 允许用户导航至社交覆层中的不同页面。导航条中所列项目主要由EOS SDK版本和你的项目正在使用的功能决定。

当出现罕见的服务中断情况时，Epic可以隐藏导航条中的项目。例如，如果成就服务中断，Epic可以隐藏导航条上的“成就”按钮，直至问题解决。这是为了避免用户体验不佳，并防止用户产生混淆。

在 1.6及以上版本 的EOS SDK中，导航条顶部会显示 好友 图标。好友页面也是用户首次打开社交覆层时会显示的第一个页面。好友信息包含若干部分，每个部分都会显示关于好友列表的不同内容。

状态面板显示以下内容：

• 彩色 头像 和用户名称的首字母。
• 用户的 显示名称。
• 表示用户是否已启用 请勿打扰（Do Not Disturb） 的振铃图标。
• 用户的 可加入状态。
  • 可加入（Joinable） 代表“允许邀请”。
  • 不可加入（Not Joinable） 代表“不允许邀请”。

点击状态面板会打开一个设置屏幕，可在其中切换请勿打扰（Do Not Disturb）状态。启用请勿打扰（Do Not Disturb）后，你可以收到游戏邀请、朋友邀请、完成的成就等，但不会收到任何通知。

用户可以使用该组件筛选其完整的好友列表。用户键入文字的过程中，社交覆层将筛除显示名称与输入内容不匹配的好友。还会高亮显示与用户输入内容匹配的子字符串。

第一个好友区域显示来自用户好友的邀请。首先显示此列表是为了在接收和接受邀请时方便使用，但此列表中的好友也会显示在好友列表的其余部分的相应位置。

对于每个邀请，用户有两个对应的操作；接受（Accept） 或 拒绝（Decline）（表现为带 X 图标的按钮）。用户点击这些按钮后，按钮可能短时间内会处于禁用状态，此时EOS SDK会处理用户请求的操作。如果任一操作期间发生错误，系统会显示错误通知。

第二个好友区域会列出正在和本地用户玩同一个游戏的好友。社交覆层通过比较用户的“应用程序id”与用户好友的 应用程序id，确定归属于这一区域的好友。如果匹配，好友会显示在好友列表的这一区域。

用户将始终显示在此列表顶部，其显示名称末尾附有一个“你（YOU）”的标签。如果用户和其他好友在一个“组”中，他们将互相覆盖，没有操作（参见同组好友）。

此区域按以下顺序排序：

1. 你（当前用户）
2. 同组好友，以字母顺序显示名称
3. 其他好友，以字母顺序显示名称

与用户同一 组（例如，他们处于同一方或同一会话）的好友将列示在此处，并聚集在一起代表其好友组。与此区域列示的其他好友不同，这些用户没有操作。

与你不在同一组的好友将会填充你的剩余 游戏中（Playing） 好友区域。每个用户名旁边会显示两个操作按钮；加入（Join） 和 邀请（Invite）。

如果该好友当前不处于可加入状态，“加入（Join）”按钮会被禁用。

如果该好友不允许邀请，“邀请（Invite）”按钮会被禁用。

用户执行操作后，两个按钮都可能显示为禁用状态，以便EOS SDK处理请求的操作。如果任一操作期间发生错误，系统会发出错误通知。

好友列表最后一个区域显示不符合之前条件的用户好友。这包括但不限于正在玩其他游戏的好友，在启动器中等待的好友，以及当前离线的好友。

此区域按以下顺序排序：

1. 好友的在线状态
   1. 在线
   2. 离开
   3. 长时间离开
   4. 离线
2. 按字母顺序显示好友名称

如果在1.7及以上版本的EOS SDK中使用 成就，以下图标将添加到导航条，用于将用户导航至成就区域。

成就页面会列出与你游戏相关的所有成就以及相关用户的进度。

此组件显示“已完成”成就数与总成就数的对比。

用户可以使用该组件筛选完整的成就列表。用户键入文字过程中，社交覆层将筛除所有“标题”和“说明”字段与输入内容不匹配的成就。

进行中 的成就是列表中显示的第一组成就。此类型的成就会显示以下内容：

• 锁定的图标
• 锁定的标题
• 锁定的说明
• 显示待完成%的进度条

如果未设置图标或加载图标失败，下列图标会使用默认值：

已完成 的成就是列表中显示的第二组成就。此类型的成就会显示以下内容：

解锁图标 解锁标题 解锁说明

如果未设置图标或加载图标失败，会默认显示以下图标：

锁定 成就是列表中显示的第三组成就。此类型的成就会显示以下内容：

• 锁定图标
• 锁定标题（带锁定图标后缀）
• 锁定说明

如果未设置图标或加载图标失败，默认显示以下图标：

隐藏 的成就是列表中显示的第三组（最后一组）成就。此类型的成就会显示以下内容：

• 锁定的图标
• 本地化的“隐藏成就”标题

如果未设置图标或加载图标失败，默认显示以下图标：

社交覆层完全初始化并准备好打开时，系统会显示 就绪 通知。

用户好友邀请用户玩游戏时，系统会显示 游戏邀请 通知。

当用户符合获得某项成就的条件时，会显示 **成就完成 ** 通知。

成就类型的回退规则同样适用于此通知中的图标。

用户发出请求并发生错误时，系统会显示 错误 通知。此通知将尝试提供背景信息和本地化的错误消息，但可能会回退至一条通用的本地化错误消息。