ICode9

精准搜索请尝试: 精确搜索
首页 > 编程语言> 文章详细

小程序轻松实现IM即时通讯多人聊天室

2022-09-08 09:02:02  阅读:354  来源: 互联网

标签:function 聊天室 创建 房间 接口 IM 即时通讯 roomID 客户端


IM多人聊天室功能简介

ZIM SDK 提供多人房间聊天功能,支持用户向房间内发送文本消息或自定义消息,实现了多人在线交流、同步分享。

多人房间聊天功能可应用于小班课或者会议室等场景,房间成员数量上限请参考 计费说明

IM房间管理功能的前提条件

在实现“房间管理”功能之前,请确保:

实现IM多人聊天流程

用户可以通过以下两种方式,创建房间并进入房间。

  • 方式一:创建房间、加入房间:用户 A 调用 createRoom 接口,传入 ZIMRoomInfo 信息,即可创建并加入房间。其他用户调用 joinRoom 接口,传入由 A 创建的房间 roomID,即可加入房间。
  • 方式二:进入房间:用户 X 调用 enterRoom 接口,传入 ZIMRoomInfo 信息,如果 roomID 不存在,会自动创建一个房间然后进入。其他用户需要调用 enterRoom 接口,传入由 X 创建的房间 roomID,进入房间。

房间内的用户,可以通过 sendRoomMessage 接口,向房间内发送消息,详情请参考 收发房间消息

如果 roomID 已存在:

  • 调用 createRoom 接口,会返回相关错误码,详情请参考 常见错误码
  • 调用 enterRoom 接口,会直接进入此房间内。

如果 roomID 不存在:

  • 调用 createRoom 接口,可以直接创建、并加入到此房间内。
  • 调用 enterRoom 接口,会直接创建一个房间、并进入到此房间内。

创建即时通讯多人聊天房间、加入聊天房间

以下流程中,我们以客户端 A 创建并加入房间,客户端 B 和其他客户端加入房间为例。

下载.png

1. 创建多人聊天房间

客户端 A 登录后,创建一个房间,可以调用 createRoom 接口,传入 ZIMRoomInfo 信息,即可创建并加入房间。同时可以通过错误码 ZIMError 的参数值,判断是否创建成功。相关错误码请查看 常见错误码

  • “roomID”、“roomName” 支持开发者自定义规则生成。建议开发者将 “roomID” 设置为一个有意义的值,可将其与自己的业务账号系统进行关联。
  • 调用 createRoom 接口创建房间后,会直接加入房间,无需再调用 joinRoom 接口加入房间。
var roomInfo = { roomID: '', roomName: '' };
zim.createRoom(roomInfo)
    .then(function ({ roomInfo }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

2. 加入IM多人聊天房间

客户端 B 和其他客户端先后加入房间,可以调用 joinRoom 接口,传入由 A 创建的房间 roomID,即可加入房间。同时可以通过错误码 ZIMError 的参数值,判断是否创建成功。相关错误码请查看 常见错误码

var roomID = '';
zim.joinRoom(roomID)
    .then(function ({ roomInfo }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

3. IM聊天房间成员变动通知

当房间有其他成员加入时,将通过 on 的回调接口 roomMemberJoined,向其他已在成员发送消息通知。

例如,当客户端 B 加入由 A 创建的房间时,A 将收到房间内成员变动的通知。

// 加入房间通知,通过该通知收到加入房间的用户信息
zim.on('roomMemberJoined', function (zim, { roomID, memberList }) {
    console.log(roomID, memberList);
});

进入多人聊天房间

以下流程中,我们以客户端 X 创建并进入房间,客户端 Y 和其他客户端直接进入房间为例。

下载2.png

  1. 客户端 X 登录后,调用 enterRoom 接口,传入 ZIMRoomInfo 信息,进入房间;如果传入的 roomID 不存在,将会自动创建一个房间并进入该房间。
  2. 客户端 Y 及其他用户登录后,调用 enterRoom 接口,传入由 X 创建的房间 roomID,直接进入房间。
  3. 房间内的用户,同样可以使用 on 的回调接口 roomMemberJoined 方法,实现对房间内成员加入的监听。
var roomInfo = { roomID: '', roomName: '' };
zim.enterRoom(roomInfo)
    .then(function ({ roomInfo }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

// 加入房间通知,通过该通知收到加入房间的用户信息
zim.on('roomMemberJoined', function (zim, { roomID, memberList }) {
    console.log(roomID, memberList);
});

离开IM聊天房间

客户端 B 如果想要离开房间,可以调用 leaveRoom 接口,传入房间的 roomID,即可退出此房间;房间内的其他用户可以通过 on 的回调接口 roomMemberLeft,收到成员变动通知。

离开房间后,将不能收到房间内的消息。

下载3.png

var roomID = '';
zim.leaveRoom(roomID)
    .then(function ({ roomID }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });
// 离开房间通知,通过该通知收到离开房间的用户信息
zim.on('roomMemberLeft', function (zim, { roomID, memberList }) {
    console.log(roomID, memberList);
});

当所有成员离开房间后,房间将自动销毁,同时支持设置房间延迟销毁。

标签:function,聊天室,创建,房间,接口,IM,即时通讯,roomID,客户端
来源: https://www.cnblogs.com/zegodeveloper/p/16665561.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有