好友状态不是一个绿点
好友列表里那个在线绿点背后有很多状态：在线、离线、游戏中、组队中、匹配中、观战中、隐身、忙碌、跨服不可邀请、版本不一致。玩家点击邀请时，期待的是“能不能一起玩”的答案，而不是一个模糊的在线标记。
客户端社交系统的难点在于状态变化频繁，来源又多。好友上线会推送，切场景会推送，玩家隐私设置会影响展示，组队系统也会改变可邀请性。如果每个界面自己判断好友能否邀请，最后一定会出现大厅能邀、好友页不能邀、聊天里显示错误状态的问题。
flowchart TD
A[好友基础资料] --> D[好友展示模型]
B[在线状态推送] --> D
C[组队/场景状态] --> D
E[隐私与黑名单] --> D
D --> F[好友列表]
D --> G[聊天头像]
D --> H[邀请按钮]
H --> I[邀请事务]
I --> J[目标确认/拒绝/超时]
展示状态和可邀请状态分开
好友显示“在线”不代表可邀请。对方可能正在排位、剧情、教学、跨服活动或版本更新中。客户端应该生成两个结果：展示状态用于列表文案，可邀请状态用于按钮。展示可以写“游戏中”，按钮原因则是“对方正在比赛，暂不可邀请”。
这两个结果最好来自同一个 FriendPresenceModel。它合并在线、场景、队伍、隐私、黑名单、版本号等信息。UI 只消费模型，不直接读推送字段。这样聊天、好友列表、组队面板看到的是一致状态。
状态还要带过期时间。推送可能丢失，好友列表长期不刷新会显示旧状态。客户端可以给 presence 设置 TTL，超过时间后标记为待刷新，必要时主动拉一次。不要让一个好友三小时前的“在线”一直挂着。
邀请是双向事务
邀请不是发一条消息那么简单。发起方要锁定按钮、显示等待；接收方要弹出邀请、判断当前场景能否接受；服务端要处理过期、拒绝、已组队、队伍满员；发起方还要收到结果。任何一环失败，都需要可理解的反馈。
邀请请求应该带邀请 ID、玩法类型、队伍 ID、发起人、过期时间和版本信息。接收方点击接受时，服务端根据最新状态决定是否加入。客户端不能因为接收方点了接受就本地直接进队。
发起方按钮的冷却也要合理。玩家连续邀请同一好友会很烦。可以在邀请未过期前显示“等待回应”，允许取消或稍后再邀。对不同好友则可以继续邀请，但要避免群发骚扰。
接收弹窗要尊重当前场景
玩家在战斗中收到邀请，不应该弹大窗挡操作。可以放入轻提示或战斗后提醒。玩家在剧情中、结算中、支付中时，也要延后或静默。邀请弹窗的优先级应低于安全和核心玩法。
接收方还需要看到足够信息：谁邀请、邀请什么玩法、队伍人数、是否会离开当前场景。接受可能导致退出副本或中断活动时，要二次确认。拒绝则应快速，不要让玩家为拒绝付出太多操作。
隐私设置也要生效。玩家设置“仅好友可邀”“拒绝陌生人邀请”“忙碌模式”后，客户端展示和服务端校验都要一致。客户端可以减少无效弹窗，但最终由服务端拦截。
跨场景跳转要有预检
接受邀请后，客户端可能需要离开当前地图、下载玩法资源、切换服务器、进入队伍大厅。这个过程如果直接跳，会产生很多失败：资源缺失、等级不足、版本不一致、活动未开放、当前状态不可离开。
建议在接受前做轻量预检：本地模块是否可用、玩家是否满足基础条件、当前场景是否允许跳出。预检通过后发送接受请求，服务端确认后再进入跳转流程。预检失败时直接提示，不让邀请进入复杂事务。
跳转过程中要显示清楚的状态，比如“正在加入队伍”“正在下载玩法资源”“队伍已满”。如果失败，应回到原场景或安全大厅，并保留一条可重试提示。
列表性能也要注意
好友数量多时，在线状态频繁更新会导致列表不断重排。玩家正在找某个好友，列表突然跳动很烦。可以把排序分为手动刷新和轻量更新：在线状态图标实时变，列表大排序在打开页面时或用户下拉刷新时更新。
搜索结果也要稳定。输入昵称搜索时，presence 更新不应清空搜索。头像、等级、签名可以懒加载，在线状态优先显示。社交列表是高频 UI，流畅比一次展示所有细节更重要。
失败提示要具体
邀请失败如果只提示“发送失败”，玩家不知道该怎么做。常见原因包括：对方离线、对方忙碌、对方已在队伍、队伍已满、玩法未解锁、版本不一致、跨服不可邀请、邀请过于频繁。客户端应根据服务端错误码给出具体文案。
同时要避免暴露隐私。对方隐身时，不应提示“对方隐身中”，而是显示对方暂不可邀请。隐私和可解释之间要有边界。
小结
好友在线与邀请的体验，关键在于一致和可解释。客户端把 presence 模型、可邀请状态、邀请事务、场景优先级和跳转预检做好，玩家就不会觉得社交状态像随机结果。社交系统越自然，组队转化也越稳定。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
好友调试工具可以显示每个好友的原始在线状态、合成展示状态、不可邀请原因和最近一次邀请结果。它能直接定位“为什么按钮灰了”这种高频问题，也能帮助服务端校验推送是否及时。
继续阅读
探索更多技术文章
浏览归档，发现更多关于系统设计、工具链和工程实践的内容。