文档中心

上云无忧 > 文档中心 > 环信IM即时通讯使用教程（Android） - 管理聊天室属性
环信
IM即时通讯
简介/价格/文档
环信IM即时通讯使用教程（Android） - 管理聊天室属性

文档简介：
聊天室是支持多人沟通的即时通讯系统。聊天室属性可分为聊天室名称、描述和公告等基本属性和自定义属性（key-value）。若聊天室基本属性不满足业务要求，用户可增加自定义属性并同步给所有成员。利用自定义属性可以存储直播聊天室的类型、狼人杀等游戏中的角色信息和游戏状态以及实现语聊房的麦位管理和同步等。聊天室自定义属性以键值对（key-value）形式存储，属性信息变更会实时同步给聊天室成员。
*此产品及展示信息均由环信官方提供。免费试用 咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！ 微信咨询
  免费试用、价格特惠

聊天室是支持多人沟通的即时通讯系统。聊天室属性可分为聊天室名称、描述和公告等基本属性和自定义属性（key-value）。若聊天室基本属性不满足业务要求，用户可增加自定义属性并同步给所有成员。利用自定义属性可以存储直播聊天室的类型、狼人杀等游戏中的角色信息和游戏状态以及实现语聊房的麦位管理和同步等。聊天室自定义属性以键值对（key-value）形式存储，属性信息变更会实时同步给聊天室成员。

本文介绍如何管理聊天室属性信息。

技术原理

环信即时通讯 IM SDK 提供 EMChatRoomManager 类和 EMChatRoom 类用于聊天室管理，支持你通过调用 API 在项目中实现如下功能：

  • 获取和更新聊天室基本属性；
  • 获取聊天室自定义属性；
  • 设置聊天室自定义属性；
  • 删除聊天室自定义属性。

前提条件

开始前，请确保满足以下条件：

  • 完成 SDK 初始化，详见 快速开始；
  • 了解环信即时通讯 IM 的 使用限制；
  • 了解聊天室的数量限制，详见 套餐包详情 (opens new window)。

实现方法

管理聊天室基本属性

对于聊天室名称和描述，你可以调用 fetchChatRoomFromServer 方法获取聊天室详情时查看。

获取聊天室公告

聊天室所有成员均可调用 fetchChatRoomAnnouncement 方法获取聊天室公告。

示例代码如下： 

// 同步方法，会阻塞当前线程。 // 异步方法为 asyncFetchChatRoomAnnouncement(String, EMValueCallBack)。
 String announcement = EMClient.getInstance().chatroomManager().fetchChatRoomAnnouncement(chatRoomId);
 

更新聊天室公告

仅聊天室所有者和聊天室管理员可以调用 updateChatRoomAnnouncement 方法设置和更新聊天室公告，聊天室公告的长度限制为 512 个字符。公告更新后，其他聊天室成员收到 onAnnouncementChanged 回调。

示例代码如下： 

// 同步方法，会阻塞当前线程。 // 异步方法为 asyncUpdateChatRoomAnnouncement(String, String, EMCallBack)。
 EMClient.getInstance().chatroomManager().updateChatRoomAnnouncement(chatRoomId, announcement);
 

修改聊天室名称

仅聊天室所有者和聊天室管理员可以调用 changeChatRoomSubject 方法设置和修改聊天室名称，聊天室名称的长度限制为 128 个字符。

示例代码如下： 

// 同步方法，会阻塞当前线程。 // 异步方法为 asyncChangeChatRoomSubject(String, String, EMValueCallBack)。 
EMChatRoom chatRoom = EMClient.getInstance().chatroomManager().changeChatRoomSubject(chatRoomId, newSubject);
 

修改聊天室描述

仅聊天室所有者和聊天室管理员可以调用 changeChatroomDescription 方法设置和修改聊天室描述，聊天室描述的长度限制为 512 个字符。

示例代码如下： 

// 同步方法，会阻塞当前线程。 // 异步方法为 asyncChangeChatroomDescription(String, String, EMValueCallBack)。
 EMChatRoom chatRoom = EMClient.getInstance().chatroomManager().changeChatroomDescription(chatRoomId, newDescription);
 

管理聊天室自定义属性（key-value）

获取聊天室指定自定义属性

聊天室所有成员均可调用 asyncFetchChatroomAttributesFromServer 方法获取聊天室指定自定义属性。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId     聊天室 ID。
 * @param List<String> keyList      聊天室自定义属性的 Key 列表。传 `null` 返回所有自定义属性。
 * @param callBack                  结果回调，成功时回调 {@link EMValueCallBack#onSuccess(Object)}，
 *                                  失败时回调 {@link EMValueCallBack#onError(int, String)}。
 */ EMClient.getInstance().chatroomManager().asyncFetchChatroomAttributesFromServer( conversationId, keyList,
 new EMValueCallBack<Map<String, String>>() { @Override public void onSuccess(Map<String, String> value)
 { } @Override public void onError(int error, String errorMsg) { } });
 

获取聊天室所有自定义属性

聊天室成员可以调用 asyncFetchChatRoomAllAttributesFromServer 方法获取聊天室所有自定义属性。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId     聊天室 ID。
 * @param callBack                  结果回调，成功时回调 {@link EMValueCallBack#onSuccess(Object)}，
 *                                  失败时回调 {@link EMValueCallBack#onError(int, String)}。
 */ EMClient.getInstance().chatroomManager().asyncFetchChatRoomAllAttributesFromServer( conversationId, 
new EMValueCallBack<Map<String, String>>() { @Override public void onSuccess(Map<String, String> value)
 { } @Override public void onError(int error, String errorMsg) { } });
 

设置单个聊天室属性

聊天室成员可以调用 asyncSetChatroomAttribute 方法设置单个聊天室自定义属性。该方法只可添加新自定义属性字段和更新自己设置的现有属性。设置后，其他聊天室成员收到 onAttributesUpdate 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String  conversationId        聊天室 ID。
 * @param String  attributeKey          聊天室属性的 key。
 * @param String  attributeValue        聊天室属性的 value。
 * @param boolean autoDelete            当前成员退出聊天室时是否自动删除该聊天室中其设置的所有自定义属性。
 *       - （默认）`true`：是；
 *       - `false`：否。
 */ EMClient.getInstance().chatroomManager().asyncSetChatroomAttribute( conversationId, attributeKey, 
attributeValue, autoDelete, new EMResultCallBack<Map<String, String>>() { @Override public void onSuccess()
 { } @Override public void onError(int error, String errorMsg) { } });
 

若要覆盖其他聊天室成员设置的自定义属性，需调用 asyncSetChatroomAttributeForced 方法。设置后，其他聊天室成员收到 onAttributesUpdate 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String  conversationId        聊天室 ID。
 * @param String  attributeKey          聊天室属性的 key。
 * @param String  attributeValue        聊天室属性的 value。
 * @param boolean autoDelete            当前成员退出聊天室时是否自动删除该聊天室中其设置的所有自定义属性。
 *       - （默认）`true`：是；
 *       - `false`：否。
 */ EMClient.getInstance().chatroomManager().asyncSetChatroomAttributeForced( conversationId, attributeKey, 
attributeValue, autoDelete, new EMResultCallBack<Map<String, String>>() { @Override public void onSuccess() 
{ } @Override public void onError(int error, String errorMsg) { } });
 

设置多个聊天室自定义属性

聊天室成员可以调用 asyncSetChatroomAttributes 方法设置多个聊天室自定义属性。该方法只能添加新属性字段以及更新当前用户已添加的属性字段。设置后，其他聊天室成员收到 onAttributesUpdate 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId             聊天室 ID。
 * @param Map<String,String> attributeMap   聊天室自定义属性集合，为键值对（key-value）结构。
 * @param boolean autoDelete                当前成员退出聊天室时是否自动删除该聊天室中其设置的所有自定义属性。
 *       - （默认）`true`：是；
 *       - `false`：否。
 */ EMClient.getInstance().chatroomManager().asyncSetChatroomAttributes( conversationId, attributeMap,
 autoDelete, new EMResultCallBack<Map<String, Integer>>() { @Override public void onResult(int code, 
Map<String, Integer> value) { if (code == EMError.EM_NO_ERROR) { // onResult 返回值 code 为 EMError.EM_NO_ERROR，
表明自定义属性成功添加。 }else { // onResult 返回值不为 EMError.EM_NO_ERROR，表明一些自定义属性因长度超限等原因添加失败。 } } });
 

若要覆盖其他聊天室成员设置的自定义属性，需调用 asyncSetChatroomAttributesForced 方法。设置后，其他聊天室成员收到 onAttributesUpdate 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId             聊天室 ID。
 * @param Map<String,String> attributeMap   聊天室自定义属性集合，为键值对（key-value）结构。
 * @param boolean autoDelete                当前成员退出聊天室时是否自动删除该聊天室中其设置的所有自定义属性。
 *       - （默认）`true`：是；
 *       - `false`：否。
 */ EMClient.getInstance().chatroomManager().asyncSetChatroomAttributesForced( conversationId, attributeMap,
 autoDelete, new EMResultCallBack<Map<String, Integer>>() { @Override public void onResult(int code, Map<String,
 Integer> value) { if (code == EMError.EM_NO_ERROR) { // onResult 返回值 code 为 EMError.EM_NO_ERROR，
表明自定义属性成功添加。 }else { // onResult 返回值不为 EMError.EM_NO_ERROR，表明一些自定义属性因长度超限等原因添加失败。 } } });
 

删除单个聊天室自定义属性

聊天室成员可以调用 asyncRemoveChatRoomAttributeFromServer 方法删除单个聊天室自定义属性。该方法只能删除自己设置的自定义属性。删除后，聊天室其他成员收到 onAttributesRemoved 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId     聊天室 ID。
 * @param String key                聊天室属性的 key。
 * @param callBack                  结果回调，回调 {@link EMResultCallBack#onResult(int, Object)}。
 */ EMClient.getInstance().chatroomManager().asyncRemoveChatRoomAttributeFromServer( conversationId, key,
 new EMResultCallBack<Map<String, Integer>>() { @Override public void onResult(int code, Map<String, Integer> value) { } });
 

若要删除其他聊天室成员设置的自定义属性，需调用 asyncRemoveChatRoomAttributeFromServerForced 方法。删除后，聊天室其他成员收到 onAttributesRemoved 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId     聊天室 ID。
 * @param String key                聊天室属性的 key。
 * @param callBack                  结果回调，成功时回调 {@link EMResultCallBack#onResult(int, Object)}。
 */ EMClient.getInstance().chatroomManager().asyncRemoveChatRoomAttributeFromServerForced( conversationId,
 key, new EMResultCallBack<Map<String, Integer>>() { @Override public void onResult(int code, Map<String, Integer> value) { } });
 

删除多个聊天室自定义属性

聊天室成员可以调用 asyncRemoveChatRoomAttributesFromServer 方法删除多个聊天室自定义属性。该方法只能删除自己设置的自定义属性。删除后，聊天室其他成员收到 onAttributesRemoved 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String chatRoomId         聊天室 ID。
 * @param List<String> keyList      聊天室自定义属性的 key 列表。
 * @param callBack                  结果回调，成功时回调 {@link EMResultCallBack#onSuccess(int,Object)}，
 *                                  失败时回调 {@link EMResultCallBack#onError(int, String)}。
 */ EMClient.getInstance().chatroomManager().asyncRemoveChatRoomAttributesFromServer(conversationId,keyList, 
new EMResultCallBack<Map<String, String>>() { @Override public void onSuccess(int code,Map<String, String> value)
 { } @Override public void onError(int error, String errorMsg) { } });
 

若要删除其他聊天室成员设置的自定义属性，需调用 asyncRemoveChatRoomAttributesFromServerForced 方法。删除后，聊天室其他成员收到 onAttributesRemoved 回调。

示例代码如下： 

/**
 * 异步方法。
 *
 * @param String conversationId     聊天室 ID。
 * @param List<String> keyList      聊天室自定义属性的 key 列表。
 * @param callBack                  结果回调，成功时回调 {@link EMResultCallBack#onResult(int, Object)}。
 */ EMClient.getInstance().chatroomManager().asyncRemoveChatRoomAttributesFromServerForced( conversationId,
 keyList, new EMResultCallBack<Map<String, Integer>>() { @Override public void onResult(int code,Map<String, Integer> value) { } });
 

监听聊天室事件

详见 监听聊天室事件。

相似文档
  • 环信IM即时通讯使用教程（Android） - 第三方推送设置
    环信即时通讯 IM 支持集成第三方厂商的消息推送服务，为 Android 开发者提供低延时、高送达、高并发、不侵犯用户个人数据的离线消息推送服务。 当客户端应用进程被关闭等原因导致用户离线，环信即时通讯 IM 服务会通过第三方厂商的消息推送服务向该离线用户的设备推送消息通知。当用户再次上线时，会收到离线期间所有消息。
  • 环信IM即时通讯使用教程（Android） - 在多个设备上登录
    功能描述： 环信即时通讯 IM 支持同一个用户 ID 在多个平台或者多个设备上登录； 客户端支持查询当前账号的已登录设备列表，可强制该账号从其他已登录设备下线； 环信即时通讯 IM Android SDK 支持在同一账号所有已登录设备上同步在线消息和离线消息以及对应的回执和已读状态；
  • 环信IM即时通讯使用教程（Android） - 在线状态订阅
    用户在线状态（即 Presence）包含用户的在线、离线以及自定义状态。 本文介绍如何在即时通讯应用中发布、订阅和查询用户的在线状态。 技术原理： 环信 IM SDK 提供 EMPresence、EMPresenceManager 和 EMPresenceListener 类，用于管理在线状态订阅，包含如下核心方法：
  • 环信IM即时通讯使用教程（Android） - 消息表情回复 Reaction
    环信即时通讯 IM 提供消息表情回复（下文统称 “Reaction”）功能。用户可以在单聊和群聊中对消息添加、删除表情。表情可以直观地表达情绪，利用 Reaction 可以提升用户的使用体验。同时在群组中，利用 Reaction 可以发起投票，根据不同表情的追加数量来确认投票。
  • 环信IM即时通讯使用教程（Android） - 管理子区
    子区是群组成员的子集，是支持多人沟通的即时通讯系统。本文介绍如何使用环信即时通讯 IM Android SDK 在实时互动 app 中创建和管理子区，并实现子区相关功能。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部