====== 管理聊天室属性 ======

更新时间：2022-08-10

聊天室是支持多人沟通的即时通讯系统。本文介绍如何管理聊天室的属性信息。

===== 技术原理 =====

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

  * 获取聊天室公告
  * 更新聊天室公告
  * 更新聊天室名称
  * 更新聊天室描述

===== 前提条件 =====

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

  * 完成 SDK 初始化，详见 [[ccim:rn:quickstart|快速开始]] 及 [[ccim:rn:overview|SDK 集成概述]]；
  * 了解环信即时通讯 IM 的 [[https://docs-im.easemob.com/ccim/limitation|使用限制]]。
  * 了解聊天室的数量限制，详见 [[https://www.easemob.com/pricing/im|套餐包详情]]。

===== 实现方法 =====

本节介绍如何使用环信即时通讯 IM SDK 提供的 API 实现上述功能。

==== 获取聊天室公告 ====

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

示例代码如下：

<code typescript>
ChatClient.getInstance()
  .roomManager.fetchChatRoomAnnouncement(roomId)
  .then((ann) => {
    console.log("get ann success.", ann);
  })
  .catch((reason) => {
    console.log("get ann fail.", reason);
  });
</code>

==== 更新聊天室公告 ====

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

示例代码如下：

<code typescript>
ChatClient.getInstance()
  .roomManager.updateChatRoomAnnouncement(roomId, announcement)
  .then(() => {
    console.log("update ann success.");
  })
  .catch((reason) => {
    console.log("update ann fail.", reason);
  });
</code>

==== 更新聊天室名称 ====

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

示例代码如下：

<code typescript>
ChatClient.getInstance()
  .roomManager.changeChatRoomSubject(roomId, subject)
  .then(() => {
    console.log("change subject success.");
  })
  .catch((reason) => {
    console.log("change subject fail.", reason);
  });
</code>

==== 更新聊天室描述 ====

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

示例代码如下：

<code typescript>
ChatClient.getInstance()
  .roomManager.changeChatRoomDescription(roomId, desc)
  .then(() => {
    console.log("change desc success.");
  })
  .catch((reason) => {
    console.log("change desc fail.", reason);
  });
</code>

==== 更多 ====

你可以参考如下文档，在项目中实现聊天室事件监听：

  * [[https://docs-im.easemob.com/ccim/rn/chatroom2|监听器介绍]]