API参考
获取单例
获取单例
getSDK({
assetsUrl: CRIMAssetsConfig,
debug?: boolean;
})
-
参数:
参数 类型 说明 assetsUrl CRIMAssetsConfig SDK所需的静态依赖路径配置 debug boolean 开启日志,默认true -
返回值: SDK,全局唯一实例
- 示例代码
import { getSDK } from "@cloudroom/im-wasm-sdk";
// vite里获取使用显示url引入wasm,webpack里需要使用url-loader解析
import SDK_WASM_URL from "@cloudroom/im-wasm-sdk/assets/CRIM.wasm?url";
import SQL_WASM_URL from "@cloudroom/im-wasm-sdk/assets/sql-wasm.wasm?url";
const IMSDK = getSDK({
assetsUrl: {
sdkWasm: SDK_WASM_URL,
sqlWasm: SQL_WASM_URL,
},
});
- 补充说明:
配置参数仅首次调用接口时有效
基础函数
获取SDK版本号
IMSDK.sdkVersion: string;
- 返回值: SDK版本号(String)
- 示例代码
const version = IMSDK.sdkVersion;
console.log(version);
获取当前已登录用户的userID
IMSDK.getLoginUserID()
- 返回值: Promise<WsResponse<string>>
- 示例代码
const {data: userID} = await IMSDK.getLoginUserID();
console.log(userID)
登录
登录
IMSDK.login({
sdkServer: string;
userID: string;
token?: string;
appId?: string;
appSecret?: string;
}, operationID?: string)
-
参数:
参数 类型 说明 sdkServer string SDK服务器地址,默认http协议。
https协议需要传入完整地址,如:https://sdk.cloudroom.comuserID string 用户ID appId string APP ID 可在管理后台,【项目管理】获取,使用token登录时不传 appSecret string APP Secret 可在管理后台,【项目管理】获取,MD5后的值,使用token登录时不传 token string token生成器返回的token,使用appid登录时不传 -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.login({
sdkServer: 'sdkServer',
userID: 'xxxx',
appId: 'appId',
appSecret: 'md5(appSecret)',
token: 'token'
})
- 补充说明:
(appId, appSecret)和token参数二选一
相关回调请参考:
获取登录状态
IMSDK.getLoginStatus(operationID?: string)
- 返回值: Promise<WsResponse<LoginStatus>>
- 示例代码
const { data: loginStatus } = await IMSDK.getLoginStatus();
console.log(loginStatus);
登出
IMSDK.logout(operationID?: string)
- 返回值: Promise
- 示例代码
IMSDK.logout();
SDK 连接服务器失败
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnConnectFailed, () => {})
SDK 已经成功连接到服务器
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnConnectSuccess, () => {})
SDK 正在连接到服务器
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnConnecting, () => {})
当前用户被踢下线
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnKickedOffline, () => {})
- 详情: 自己被踢下线,此时 UI 可以提示用户
token过期通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnUserTokenExpired, () => {})
token无效通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnUserTokenInvalid, () => {})
用户
查询用户信息
IMSDK.getUsersInfo(arr: string[], operationID?: string)
-
详情: 根据userID批量查询用户信息
-
参数:
参数 类型 说明 arr array 需要查询的userID列表 -
返回值: Promise<WsResponse<CRIMPublicUserItem[]>>
- 示例代码
const {data: userInfoList} = await IMSDK.getUsersInfo(["userID1","userID2"]);
const user1 = userInfoList[0];
修改当前登录用户信息
IMSDK.setSelfInfo(info: Partial<CRIMSelfUserInfo>, operationID?: string)
-
参数:
参数 类型 说明 info Partial<CRIMSelfUserInfo> 用户信息结构体 -
返回值: Promise
- 示例代码
await IMSDK.setSelfInfo({
nickname: '修改后的昵称'
});
相关回调请参考:
获取当前登录用户信息
IMSDK.getSelfUserInfo(operationID?: string)
- 返回值: Promise<WsResponse<CRIMSelfUserInfo>>
- 示例代码
const {data: selfUserInfo} = await IMSDK.getSelfUserInfo();
console.log(selfUserInfo);
订阅指定用户的在线状态
IMSDK.subscribeUsersStatus(userIDList: string[], operationID?: string)
-
参数:
参数 类型 说明 userIDList array 用户ID列表 -
返回值: Promise<WsResponse<CRIMUserOnlineState[]>>
- 示例代码
const {data: userOnlineStateList} = await IMSDK.subscribeUsersStatus(["userID1","userID2"]);
取消订阅用户的在线状态
IMSDK.unsubscribeUsersStatus(userIDList: string[], operationID?: string)
-
参数:
参数 类型 说明 userIDList array 用户ID列表 -
返回值: Promise<WsResponse<CRIMUserOnlineState[]>>
- 示例代码
const {data: userOnlineStateList} = await IMSDK.unsubscribeUsersStatus(["userID1","userID2"]);
获取所有已订阅用户的在线状态
IMSDK.getSubscribeUsersStatus(operationID?: string)
- 返回值: Promise<WsResponse<CRIMUserOnlineState[]>>
- 示例代码
const {data: userOnlineStateList} = await IMSDK.getSubscribeUsersStatus();
获取指定用户的在线状态
IMSDK.getUserStatus(userIDList: string[], operationID?: string)
-
参数:
参数 类型 说明 userIDList array 用户ID列表 -
返回值: Promise<WsResponse<CRIMUserOnlineState[]>>
- 示例代码
const {data: userOnlineStateList} = await IMSDK.getUserStatus(["userID1","userID2"]);
个人信息变更通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnSelfInfoUpdated, ({ data }) => {
console.log(data);
});
- 参数:
参数 类型 说明 data CRIMSelfUserInfo 用户状态
用户状态改变
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnUserStatusChanged, ({ data }) => {
console.log(data);
});
- 参数:
参数 类型 说明 data CRIMUserOnlineState 用户状态
会话
获取会话列表
IMSDK.getAllConversationList(operationID?: string)
- 返回值: Promise<WsResponse<CRIMConversationItem[]>>
- 示例代码
const { data } = await IMSDK.getAllConversationList();
分页获取会话列表
IMSDK.getConversationListSplit({
offset: number;
count: number;
})
-
参数:
参数 类型 说明 offset number 起始偏移量 count number 拉取会话的数量 -
返回值: Promise<WsResponse<CRIMConversationItem[]>>
- 示例代码
const {data: conversationList} = await IMSDK.getConversationListSplit({
offset: 0,
count: 20,
})
获取单个会话
IMSDK.getOneConversation({
sourceID: string;
sessionType: CRIMConversationType;
}, operationID?: string)
-
详情: 获取一个会话,如果不存在会自动创建
-
参数:
参数 类型 说明 sourceID number 单聊为用户ID,群聊为群ID sessionType CRIMConversationType 会话的类型 -
返回值: Promise<WsResponse<CRIMConversationItem>>
- 示例代码
const { data: conversationInfo } = await IMSDK.getOneConversation({
sourceID: 'userID',
sessionType: 1,
})
获取多个会话列表
IMSDK.getMultipleConversation(ids: string[], operationID?: string)
-
参数:
参数 类型 说明 ids array 会话ID列表 -
返回值: Promise<WsResponse<CRIMConversationItem[]>>
- 示例代码
const {data: conversationList} = await IMSDK.getMultipleConversation(["conversationID1", "conversationID2"])
本地删除一个会话
IMSDK.deleteConversationAndDeleteAllMsg(id: string, operationID?: string)
-
参数:
参数 类型 说明 id string 会话ID -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.deleteConversationAndDeleteAllMsg('conversationID')
清空一个会话
IMSDK.clearConversationAndDeleteAllMsg(id: string, operationID?: string)
-
参数:
参数 类型 说明 id string 会话ID -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.clearConversationAndDeleteAllMsg("conversationID")
设置会话的草稿
IMSDK.setConversationDraft({
conversationID: string;
draftText: string;
}, operationID?: string)
-
参数:
参数 类型 说明 conversationID string 会话ID draftText string 草稿文本,如果为""则为删除草稿 -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.setConversationDraft({
conversationID: 'conversationID',
draftText: 'draft',
})
获取总的消息未读数
IMSDK.getTotalUnreadMsgCount(operationID?: string)
- 返回值: Promise<WsResponse<number>>
- 示例代码
const { data: unreadMsgCount } = await IMSDK.getTotalUnreadMsgCount();
标记会话已读
IMSDK.markConversationMsgAsRead(conversationID: string)
-
参数:
参数 类型 说明 conversationID string 会话ID -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.markConversationMsgAsRead('conversationID')
相关回调请参考:
隐藏指定会话
IMSDK.hideConversation(conversationID: string)
-
参数:
参数 类型 说明 conversationID string 会话ID -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.hideConversation('conversationID')
- 补充说明:
不删除聊天记录;如果有新消息到达,会话会再次出现。
隐藏所有会话
IMSDK.hideAllConversations()
- 返回值: Promise<WsResponse>
- 示例代码
await IMSDK.hideAllConversations()
- 补充说明:
不删除聊天记录;如果有新消息到达,会话会再次出现。
同步服务器会话开始
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnSyncServerStart,() => {})
同步服务器会话完成
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnSyncServerFinish,() => {})
同步服务器会话失败
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnSyncServerFailed,() => {})
有新的会话
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnNewConversation, ({ data }) => {})
- 参数:
参数 类型 说明 data CRIMConversationItem[] 会话列表
某些会话的关键信息发生变化
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnConversationChanged, ({ data }) => {})
- 参数:
参数 类型 说明 data CRIMConversationItem[] 会话列表
会话未读总数变更通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnTotalUnreadMsgCountChanged,({data}) => {})
- 参数:
参数 类型 说明 data number 未读总数
好友
添加好友
IMSDK.addFriend({
toUserID: string;
reqMsg: string;
}, operationID?: string)
-
参数:
参数 类型 说明 toUserID string 对方userID reqMsg string 请求消息 -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.addFriend({
toUserID: "userID",
reqMsg: "str",
})
相关回调请参考:
获取收到的好友申请
IMSDK.getFriendReqListAsRecipient(params?: {
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 offset number 偏移量 count number 数量 -
返回值: Promise<WsResponse<CRIMFriendReq[]>>
- 示例代码
const {data: reqList} = await IMSDK.getFriendReqListAsRecipient()
发出的好友申请
IMSDK.getFriendReqListAsApplicant(params?: {
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 offset number 偏移量 count number 数量 -
返回值: Promise<WsResponse<CRIMFriendReq[]>>
- 示例代码
const {data: reqList} = await IMSDK.getFriendReqListAsApplicant()
同意某人的好友申请
IMSDK.acceptFriendReq({
toUserID: string;
handleMsg: string;
}, operationID?: string)
-
参数:
参数 类型 说明 toUserID string 对方userID handleMsg string 消息 -
返回值: Promise<WsResponse>
相关回调请参考:
拒绝好友申请
IMSDK.refuseFriendReq({
toUserID: string;
handleMsg: string;
}, operationID?: string)
-
参数:
参数 类型 说明 toUserID string 对方userID handleMsg string 消息 -
返回值: Promise<WsResponse>
相关回调请参考:
加入黑名单
IMSDK.addBlack({
toUserID: string,
ex?: string
}, operationID?: string)
-
参数:
参数 类型 说明 toUserID string 对方userID ex string 扩展字段 -
返回值: Promise<WsResponse>
相关回调请参考:
获取黑名单
IMSDK.getBlackList(operationID?: string)
- 返回值: Promise<WsResponse<CRIMBlackInfo[]>>
移除黑名单
IMSDK.removeBlack(userID: string, operationID?: string)
-
参数:
参数 类型 说明 userID string 对方userID -
返回值: Promise<WsResponse>
相关回调请参考:
获取指定好友列表的相关信息
IMSDK.getSpecifiedFriendsInfo({
friendUserIDList: string[],
filterBlack?: boolean
}, operationID?: string)
-
参数:
参数 类型 说明 friendUserIDList array 需要查询的userID列表 filterBlack boolean 是否过滤黑名单 -
返回值: Promise<WsResponse<CRIMFriendUserItem[]>>
获取所有好友的相关信息
IMSDK.getFriendList(filterBlack?: boolean, operationID?: string)
-
参数:
参数 类型 说明 filterBlack boolean 是否过滤黑名单 -
返回值: Promise<WsResponse<CRIMFriendUserItem[]>>
获取所有好友的相关信息(分页)
IMSDK.getFriendListPage({
offset: number;
count: number;
filterBlack?: boolean;
}, operationID?: string)
-
参数:
参数 类型 说明 offset number 起始偏移量 count number 拉取数量 filterBlack boolean 是否过滤黑名单 -
返回值: Promise<WsResponse<CRIMFriendUserItem[]>>
检查是否好友关系
IMSDK.checkFriend(userIDs: string[], operationID?: string)
-
参数:
参数 类型 说明 userIDs array 需要查询的userID列表 -
返回值: Promise<WsResponse<CRIMSimpleResultInfo[]>>
修改好友信息
IMSDK.updateFriends({
friendUserIDs: string[];
isPinned?: boolean;
remark?: boolean;
ex?: boolean;
}, operationID?: string)
-
参数:
参数 类型 说明 friendUserIDs string[] 好友ID列表 isPinned boolean 是否置顶 remark string 要设置的备注,为空字符串时会取消备注 -
返回值: Promise<WsResponse>
相关回调请参考:
删除好友
IMSDK.deleteFriend(userID: string, operationID?: string)
-
参数:
参数 类型 说明 userID string 好友userID -
返回值: Promise<WsResponse>
- 补充说明:
(1)好友关系是相互的,删除时将导致双方都互不为好友;
(2)删除好友并不会自动删除会话,如要删除会话,可以再调用删除会话的函数。
相关回调请参考:
本地搜索好友
IMSDK.searchFriends({
keywordList: string[];
isSearchUserID: boolean;
isSearchNickname: boolean;
isSearchRemark: boolean;
}, operationID?: string)
-
参数:
参数 类型 说明 keywordList array 关键词列表,目前仅支持单个关键词 isSearchUserID boolean 是否以关键词搜索userID isSearchNickname boolean 是否以关键词搜索昵称,默认false isSearchRemark boolean 是否以关键词搜索备注,默认false -
返回值: Promise<WsResponse<CRIMSearchedFriendsInfo[]>>
相关回调请参考:
黑名单新增通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnBlackAdded, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMBlackInfo 黑名单信息
黑名单删除通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnBlackDeleted, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMBlackInfo 黑名单信息
好友申请通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendReqAdded, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendReq 好友申请信息
好友申请被拒绝
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendReqRejected, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendReq 好友申请信息
好友申请被接受
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendReqAccepted, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendReq 好友申请信息
好友申请被删除
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendReqDeleted, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendReq 好友申请信息
好友新增通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendAdded, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendUserItem 好友信息
好友删除通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendDeleted, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendUserItem 好友信息
好友资料变更通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendInfoChanged, ({data})=>{});
- 参数:
参数 类型 说明 data CRIMFriendUserItem 好友信息
群组
创建群
IMSDK.createGrp({
memberUserIDs: string[];
groupInfo: Partial<CRIMGroupInfo>;
adminUserIDs?: string[];
ownerUserID?: string;
}, operationID?: string)
-
参数:
参数 类型 说明 memberUserIDs array 群成员userID列表 groupInfo Partial<CRIMGroupInfo> 群组信息 adminUserIDs array 群管理userID列表 ownerUserID string 群所有者userID -
返回值: Promise<WsResponse<CRIMGroupInfo>>
- 示例代码
const { data: groupItem } = await IMSDK.createGrp({
groupInfo: {
groupName: "群名称"
},
memberUserIDs: [''],
});
相关回调请参考:
申请加入群组
IMSDK.joinGrp({
groupID: string;
reqMsg: string;
joinSource: CRIMJoinType;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID reqMsg string 入群申请信息 joinSource CRIMJoinType 进群方式 -
返回值: Promise<WsResponse>
相关回调请参考:
退群
IMSDK.quitGrp(groupID: string, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID -
返回值: Promise<WsResponse>
- 补充说明:
群主可以解散群,群主身份转让后才可以退出群组
相关回调请参考:
获取成员是否在群内
IMSDK.getUsersInGrp({
groupID: string;
userIDList: string[];
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID userIDList array 查询的用户userID列表 -
返回值: Promise<WsResponse<string[]>>,在群内的用户ID列表
获取已加入的群列表
IMSDK.getJoinedGrpList(operationID?: string)
- 返回值: Promise<WsResponse<CRIMGroupInfo[]>>
获取已加入的群列表(分页)
IMSDK.getJoinedGrpListPage({
offset: number;
count: number;
}, operationID?: string)
- 返回值: Promise<WsResponse<CRIMGroupInfo[]>>
获取指定群资料
IMSDK.getSpecifiedGrpsInfo(groupIDs: string[], operationID?: string)
-
参数:
参数 类型 说明 groupIDs array 群ID列表 -
返回值: Promise<WsResponse<CRIMGroupInfo[]>>
更新群资料
IMSDK.setGrpInfo(
groupInfo: Partial<CRIMGroupInfo> & { groupID: string },
operationID?: string
)
-
参数:
参数 类型 说明 groupInfo Partial<CRIMGroupInfo> & { groupID: string } 群组信息 -
返回值: Promise<WsResponse>
- 示例代码
await IMSDK.setGrpInfo({
groupID: "groupID",
groupName: "新群名",
})
相关回调请参考:
获取群成员列表
IMSDK.getGrpMemberList({
groupID: string;
filter: CRIMGroupMemberFilter;
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID filter CRIMGroupMemberFilter 群成员过滤器 offset number 起始偏移量 count number 分页大小 -
返回值: Promise<WsResponse<CRIMGroupMemberInfo[]>>
- 补充说明:
获取群内指定的群成员信息,仅本群成员可调用。
获取群内指定群成员信息
IMSDK.getSpecifiedGrpMembersInfo({
groupID: string;
userIDList: string[];
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID userIDList array 群成员userID列表 -
返回值: Promise<WsResponse<CRIMGroupMemberInfo[]>>
- 补充说明:
获取群内指定的群成员信息,仅本群成员可调用。
踢出群
IMSDK.kickGrpMember({
groupID: string;
reason: string;
userIDList: string[];
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID reason string 踢出原因 userIDList array 被踢出的群成员userID列表 -
返回值: Promise<WsResponse>
相关回调请参考:
转让群主
IMSDK.transferGrpOwner({
groupID: string;
newOwnerUserID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID newOwnerUserID string 新群主userID -
返回值: Promise<WsResponse>
- 补充说明:
只有群主能操作
相关回调请参考:
邀请入群
IMSDK.inviteUserToGrp({
groupID: string;
reason: string;
userIDList: string[];
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID reason string 邀请原因 userIDList array 被邀请的群成员userID列表 -
返回值: Promise<WsResponse>
相关回调请参考:
获取收到的群成员申请进群列表
IMSDK.getGrpReqListAsRecipient(param?: {
groupID: string[];
handleResults: number[];
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID handleResults number[] 处理结果过滤器 offset number 起始偏移量 count number 分页大小 -
返回值: Promise<WsResponse<CRIMGroupReqInfo[]>>
获取发出的入群申请列表
IMSDK.getGrpReqListAsApplicant(param?: {
groupID: string[];
handleResults: number[];
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID handleResults number[] 处理结果过滤器 offset number 起始偏移量 count number 分页大小 -
返回值: Promise<WsResponse<CRIMGroupReqInfo[]>>
同意某人进入某群
IMSDK.acceptGrpReq({
groupID: string;
fromUserID: string;
handleMsg: string;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID fromUserID string 申请者userID handleMsg string 处理原因 -
返回值: Promise<WsResponse>
- 补充说明:
管理员或者群主操作
相关回调请参考:
拒绝某人进入某群
IMSDK.refuseGrpReq({
groupID: string;
fromUserID: string;
handleMsg: string;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID fromUserID string 申请者userID handleMsg string 拒绝的原因 -
返回值: Promise<WsResponse>
- 补充说明:
管理员或者群主操作
相关回调请参考:
解散群
IMSDK.dismissGrp(groupID: string, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID -
返回值: Promise<WsResponse>
- 补充说明:
只有群主能操作
相关回调请参考:
禁言某群成员
IMSDK.changeGrpMemberMute({
groupID: string;
userID: string;
mutedSeconds: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID userID string 被禁言的群成员userID mutedSeconds number 禁言时长,单位为秒。0表示取消禁言。 -
返回值: Promise<WsResponse>
- 补充说明:
群主可以禁言管理员和普通成员,管理员可以禁言普通成员。
设置群禁言状态
IMSDK.changeGrpMute({
groupID: string;
isMute: boolean;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID isMute boolean 是否禁言 -
返回值: Promise<WsResponse>
- 补充说明:
群主或管理员可以设置群禁言状态,禁言后仅群主和管理员可以发言。
相关回调请参考:
搜索群
IMSDK.searchGrps({
keywordList: string[];
isSearchGroupID: boolean;
isSearchGroupName: boolean;
}, operationID?: string)
-
参数:
参数 类型 说明 keywordList array 搜索关键字列表 isSearchGroupID boolean 是否搜索群ID isSearchGroupName boolean 是否搜索群名称 -
返回值: Promise<WsResponse<CRIMGroupInfo>>
设置群成员信息
IMSDK.setGrpMemberInfo({
groupID: string;
userID: string;
nickname?: string;
faceURL?: string;
roleLevel?: CRIMGroupMemberRole;
ex?: string;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID userID string 群成员userID nickname string 群成员昵称 faceURL string 群成员头像URL roleLevel CRIMGroupMemberRole 群成员身份 ex string 群成员扩展字段 -
返回值: Promise<WsResponse>
- 补充说明:
群主可以修改管理员和普通成员信息,管理员可以修改普通成员信息
相关回调请参考:
根据加入时间分页获取组成员列表
IMSDK.getGrpMemberListByJoinTimeFilter({
groupID: string;
filterUserIDList: string[];
offset: number;
count: number;
joinTimeBegin: number;
joinTimeEnd: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID filterUserIDList array 排除的群成员 userID 列表 offset number 分页偏移 count number 分页大小 joinTimeBegin number 加入时间开始,为 0 时不限制 joinTimeEnd number 加入时间结束,为 0 时不限制 -
返回值: Promise<WsResponse<CRIMGroupMemberInfo[]>>
- 示例代码
await IMSDK.getGrpMemberListByJoinTimeFilter({
groupID: 'groupID',
offset: 0,
count: 10,
joinTimeBegin: 0,
joinTimeEnd: 0,
filterUserIDList: ['userID'],
})
获取管理者和拥有者
IMSDK.getGrpMemberOwnerAndAdmin(groupID: string, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID -
返回值: Promise<WsResponse<CRIMGroupMemberInfo[]>>
搜索群成员
IMSDK.searchGrpMembers({
groupID: string;
keywordList: string[];
isSearchUserID: boolean;
isSearchMemberNickname: boolean;
offset: number;
count: number;
}, operationID?: string)
-
参数:
参数 类型 说明 groupID string 群ID keywordList array 搜索关键字列表 isSearchUserID boolean 是否搜索群成员userID isSearchMemberNickname boolean 是否搜索群成员昵称 offset number 分页偏移 count number 分页大小 -
返回值: Promise<WsResponse<CRIMGroupMemberInfo[]>>
- 补充说明:
群成员才有权限搜索
有新成员加入群
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpMemberAdded, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupMemberInfo 群成员信息
有成员离开群
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpMemberDeleted, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupMemberInfo 群成员信息
某成员信息发生变更
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpMemberInfoChanged, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupMemberInfo 群成员信息
群组有增加通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnJoinedGrpAdded, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupInfo 群信息
群组有减少通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnJoinedGrpDeleted, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupInfo 群信息
群信息修改通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpInfoChanged, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupInfo 群信息
群申请被接受通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqAccepted, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupReqInfo 申请入群信息
有人申请加群通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqAdded, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupReqInfo 申请入群信息
群申请有删除通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqDeleted, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupReqInfo 申请入群信息
群申请有拒绝通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqRejected, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupReqInfo 申请入群信息
群解散通知
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpDismissed, ({data})=>{})
- 参数:
参数 类型 说明 data CRIMGroupInfo 群信息
消息
创建文本消息
IMSDK.createTextMsg(text: string, operationID?: string)
-
参数:
参数 类型 说明 text string 消息内容 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建@文本消息
IMSDK.createTextAtMsg({
text: string;
atUserIDList: string[];
atUsersInfo: AtUsersInfoItem[];
message?: MessageItem;
}, operationID?: string)
-
参数:
参数 类型 说明 text string 消息内容 atUserIDList string[] 被@的userID列表 atUsersInfo CRIMAtInfo[] 被@的用户信息列表 message CRIMMessageInfo 引用消息的时候使用 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建图片消息
IMSDK.createImageMsgByFile({
sourcePicture: PicBaseInfo;
bigPicture: PicBaseInfo;
snapshotPicture: PicBaseInfo;
sourcePath: string;
file: File;
}, operationID?: string)
-
参数:
参数 类型 说明 sourcePicture CRIMPicBaseInfo 原图信息 bigPicture CRIMPicBaseInfo 大图信息 snapshotPicture CRIMPicBaseInfo 缩略图信息 sourcePath string 图片在本机的绝对路径,如果没有传空字符即可 file File 文件对象 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
- 示例代码
let file; //这是一个图片File对象
const picBaseInfo = {
uuid: "uuid",
type: file.type,
size: file.size,
width: 1920, //图像宽高可以加载img再读取
height: 1080,
}
const {data: message} = await IMSDK.createImageMsgByFile({
sourcePicture: picBaseInfo;
bigPicture: picBaseInfo;
snapshotPicture: picBaseInfo;
sourcePath: "";
file: file
})
创建音频消息
IMSDK.createSoundMsgByFile({
uuid: string;
soundPath: string;
sourceUrl: string;
dataSize: number;
duration: number;
soundType: string;
file: File;
}, operationID?: string)
-
参数:
参数 类型 说明 uuid string 资源唯一标识 soundPath string 音频在本地的绝对路径,如果没有传空字符即可 sourceUrl string 传空字符串 dataSize number 音频文件大小 duration number 音频时长(秒) soundType string 文件类型 file File 音频文件对象 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
- 示例代码
let file; //音频文件对象
const {data: message} = await IMSDK.createSoundMessageByFile({
soundPath: file.path,
duration: 6,
uuid: 'uuid',
sourceUrl: '',
dataSize: file.size,
soundType: file.type,
file: file,
})
创建视频消息
IMSDK.createVideoMsgByFile({
videoPath: string;
duration: number;
videoType: string;
snapshotPath: string;
videoUUID: string;
videoUrl: string;
videoSize: number;
snapshotUUID: string;
snapshotSize: number;
snapshotUrl: string;
snapshotWidth: number;
snapshotHeight: number;
snapShotType: string;
videoFile: File;
snapshotFile: File;
}, operationID?: string)
-
参数:
参数 类型 说明 videoPath string 视频在本地的绝对路径,如果没有传空字符即可 duration number 视频时长(秒) videoType string 文件类型 snapshotPath string 传空字符 videoUUID string 视频文件唯一标识 videoUrl string 传空字符 videoSize number 视频文件大小 snapshotUUID string 视频封面唯一标识 snapshotSize number 视频封面文件大小 snapshotUrl string 传空字符 snapshotWidth number 视频封面宽度 snapshotHeight number 视频封面高度 snapShotType string 视频封面文件类型 videoFile File 视频文件对象 snapshotFile File 视频封面文件对象 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建文件消息
IMSDK.createFileMsgByFile({
filePath: string;
fileName: string;
uuid: string;
sourceUrl: string;
fileSize: number;
fileType?: string;
file: File;
}, operationID?: string)
-
参数:
参数 类型 说明 filePath string 文件在本地的绝对路径,如果没有传空字符即可 fileName string 文件名 uuid string 文件唯一标识 sourceUrl string 传空字符 fileSize number 文件大小 fileType string 文件类型 file File 文件对象 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
- 示例代码
let file; //文件对象
const {data:message} = await IMSDK.createFileMessageByFile({
filePath: '',
fileName: file.name,
uuid: 'uuid',
sourceUrl: '',
fileSize: file.size,
fileType: file.type,
file: file,
})
创建合并消息
IMSDK.createMergerMsg({
messageList: CRIMMessageInfo[];
title: string;
summaryList: string[];
}, operationID?: string)
-
参数:
参数 类型 说明 messageList CRIMMessageInfo[] 消息列表 title string 消息标题 summaryList string[] 消息摘要列表 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建转发消息
IMSDK.createForwardMsg(message:CRIMMessageInfo, operationID?: string)
-
参数:
参数 类型 说明 message CRIMMessageInfo 消息对象 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建位置消息
IMSDK.createLocationMsg({
description: string;
longitude: number;
latitude: number;
}, operationID?: string)
-
参数:
参数 类型 说明 description string 位置描述 longitude number 经度 latitude number 纬度 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建引用消息
IMSDK.createQuoteMsg({
text: string;
message: CRIMMessageInfo;
}, operationID?: string)
-
参数:
参数 类型 说明 text string 文本内容 message CRIMMessageInfo 被引用的消息 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建名片消息
IMSDK.createCardMsg({
userID: string;
nickname: string;
faceURL: string;
ex?: string;
}, operationID?: string)
-
参数:
参数 类型 说明 userID string 用户ID nickname string 用户昵称 faceURL string 用户头像 ex string 扩展字段 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建自定义消息
IMSDK.createCustomMsg({
data: string;
extension: string;
description: string;
}, operationID?: string)
-
参数:
参数 类型 说明 data string 文本内容 extension string 扩展内容 description string 描述内容 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
创建动图消息
IMSDK.createFaceMsg({
index: number;
data: string;
}, operationID?: string)
- 返回值: Promise<WsResponse<CRIMMessageInfo>>
发送消息
IMSDK.sendMsg({
recvID: string;
groupID: string;
offlinePushInfo?: CRIMOfflinePushInfo;
message: CRIMMessageInfo;
}, operationID?: string)
-
参数:
参数 类型 说明 recvID string 单聊的用户ID,如果为群聊则为"" groupID string 群聊的群ID,如果为单聊则为"" offlinePushInfo CRIMOfflinePushInfo 离线推送信息 message CRIMMessageInfo 消息体 -
返回值: Promise<WsResponse<CRIMMessageInfo>>
- 补充说明:
发送消息需要先构造消息实例,支持构造的消息类型有普通文本、图片、视频、文件、音频、地理位置、引用、转发、@xxx等消息,构造完消息后调用SDK的发送接口即可完成消息的发送
相关回调请参考:
撤回一条消息
IMSDK.revokeMsg({
conversationID: string;
clientMsgID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 conversationID string 会话ID clientMsgID string 消息ID -
返回值: Promise<WsResponse>
- 补充说明:
支持撤回自己的消息,管理员与群主撤回群成员消息。
相关回调请参考:
单聊正在输入消息
IMSDK.typingStatusUpdate({
recvID: string;
msgTip: string;
}, operationID?: string)
-
参数:
参数 类型 说明 recvID string 对方用户ID msgTip string 自定义的提示信息 -
返回值: Promise<WsResponse>
相关回调请参考:
从本地删除一条消息
IMSDK.deleteMsgFromLocalStorage({
conversationID: string;
clientMsgID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 conversationID string 会话ID clientMsgID string 消息ID -
返回值: Promise<WsResponse>
删除一条消息
IMSDK.deleteMsg({
conversationID: string;
clientMsgID: string;
}, operationID?: string)
-
详情: 从本地和服务器上删除一条消息
-
参数:
参数 类型 说明 conversationID string 会话ID clientMsgID string 消息ID -
返回值: Promise<WsResponse>
从本地删除所有消息
IMSDK.deleteAllMsgFromLocal(operationID?: string)
- 返回值: Promise<WsResponse>
删除所有消息
IMSDK.deleteAllMsgFromLocalAndSvr(operationID?: string)
-
详情: 从本地和服务器上删除所有消息
-
返回值: Promise<WsResponse>
插入一条单聊消息到本地
IMSDK.insertSingleMsgToLocalStorage({
message: CRIMMessageInfo;
recvID: string;
sendID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 message CRIMMessageInfo 消息体 recvID string 接收用户ID sendID string 发送者ID -
返回值: Promise<WsResponse>
插入一条群聊消息到本地
IMSDK.insertGrpMsgToLocalStorage({
message: CRIMMessageInfo;
groupID: string;
sendID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 message CRIMMessageInfo 消息体 groupID string 群ID sendID string 发送者ID -
返回值: Promise<WsResponse>
查找本地消息
IMSDK.searchLocalMsgs({
conversationID: string;
keywordList: string[];
messageTypeList?: CRIMMessageContentType[];
searchTimePosition?: number;
searchTimePeriod?: number;
pageIndex?: number;
count?: number;
}, operationID?: string)
-
参数:
参数 类型 说明 conversationID string 会话ID,全局搜素时填空串 keywordList string[] 关键词列表,目前仅支持单个关键词 messageTypeList CRIMMessageContentType[] 消息类型列表 searchTimePosition number 起始时间,UTC时间,单位秒,0表示从当前时间开始 searchTimePeriod number 从起始时间往前的时间范围,UTC时间,单位秒,3600表示过去一小时,传0表示不限制时间范围 pageIndex number 开始页数,首次查询传1,全局搜索时无效 count number 每页消息数,全局搜索时无效 -
返回值: Promise<WsResponse<CRIMSearchResultInfo>>
上传文件
IMSDK.uploadFile({
name: string;
contentType: string;
uuid: string;
file: File;
}, operationID?: string)
-
参数:
参数 类型 说明 name string 文件名 contentType string 文件类型 uuid string 文件唯一标识 file File 文件对象 -
返回值: Promise<WsResponse<{url: string}>>
- 示例代码
let file; //文件对象
const {data: {url}} = await IMSDK.uploadFile({
name: file.name,
contentType: file.type,
uuid: 'uuid',
file: file,
});
console.log(url);
获取历史消息
IMSDK.getAdvancedHistoryMsgList({
count: number;
viewType: ViewType;
startClientMsgID: string;
conversationID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 count number 拉取消息的条数 viewType CRIMViewType 判断为正常拉取聊天记录,还是搜索后获取消息上下文 startClientMsgID string 起始的消息ID,首次拉取可传空字符串 conversationID string 会话ID -
返回值: Promise<WsResponse<CRIMGetAdvancedHistoryMessageListInfo>>
- 示例代码
import { ViewType } from '@cloudroom/im-wasm-sdk';
await IMSDK.getAdvancedHistoryMsgList({
count: 10,
viewType: ViewType.History,
startClientMsgID: '',
conversationID: 'conversationID',
})
反向获取历史消息
IMSDK.getAdvancedHistoryMsgListReverse({
count: number;
viewType: ViewType;
startClientMsgID: string;
conversationID: string;
}, operationID?: string)
-
参数:
参数 类型 说明 count number 拉取消息的条数 viewType CRIMViewType 判断为正常拉取聊天记录,还是搜索后获取消息上下文 startClientMsgID string 起始的消息ID,首次拉取可传空字符串 conversationID string 会话ID -
返回值: Promise<WsResponse<CRIMGetAdvancedHistoryMessageListInfo[]>>
- 示例代码
import { ViewType } from '@cloudroom/im-wasm-sdk';
await IMSDK.getAdvancedHistoryMsgListReverse({
count: 10,
viewType: ViewType.History,
startClientMsgID: '',
conversationID: 'conversationID',
})
收到新消息
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnRecvNewMsgs, ({data}) => {})
- 参数:
参数 类型 说明 data CRIMMessageInfo[] 新消息
单聊消息已读回执
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnRecv1v1ReadReceipt, ({data}) => {})
- 参数:
参数 类型 说明 data CRIMReceiptInfo[] 已读回执列表
群聊消息已读回执
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnRecvGrpReadReceipt, ({data}) => {})
- 参数:
参数 类型 说明 data CRIMReceiptInfo[] 已读回执列表
收到消息撤回
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnNewRecvMsgRevoked, ({data}) => {})
- 参数:
参数 类型 说明 data CRIMMessageRevokedInfo 撤回消息
收到消息删除
import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnMsgDeleted, ({data}) => {})
- 参数:
参数 类型 说明 data CRIMMessageInfo 删除的消息