SDKsiOS

设置会话扩展字段

使用 iOS SDK 设置会话扩展字段。

为会话设置业务自定义的扩展字符串：

参数说明

参数	类型	说明
`conversationID`	`NSString *`	目标会话 ID。
`ex`	`NSString *`	业务自定义扩展字符串（通常为 JSON 格式）。

NSString *ex = @"{\"category\":\"work\",\"tag\":\"important\"}";

[[OIMManager manager] setConversationEx:@"c2c_user1002"
                                     ex:ex
                              onSuccess:^(NSString * _Nullable data) {
                                  NSLog(@"setConversationEx success");
                              }
                              onFailure:^(NSInteger code, NSString *message) {
                                  NSLog(@"setConversationEx failed: %ld %@", (long)code, message);
                              }];

状态以 conversationID 为合并标识。

返回结果

成功回调 onSuccess 返回操作结果。

操作成功后，会话属性变更会通过 onConversationChanged: 事件广播，客户端按 conversationID 更新对应会话的 ex 扩展字段。

ex 为全量覆盖的自定义字符串，SDK 不会自动解析或合并 JSON 内部键值。更新前如需保留已有业务字段，建议先拉取当前会话资料合并后再行保存。会话列表监听配置参见获取会话列表。

这个页面有帮助吗？