浏览 SDKs · Android
平台
SDKsAndroid

设置群组扩展字段

设置并保存群组的自定义业务扩展字段。

复制

设置群组的自定义业务扩展属性。在 GroupInfo 中指定 ex 字段,可保存与群组绑定的自定义业务数据(例如 JSON 格式的业务元信息)。服务端会对传入的字符串进行全量覆盖保存,客户端更新时应传入完整的扩展数据。

GroupInfo update = new GroupInfo();
update.setGroupID("group_123");
update.setEx("{\"projectCode\":\"mobile\",\"archived\":false}");

OpenIMClient.getInstance().groupManager.setGroupInfo(
    update,
    new OnBase<String>() {
        @Override
        public void onSuccess(String data) {
            // 扩展字段更新成功
        }

        @Override
        public void onError(int code, String error) {
            // 处理更新失败
        }
    }
);

参数说明

参数类型是否必填说明
groupInfoGroupInfo是群资料对象,必须指定目标 groupID 以及新的扩展信息字符串 ex。
baseOnBase<String>是异步请求回调。

返回结果

成功回调中的 data 返回确认信息。

扩展字段更新成功后,群内成员随后将收到 onGroupInfoChanged 事件通知,返回更新后的 GroupInfo。客户端应以 groupID 为标识合并群资料中的 ex 字段;完整监听见群组概览。