WuKongIM Docs

公共数据字典

查阅与当前源码校准的 Channel Type、Device Flag、Message Flags 和 Reason Code。

编辑此页报告文档问题

目标与完成标准

本区域集中维护客户端 SDK、Gateway 和兼容 HTTP 响应复用的 Wire 值。Phase 13 在 Reason Code 之外发布 Channel Type、Device Flag / Level 与 Message Flags,帮助集成者跨语言核对数值和行为边界。

兼容目标

所有表都与当前 Go 权威定义对齐并由测试检查名称、值或位序。它们属于当前源码快照;兼容性快照仍只证明 JavaScript 黄金场景,不自动证明每个 SDK 平台。

前置条件

  • 数值是 Wire 合同,名称用于可读诊断;
  • 不把“枚举中存在”解释为“当前 SDK 已发布完整能力”;
  • 遇到未知值时保留原始数字并 fail closed。

已发布字典

预期结果

开发者应按数值匹配,并同时记录字典名称、协议阶段与兼容快照。应用代码不手写分散的魔法数字;由 SDK 类型或一个内部共享模块映射。

失败诊断

  • 名称与数值不一致:让校验失败并重新校准,不要手工维护第二张表。
  • 功能存在于字典但 SDK 找不到入口:该平台能力可能仍未发布,按精确版本文档确认。
  • 收到表外数值:记录数值和兼容快照,升级字典前保持 fail closed。

安全与责任边界

Wire 字典不是授权,也不是适合直接展示给最终用户的本地化文案。业务服务应映射安全含义,避免暴露内部拓扑、权限策略或敏感请求内容。

下一步

Channel TypeDevice Flag建立身份,再用 Message FlagsReason Code解释消息结果。

本页内容