更新时间: 2021-03-08
# 加入聊天室
# 功能描述
- 加入聊天室前需要先实例化。
- 如果聊天室不存在,SDK 会创建聊天室并加入,如果已存在,则直接加入。
- 调用加入聊天室接口时可以设置进入聊天室时的拉取消息数量。
# 参数说明
实例化参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
id | String | 是 | 聊天室 id | 3.0.0 |
加入参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
count | Number | 是 | 拉取消息数, 由 im.watch 抛出 -1 表示不获取任何历史消息 0 表示不特殊设置而使用 SDK 默认的设置,默认为获取 10 条 传入其他值为具体获取的消息数量,最大值为 50 | 3.0.0 |
# 代码示例
实例化
// 注: im 实例通过 RongIMLib.init 获取(单个页面仅需初始化一次) var chatRoom = im.ChatRoom.get({ id: 'chatRoom1' });
已复制
1
2
3
4
2
3
4
加入
chatRoom.join({ count: 20 // 进入后, 自动拉取 20 条聊天室最新消息 }).then(function() { console.log('加入聊天室成功'); });
已复制
1
2
3
4
5
2
3
4
5
# 加入存在的聊天室
# 功能描述
- 加入聊天室前需要先实例化。
- 需加入 已存在 的聊天室。若聊天室不存在,则加入失败。
- 调用加入聊天室接口时可以设置进入聊天室时的拉取消息数量。
# 参数说明
实例化参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
id | String | 是 | 聊天室 id | 3.0.0 |
加入参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
count | Number | 是 | 拉取消息数, 由 im.watch 抛出 -1 表示不获取任何历史消息 0 表示不特殊设置而使用 SDK 默认的设置,默认为获取 10 条 传入其他值为具体获取的消息数量,最大值为 50 | 3.0.5 |
# 代码示例
实例化
// 注: im 实例通过 RongIMLib.init 获取(单个页面仅需初始化一次) var chatRoom = im.ChatRoom.get({ id: 'chatRoom1' });
已复制
1
2
3
4
2
3
4
加入
chatRoom.joinExist({ count: 20 // 进入后, 自动拉取 20 条聊天室最新消息 }).then(function() { console.log('加入聊天室成功'); });
已复制
1
2
3
4
5
2
3
4
5