跳到主要内容

设置会话共享配置​

POST /jim/converconfs/set

有效 legacy/ds1 用户身份;API Key、内部 svc 均不可写。身份、会话权限、sub_channel 规则见 获取配置。单聊任一方可改,群聊每个当前成员都可改,不限群主/管理员。

{
"target_id":"user_456",
"conver_type":1,
"sub_channel":"",
"confs":{
"msg_life_time":86400000,
"forbid_forward":true,
"content_protection":false,
"watermark_enabled":true
}
}
confs 键类型说明
msg_life_time非负精确整数沿用旧值,最大 9223372036854775807,不新增菜单限制或转换
forbid_forwardbool禁止转发的会话共享配置,默认 false
content_protectionbool内容保护的会话共享配置,默认 false
watermark_enabledbool水印的会话共享配置,默认 false

POST 采用部分更新语义,confs 非空,未传键不变。三个 bool 彼此独立,false 可正常保存。字符串、数字、null 不能作为 bool;生命周期不接受负数、小数、字符串、null 或 int64 溢出值。未知键(含外层字段)或任一非法值使整个请求失败 17003。全部键验证及授权完成后事务 upsert,混合请求不会部分写入。DB 错误返回 17000。其它权限错误同 GET。成功:

{"code":0,"msg":"success","data":null}

配置变更通知:服务端事务 outbox​

SET 在同一事务保存配置、递增 scope version、写入唯一 event_id;失败全部回滚,无实际变化不产生事件。成功表示配置及任务已持久化,不代表所有成员已收到。worker 发送已注册 jgd:lifetime_msg,存储、不计未读、通知发送者。升级 iOS 已删除 ApiManager bool 主动发送和 ViewModel 生命周期发送 helper。

通知结构示例:

{"event_id":"d5963ea7-3648-4c68-aa20-c672e48d8991","version":9,"scope":{"app_key":"app","conver_id":"user_123:user_456","conver_type":1,"sub_channel":""},"actor_id":"user_123","target_id":"user_456","type":7,"raw_config":{"msg_life_time":7,"forbid_forward":true,"content_protection":false,"watermark_enabled":true},"changed_keys":["forbid_forward"],"confs":{"forbid_forward":true,"content_protection":false,"watermark_enabled":true}}

event_id 为 UUID,version 由 DB scope 锁递增,不取时钟。scope 包含 app/会话类型/规范会话 ID/子频道;单聊双方 ID 排序后以冒号连接,群聊为群 ID。raw_config 和 type 均保留生命周期原始整数。所有事件(包括 bool-only)必须带 type,未存则为 0;旧端沿用 0/1/7/30/90/180 菜单或其它原值秒数解释,不猜毫秒或更改单位,不允许缺失 type 被旧 decoder 当作关闭。涉及 bool 变化时 confs 是三个 bool 的快照,生命周期单独变化可省略它。

scope 表以与 converconfs 相同的 utf8mb4_0900_ai_ci SQL unique 判定 app/conver_id/sub_channel 等价,冲突后按该键查询固定 row scope_id 再锁;hash 仅首次候选 PK。THREAD/thread、重音等价共享版本,尾空格按该 NO PAD collation 区分;不做 lower/trim,不更改原表为 binary。非标准部署 collation 须先核对。

可靠性是至少一次(at-least-once),不是 IM exactly-once。worker 以 lease 恢复崩溃、claim token 隔离旧 owner,失败无限重试且退避上限 512 秒;同 scope 不越过未完成前驱,独立 scope 可继续。HTTP 超时可能已经送达,无法约束上游晚执行/重复;没有已核实的 msg_id 幂等保证。

升级 iOS 将新事件及旧 {"type":菜单值} 都只当刷新提示,以自身权限 GET 权威配置,刷新生命周期缓存并发布 ConversationSharedConfigDidChangeNotification。普通客户端能伪造消息版本/事件,无来源证明不采信 payload 水位,也不据此过滤 GET;只持久化 GET _config_meta 中已确认 version/event_id,在 GET 后去重应用。串行 GET、合并提示,拒绝过时和跨登录 session 响应。失败任务保留,以可取消的 1 至 60 秒封顶退避重试;失败不写水位,session reset 清队列并取消 timer。缓存 key 按 app/user/会话隔离,不读取归属未知的旧 key。进入会话仍 GET 补齐,不应重做 SET。TTL 沿用既有 day-menu/seconds 映射。

sub_channel 在 DB 独立存储,但当前 SDK 不支持通知子频道路由;升级接收端忽略非空子频道,不可误改主会话。其它客户端也必须如此处理或实现完整路由。

旧 App 仍主动发通知,滚动升级期间可能与服务端双发;旧接收端只理解 type,晚到旧通知可能覆盖新状态,也不会执行三个新策略。升级接收端只 GET,不采信旧 payload;这不消除旧设备的重复显示。上线须先执行 20261111.sql(InnoDB,MySQL 8.0+)再统一切换服务端/worker,回滚保留事件和版本表。本次未迁移业务库、未部署。还需双设备联调发送者同设备/多设备、单聊反向、群普通成员、离线恢复、超时重复及账号切换,不能将离线测试视为实际 IM 验收。

客户端执行边界​

本次实际范围是共享配置、服务端权限和最小 iOS 通知链路。三个开关 UI、转发入口拦截、内容保护遮挡/检测、水印绘制仍需客户端适配;不表示已由服务端强制执行。截图/录屏限制依赖平台能力,不能保证所有端和旧端禁录,也不能阻止外部设备拍摄。水印内容和样式由客户端设计。