IM即时通讯

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()
  • 示例代码
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.com
    userID 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)
  • 示例代码
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)
  • 示例代码
const {data: selfUserInfo} = await IMSDK.getSelfUserInfo();
console.log(selfUserInfo);

订阅指定用户的在线状态

IMSDK.subscribeUsersStatus(userIDList: string[], operationID?: string)
  • 示例代码
const {data: userOnlineStateList} = await IMSDK.subscribeUsersStatus(["userID1","userID2"]);

取消订阅用户的在线状态

IMSDK.unsubscribeUsersStatus(userIDList: string[], operationID?: string)
  • 示例代码
const {data: userOnlineStateList} = await IMSDK.unsubscribeUsersStatus(["userID1","userID2"]);

获取所有已订阅用户的在线状态

IMSDK.getSubscribeUsersStatus(operationID?: string)
  • 示例代码
const {data: userOnlineStateList} = await IMSDK.getSubscribeUsersStatus();

获取指定用户的在线状态

IMSDK.getUserStatus(userIDList: string[], operationID?: string)
  • 示例代码
const {data: userOnlineStateList} = await IMSDK.getUserStatus(["userID1","userID2"]);

个人信息变更通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnSelfInfoUpdated, ({ data }) => {
    console.log(data);
});

用户状态改变

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnUserStatusChanged, ({ data }) => {
    console.log(data);
});

会话

获取会话列表

IMSDK.getAllConversationList(operationID?: string)
  • 示例代码
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)
  • 示例代码
const { data: conversationInfo } = await IMSDK.getOneConversation({
    sourceID: 'userID',
    sessionType: 1,
})

获取多个会话列表

IMSDK.getMultipleConversation(ids: string[], operationID?: string)
  • 示例代码
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)
  • 示例代码
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()
  • 示例代码
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 }) => {})

某些会话的关键信息发生变化

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnConversationChanged, ({ data }) => {})

会话未读总数变更通知

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)

移除黑名单

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)

获取所有好友的相关信息(分页)

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)

修改好友信息

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})=>{});

好友删除通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendDeleted, ({data})=>{});

好友资料变更通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnFriendInfoChanged, ({data})=>{});

群组

创建群

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)

获取已加入的群列表(分页)

IMSDK.getJoinedGrpListPage({
        offset: number;
        count: number;
    }, operationID?: string)

获取指定群资料

IMSDK.getSpecifiedGrpsInfo(groupIDs: string[], operationID?: string)

更新群资料

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)
  • 补充说明:

    获取群内指定的群成员信息,仅本群成员可调用。

获取群内指定群成员信息

IMSDK.getSpecifiedGrpMembersInfo({
    groupID: string;
    userIDList: string[];
}, operationID?: string)
  • 补充说明:

    获取群内指定的群成员信息,仅本群成员可调用。

踢出群

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)

搜索群成员

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})=>{})

有成员离开群

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpMemberDeleted, ({data})=>{})

某成员信息发生变更

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpMemberInfoChanged, ({data})=>{})

群组有增加通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnJoinedGrpAdded, ({data})=>{})

群组有减少通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnJoinedGrpDeleted, ({data})=>{})

群信息修改通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpInfoChanged, ({data})=>{})

群申请被接受通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqAccepted, ({data})=>{})

有人申请加群通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqAdded, ({data})=>{})

群申请有删除通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqDeleted, ({data})=>{})

群申请有拒绝通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpReqRejected, ({data})=>{})

群解散通知

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnGrpDismissed, ({data})=>{})

消息

创建文本消息

IMSDK.createTextMsg(text: string, operationID?: string)

创建@文本消息

IMSDK.createTextAtMsg({
    text: string;
    atUserIDList: string[];
    atUsersInfo: AtUsersInfoItem[];
    message?: MessageItem;
}, operationID?: string)

创建图片消息

IMSDK.createImageMsgByFile({
    sourcePicture: PicBaseInfo;
    bigPicture: PicBaseInfo;
    snapshotPicture: PicBaseInfo;
    sourcePath: string;
    file: File;
}, operationID?: string)
  • 示例代码
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)

创建转发消息

IMSDK.createForwardMsg(message:CRIMMessageInfo, operationID?: string)

创建位置消息

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)

创建名片消息

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)

发送消息

IMSDK.sendMsg({
    recvID: string;
    groupID: string;
    offlinePushInfo?: CRIMOfflinePushInfo;
    message: CRIMMessageInfo;
}, operationID?: string)
  • 补充说明:

    发送消息需要先构造消息实例,支持构造的消息类型有普通文本、图片、视频、文件、音频、地理位置、引用、转发、@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)

删除所有消息

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}) => {})

单聊消息已读回执

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnRecv1v1ReadReceipt, ({data}) => {})

群聊消息已读回执

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnRecvGrpReadReceipt, ({data}) => {})

收到消息撤回

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnNewRecvMsgRevoked, ({data}) => {})

收到消息删除

import { CbEvents } from '@cloudroom/im-wasm-sdk';
IMSDK.on(CbEvents.OnMsgDeleted, ({data}) => {})