Constructors

Properties

Methods

create destroy setDeviceToken registerNativeCustomMessage registerNativeCustomMediaMessage connect disconnect createTextMessage createImageMessage createFileMessage createSightMessage createVoiceMessage createReferenceMessage createGIFMessage createCustomMessage createLocationMessage createNativeCustomMessage createNativeCustomMediaMessage sendMessage sendMediaMessage cancelSendingMediaMessage downloadMediaMessage cancelDownloadingMediaMessage getConversation getConversations getUnreadConversations removeConversation removeConversations getUnreadCount getTotalUnreadCount getUnreadMentionedCount getUltraGroupAllUnreadCount getUltraGroupAllUnreadMentionedCount getUltraGroupUnreadCount getUltraGroupUnreadMentionedCount getUnreadCountByConversationTypes clearUnreadCount saveDraftMessage getDraftMessage clearDraftMessage getBlockedConversations changeConversationTopStatus getConversationTopStatus syncConversationReadStatus sendTypingStatus getMessages getMessageById getMessageByUId getFirstUnreadMessage getUnreadMentionedMessages insertMessage insertMessages clearMessages deleteLocalMessages deleteMessages recallMessage sendPrivateReadReceiptMessage sendGroupReadReceiptRequest sendGroupReadReceiptResponse updateMessageExpansion removeMessageExpansionForKeys changeMessageSentStatus changeMessageReceiveStatus joinChatRoom leaveChatRoom getChatRoomMessages addChatRoomEntry addChatRoomEntries getChatRoomEntry getChatRoomAllEntries removeChatRoomEntry removeChatRoomEntries addToBlacklist removeFromBlacklist getBlacklistStatus getBlacklist searchMessages searchMessagesByTimeRange searchMessagesByUserId searchConversations changeNotificationQuietHours removeNotificationQuietHours getNotificationQuietHours changeConversationNotificationLevel getConversationNotificationLevel changeConversationTypeNotificationLevel getConversationTypeNotificationLevel changeUltraGroupDefaultNotificationLevel getUltraGroupDefaultNotificationLevel changeUltraGroupChannelDefaultNotificationLevel getUltraGroupChannelDefaultNotificationLevel changePushContentShowStatus changePushLanguage changePushReceiveStatus sendGroupMessageToDesignatedUsers getMessageCount getTopConversations syncUltraGroupReadStatus getConversationsForAllChannel modifyUltraGroupMessage recallUltraGroupMessage clearUltraGroupMessages sendUltraGroupTypingStatus clearUltraGroupMessagesForAllChannel getBatchRemoteUltraGroupMessages updateUltraGroupMessageExpansion removeUltraGroupMessageExpansionForKeys changeLogLevel getDeltaTime createTag removeTag updateTagNameById getTags addConversationToTag removeConversationFromTag removeTagsFromConversation getTagsFromConversation getConversationsFromTagByPage getUnreadCountByTag changeConversationTopStatusInTag getConversationTopStatusInTag clearMessagesUnreadStatusByTag clearConversationsByTag setOnMessageReceivedListener setOnConnectionStatusChangedListener setOnConversationTopStatusSyncedListener setOnConversationNotificationLevelSyncedListener setOnRemoteMessageRecalledListener setOnPrivateReadReceiptReceivedListener setOnRemoteMessageExpansionUpdatedListener setOnRemoteMessageExpansionForKeyRemovedListener setOnChatRoomMemberChangedListener setOnTypingStatusChangedListener setOnConversationReadStatusSyncMessageReceivedListener setOnChatRoomEntriesSyncedListener setOnChatRoomEntriesChangedListener setOnRemoteUltraGroupMessageExpansionUpdatedListener setOnRemoteUltraGroupMessageModifiedListener setOnRemoteUltraGroupMessageRecalledListener setOnUltraGroupReadTimeReceivedListener setOnUltraGroupTypingStatusChangedListener setOnMessageBlockedListener setOnChatRoomStatusChangedListener setOnGroupMessageReadReceiptRequestReceivedListener setOnGroupMessageReadReceiptResponseReceivedListener setOnUltraGroupConversationsSyncedListener setOnChatRoomJoiningListener

Constructors

Properties

_instance: RCIMIWEngine

Methods

  • 销毁引擎 引擎销毁后如果当前未退出登录,SDK 会自动退出,且仍接受 push

    Returns Promise<number>

  • Parameters

    • deviceToken: string

    Returns Promise<number>

  • 注册原生自定义普通消息

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功,非 0 代表当前接口调用操作失败,详细错误参考错误码

  • 注册原生自定义媒体消息

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功,非 0 代表当前接口调用操作失败,详细错误参考错误码

  • 连接融云服务器,在整个应用程序全局,只需要调用一次。调用此接口返回非业务错误码时,SDK 会启动重连机制进行重连;如果仍没有连接成功,会在设备网络状态变化时再次进行重连。

    Parameters

    • token: string

      调用 server api 获取到的 token

    • timeout: number

      连接超时时间,单位:秒。 timeLimit <= 0,则 IM 将一直连接,直到连接成功或者无法连接(如 token 非法) timeLimit > 0,则 IM 将最多连接 timeLimit 秒 如果在 timeLimit 秒内连接成功,后面再发生了网络变化或前后台切换,SDK 会自动重连; 如果在 timeLimit 秒无法连接成功则不再进行重连,通过 listener 告知连接超时,您需要再自行调用 connect 接口

    • Optionalcallback: RCIMIWConnectCallback

      链接事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 断开链接 注:因为 SDK 在前后台切换或者网络出现异常都会自动重连,保证连接可靠性。 所以除非您的 App 逻辑需要登出,否则一般不需要调用此方法进行手动断开

    Parameters

    • receivePush: boolean

      退出后是否接收 push,true:断开后接收远程推送,false:断开后不再接收远程推送

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 构建文本消息

    Parameters

    • type: RCIMIWConversationType

      会话类型,

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • text: string

      文本内容

    Returns Promise<RCIMIWTextMessage>

    文本消息实体

  • 构建图片消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • path: string

      图片消息的本地路径,必须为有效路径

    Returns Promise<RCIMIWImageMessage>

    图片消息实体

  • 构建文件消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • path: string

      文件消息的本地路径,必须为有效路径

    Returns Promise<RCIMIWFileMessage>

    文件消息实体

  • 构建小视频消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • path: string

      小视频消息的本地路径,必须为有效路径

    • duration: number

      小视频消息的视频时长

    Returns Promise<RCIMIWSightMessage>

    视频消息实体

  • 构建语音消息 (高清语音)

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • path: string

      语音消息的本地路径,必须为有效路径

    • duration: number

      语音消息的消息时长

    Returns Promise<RCIMIWVoiceMessage>

    语音消息的实体

  • 构建 GIF 消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • path: string

      GIF 消息的本地路径

    Returns Promise<RCIMIWGIFMessage>

    GIF 消息实体

  • 构建自定义消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • policy: RCIMIWCustomMessagePolicy

      消息的存储策略

    • messageIdentifier: string

      消息的标识符,需唯一

    • fields: Map<string, string>

      消息的内容键值对

    Returns Promise<RCIMIWCustomMessage>

    自定义消息实体

  • 构建位置消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • longitude: number

      经度

    • latitude: number

      纬度

    • poiName: string

      POI 信息

    • thumbnailPath: string

      缩略图本地路径,必须为有效路径

    Returns Promise<RCIMIWLocationMessage>

    位置消息实体

  • 构建原生自定义普通消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • messageIdentifier: string

      消息的标识符,需唯一

    • fields: Map<string, Object>

      消息的内容键值对

    Returns Promise<RCIMIWNativeCustomMessage>

    原生自定义普通消息

  • 构建原生自定义媒体消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • messageIdentifier: string

      消息的标识符,需唯一

    • path: string

      媒体文件的本地路径,必须为有效路径

    • fields: Map<string, Object>

      消息的内容键值对

    Returns Promise<RCIMIWNativeCustomMediaMessage>

    原生自定义媒体消息

  • 发送普通消息

    Parameters

    • message: RCIMIWMessage

      发送的消息实体

    • Optionalcallback: RCIMIWSendMessageCallback

      发送消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 发送媒体消息

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 取消发送媒体消息

    Parameters

    • message: RCIMIWMediaMessage

      需要取消发送的媒体消息实体

    • Optionalcallback: IRCIMIWCancelSendingMediaMessageCallback

      取消发送媒体消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 下载媒体消息

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 取消下载媒体消息

    Parameters

    • message: RCIMIWMediaMessage

      需要取消下载的媒体消息实体

    • Optionalcallback: IRCIMIWCancelDownloadingMediaMessageCallback

      取消下载媒体消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取某个会话

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可

    • Optionalcallback: IRCIMIWGetConversationCallback

      获取会话事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取某些会话

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可

    • startTime: number

      时间戳(毫秒),获取小于此时间戳的会话,传 0 为查询最新数据

    • count: number

      查询的数量, 0 < count <= 50

    • Optionalcallback: IRCIMIWGetConversationsCallback

      获取会话列表事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取指定类型的含有未读消息的会话列表

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 移除某个会话

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可

    • Optionalcallback: IRCIMIWRemoveConversationCallback

      移除会话事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据会话类型移除会话

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型集合

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWRemoveConversationsCallback

      移除会话列表事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取某个会话的未读数 注:不支持聊天室!

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetUnreadCountCallback

      获取会话未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取所有未读数

    Parameters

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetTotalUnreadCountCallback

      获取所有未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话中未读的 @ 消息数量。 注:不支持聊天室!

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetUnreadMentionedCountCallback

      获取会话中未读的 @ 消息数量事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取当前用户加入的所有超级群会话的未读消息数的总和。

    Parameters

    • Optionalcallback: IRCIMIWGetUltraGroupAllUnreadCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取当前用户加入的所有超级群会话中的未读 @ 消息数的总和。

    Parameters

    • Optionalcallback: IRCIMIWGetUltraGroupAllUnreadMentionedCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取指定会话的未读消息数

    Parameters

    • targetId: string

      会话 ID

    • Optionalcallback: IRCIMIWGetUltraGroupUnreadCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取超级群会话中被 @ 的消息数

    Parameters

    • targetId: string

      会话 ID

    • Optionalcallback: IRCIMIWGetUltraGroupUnreadMentionedCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据会话类型加载未读数 注:不支持聊天室!

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型集合

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • contain: boolean

      是否包含免打扰消息的未读消息数。

    • Optionalcallback: IRCIMIWGetUnreadCountByConversationTypesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 清除某个会话中的未读消息数。 注:不支持聊天室!

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • timestamp: number

      该会话已阅读的最后一条消息的发送时间戳,清除所有传入当前最新时间戳

    • Optionalcallback: IRCIMIWClearUnreadCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 保存会话草稿信息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • draft: string

      草稿的文字内容。

    • Optionalcallback: IRCIMIWSaveDraftMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话中的草稿信息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetDraftMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除指定会话中的草稿信息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWClearDraftMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取免打扰的会话列表。

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型集合

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetBlockedConversationsCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置会话的置顶状态。若会话不存在,调用此方法 SDK 自动创建会话并置顶。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • top: boolean

      是否置顶

    • Optionalcallback: IRCIMIWChangeConversationTopStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话的置顶状态

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetConversationTopStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 同步会话阅读状态。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • timestamp: number

      会话中已读的最后一条消息的发送时间戳

    • Optionalcallback: IRCIMIWSyncConversationReadStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 向会话中发送正在输入的状态,目前只支持单聊。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • currentType: string

      当前的状态

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 加载历史消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • sentTime: number

      当前消息时间戳

    • order: RCIMIWTimeOrder

      获取消息的方向。BEFORE:获取 sentTime 之前的消息 (时间递减),AFTER:获取 sentTime 之后的消息 (时间递增)

    • policy: RCIMIWMessageOperationPolicy

      消息的加载策略。LOCAL:只加载本地,REMOTE:只加载远端,LOCAL_REMOTE:本地远端都加载

    • count: number

      获取的消息数量,0 < count <= 20

    • Optionalcallback: IRCIMIWGetMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据消息 id 获取消息体(本地数据库索引唯一值)。

    Parameters

    • messageId: number

      消息的 messageId,可在消息对象中获取

    • Optionalcallback: IRCIMIWGetMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 通过全局唯一 id 获取消息实体。

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值。

    • Optionalcallback: IRCIMIWGetMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取第一条未读消息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetFirstUnreadMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话中未读的 @ 消息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetUnreadMentionedMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 插入一条消息

    Parameters

    • message: RCIMIWMessage

      插入的消息

    • Optionalcallback: IRCIMIWInsertMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 插入多条消息,不支持超级群

    Parameters

    • messages: RCIMIWMessage[]

      插入的消息集合

    • Optionalcallback: IRCIMIWInsertMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 清除消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • timestamp: number

      清除消息截止时间戳,0 <= recordTime <= 当前会话最后一条消息的 sentTime, 0 清除所有消息,其他值清除小于等于 recordTime 的消息

    • policy: RCIMIWMessageOperationPolicy

      清除的策略

    • Optionalcallback: IRCIMIWClearMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除本地消息

    Parameters

    • messages: RCIMIWMessage[]

      消息集合

    • Optionalcallback: IRCIMIWDeleteLocalMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除消息

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • messages: RCIMIWMessage[]

      消息集合

    • Optionalcallback: IRCIMIWDeleteMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 撤回消息

    Parameters

    • message: RCIMIWMessage

      需要被撤回的消息

    • Optionalcallback: IRCIMIWRecallMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 发送某个会话中的消息阅读回执

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • timestamp: number

      该会话中已读的最后一条消息的发送时间戳

    • Optionalcallback: IRCIMIWSendPrivateReadReceiptMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 发起群聊消息已读回执请求

    Parameters

    • message: RCIMIWMessage

      需要请求已读回执的消息

    • Optionalcallback: IRCIMIWSendGroupReadReceiptRequestCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 发送群聊已读回执

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • messages: RCIMIWMessage[]

      会话中需要发送已读回执的消息列表

    • Optionalcallback: IRCIMIWSendGroupReadReceiptResponseCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 更新消息扩展信息 每条消息携带扩展信息键值对最大值 300个,单次设置扩展信息键值对最大值 20个

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值

    • expansion: Map<string, string>

      要更新的消息扩展信息键值对,类型是 HashMap;Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,不支持汉字。Value 可以输入空格

    • Optionalcallback: IRCIMIWUpdateMessageExpansionCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除消息扩展信息中特定的键值对

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值

    • keys: string[]

      消息扩展信息中待删除的 key 的列表,类型是 ArrayList

    • Optionalcallback: IRCIMIWRemoveMessageExpansionForKeysCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置消息发送状态。

    Parameters

    • messageId: number

      消息的 messageId,可在消息对象中获取

    • sentStatus: RCIMIWSentStatus

      要修改的状态

    • Optionalcallback: IRCIMIWChangeMessageSentStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置消息接收状态。

    Parameters

    • messageId: number

      消息的 messageId,可在消息对象中获取

    • receivedStatus: RCIMIWReceivedStatus

      要修改的状态

    • Optionalcallback: IRCIMIWChangeMessageReceivedStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 加入聊天室。

    Parameters

    • targetId: string

      聊天室会话 ID

    • messageCount: number

      进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50

    • autoCreate: boolean

      是否创建聊天室,TRUE 如果聊天室不存在,sdk 会创建聊天室并加入,如果已存在,则直接加入

    • Optionalcallback: IRCIMIWJoinChatRoomCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 退出聊天室。

    Parameters

    • targetId: string

      聊天室会话 ID

    • Optionalcallback: IRCIMIWLeaveChatRoomCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取聊天室历史消息记录。 注:必须先开通聊天室消息云存储功能。

    Parameters

    • targetId: string

      聊天室会话 ID

    • timestamp: number

      起始的消息发送时间戳

    • order: RCIMIWTimeOrder

      拉取顺序 0:倒序,1:正序

    • count: number

      要获取的消息数量,0 < count <= 50。

    • Optionalcallback: IRCIMIWGetChatRoomMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置聊天室自定义属性。

    Parameters

    • targetId: string

      聊天室会话 ID

    • key: string

      聊天室属性名称,Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,最大长度 128 个字符

    • value: string

      聊天室属性对应的值,最大长度 4096 个字符

    • deleteWhenLeft: boolean

      用户掉线或退出时,是否自动删除该 Key、Value 值

    • overwrite: boolean

      如果当前 key 存在,是否进行覆盖

    • Optionalcallback: IRCIMIWAddChatRoomEntryCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 批量设置聊天室自定义属性

    Parameters

    • targetId: string

      聊天室会话 ID

    • entries: Map<string, string>

      聊天室属性

    • deleteWhenLeft: boolean

      用户掉线或退出时,是否自动删除该 Key、Value 值

    • overwrite: boolean

      是否强制覆盖

    • Optionalcallback: IRCIMIWAddChatRoomEntriesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取聊天室单个属性。

    Parameters

    • targetId: string

      聊天室会话 ID

    • key: string

      聊天室属性键值

    • Optionalcallback: IRCIMIWGetChatRoomEntryCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取聊天室所有属性。

    Parameters

    • targetId: string

      聊天室会话 ID

    • Optionalcallback: IRCIMIWGetChatRoomAllEntriesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除聊天室自定义属性。

    Parameters

    • targetId: string

      聊天室会话 ID

    • key: string

      聊天室属性键值

    • force: boolean

      是否强制删除

    • Optionalcallback: IRCIMIWRemoveChatRoomEntryCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 批量删除聊天室自定义属性

    Parameters

    • targetId: string

      聊天室会话 ID

    • keys: string[]

      聊天室属性

    • force: boolean

      是否强制覆盖

    • Optionalcallback: IRCIMIWRemoveChatRoomEntriesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 将某个用户加入黑名单。 当你把对方加入黑名单后,对方再发消息时,就会提示“已被加入黑名单,消息发送失败”。 但你依然可以发消息个对方。

    Parameters

    • userId: string

      用户 Id

    • Optionalcallback: IRCIMIWAddToBlacklistCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 将某个用户从黑名单中移出。

    Parameters

    • userId: string

      用户 Id

    • Optionalcallback: IRCIMIWRemoveFromBlacklistCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取某用户是否在黑名单中。

    Parameters

    • userId: string

      用户 Id

    • Optionalcallback: IRCIMIWGetBlacklistStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取当前用户设置的黑名单列表。

    Parameters

    • Optionalcallback: IRCIMIWGetBlacklistCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据关键字搜索指定会话中的消息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • keyword: string

      搜索的关键字

    • startTime: number

      查询 beginTime 之前的消息, 传 0 时从最新消息开始搜索,从该时间往前搜索。

    • count: number

      查询的数量,0 < count <= 50。

    • Optionalcallback: IRCIMIWSearchMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据关键字搜索指定会话中某个时间段的消息。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • keyword: string

      搜索的关键字

    • startTime: number

      开始时间

    • endTime: number

      结束时间

    • offset: number

      偏移量

    • count: number

      返回的搜索结果数量,0 < count <= 50。

    • Optionalcallback: IRCIMIWSearchMessagesByTimeRangeCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据用户 id 搜索指定会话中的消息。

    Parameters

    • userId: string

      用户 id

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • startTime: number

      查询记录的起始时间, 传 0 时从最新消息开始搜索,从该时间往前搜索。

    • count: number

      返回的搜索结果数量 0 < count <= 50。

    • Optionalcallback: IRCIMIWSearchMessagesByUserIdCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据关键字搜索会话。

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型集合

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • messageTypes: RCIMIWMessageType[]

      搜索的消息类型

    • keyword: string

      搜索的关键字。

    • Optionalcallback: IRCIMIWSearchConversationsCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 屏蔽某个时间段的消息提醒

    Parameters

    • startTime: string

      开始消息免打扰时间,格式为 HH:MM:SS

    • spanMinutes: number

      需要消息免打扰分钟数,0 < spanMinutes < 1440( 比如,您设置的起始时间是 00:00, 结束时间为 01:00,则 spanMinutes 为 60 分钟。设置为 1439 代表全天免打扰 (23 60 + 59 = 1439 ))

    • level: RCIMIWPushNotificationQuietHoursLevel

      消息通知级别

    • Optionalcallback: IRCIMIWChangeNotificationQuietHoursCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除已设置的全局时间段消息提醒屏蔽

    Parameters

    • Optionalcallback: IRCIMIWRemoveNotificationQuietHoursCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取已设置的时间段消息提醒屏蔽

    Parameters

    • Optionalcallback: IRCIMIWGetNotificationQuietHoursCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置会话的消息提醒状态 注:超级群调用该接口,channelId 为空时,相当于设置了 channelId 为空的频道的免打扰,不会屏蔽整个超级群会话下所有频道的免打扰

    Parameters

    • type: RCIMIWConversationType

      会话类型。请注意以下限制:

      • 超级群会话类型:如在 2022.09.01 之前开通超级群业务,默认不支持为单个超级群会话所有消息设置免打扰级别(“所有消息”指所有频道中的消息和不属于任何频道的消息)。该接口仅设置指定超级群会话(targetId)中不属于任何频道的消息的免打扰状态级别。如需修改请提交工单。
      • 聊天室会话类型:不支持,因为聊天室消息默认不支持消息推送提醒。

    • targetId: string

      会话 ID

    • channelId: string

      超级群的会话频道 ID。其他类型传 null 即可。

      • 如果传入频道 ID,则针对该指定频道设置消息免打扰级别。如果不指定频道 ID,则对所有超级群消息生效。
      • 注意:2022.09.01 之前开通超级群业务的客户,如果不指定频道 ID,则默认传 "" 空字符串,即仅针对指定超级群会话(targetId)中不属于任何频道的消息设置免打扰状态级别。如需修改请提交工单。

    • level: RCIMIWPushNotificationLevel

      消息通知级别

    • Optionalcallback: IRCIMIWChangeConversationNotificationLevelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话的消息提醒状态

    Parameters

    • type: RCIMIWConversationType

      会话类型。请注意以下限制:

      • 超级群会话类型:如在 2022.09.01 之前开通超级群业务,默认不支持为单个超级群会话所有消息设置免打扰级别(“所有消息”指所有频道中的消息和不属于任何频道的消息)。该接口仅设置指定超级群会话(targetId)中不属于任何频道的消息的免打扰状态级别。如需修改请提交工单。
      • 聊天室会话类型:不支持,因为聊天室消息默认不支持消息推送提醒。

    • targetId: string

      会话 ID

    • channelId: string

      超级群的会话频道 ID。其他类型传 null 即可。

      • 如果传入频道 ID,则针对该指定频道设置消息免打扰级别。如果不指定频道 ID,则对所有超级群消息生效。
      • 注意:2022.09.01 之前开通超级群业务的客户,如果不指定频道 ID,则默认传 "" 空字符串,即仅针对指定超级群会话(targetId)中不属于任何频道的消息设置免打扰状态级别。如需修改请提交工单。

    • Optionalcallback: IRCIMIWGetConversationNotificationLevelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取会话类型的消息提醒状态

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置超级群的默认消息状态 一般由管理员设置的接口,针对超级群的所有群成员生效,针对超级群下所有频道生效,优先级较低。如果群成员自己超级群的免打扰级别,那么以群成员自己设置的为准。

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取超级群的默认消息状态

    Parameters

    • targetId: string

      会话 ID

    • Optionalcallback: IRCIMIWGetUltraGroupDefaultNotificationLevelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置超级群频道的默认消息状态

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用。

    • level: RCIMIWPushNotificationLevel

      消息通知级别

    • Optionalcallback: IRCIMIWChangeUltraGroupChannelDefaultNotificationLevelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取超级群频道的默认消息状态

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用。

    • Optionalcallback: IRCIMIWGetUltraGroupChannelDefaultNotificationLevelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置是否显示远程推送内容详情,此功能需要从服务端开启用户设置功能。

    Parameters

    • showContent: boolean

      是否显示远程推送内容

    • Optionalcallback: IRCIMIWChangePushContentShowStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置推送语言

    Parameters

    • language: string

      推送语言, 目前仅支持 en_us、zh_cn、ar_sa

    • Optionalcallback: IRCIMIWChangePushLanguageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 设置是否接收远程推送。 前提:移动端未在线,Web 、MAC/PC 终端在线,移动端是否接收远程推送。 此功能需要从服务端开启用户设置功能。

    Parameters

    • receive: boolean

      是否接收

    • Optionalcallback: IRCIMIWChangePushReceiveStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 给指定的群成员发送消息

    Parameters

    • message: RCIMIWMessage

      要发送的消息

    • userIds: string[]

      群成员集合

    • Optionalcallback: RCIMIWSendGroupMessageToDesignatedUsersCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取指定会话的消息总数。

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetMessageCountCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 根据会话类型,获取置顶会话列表

    Parameters

    • conversationTypes: RCIMIWConversationType[]

      会话类型集合

    • channelId: string

      频道 ID,仅支持超级群使用,其他会话类型传 null 即可。

    • Optionalcallback: IRCIMIWGetTopConversationsCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 上报超级群的已读时间

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用。

    • timestamp: number

      已读时间

    • Optionalcallback: IRCIMIWSyncUltraGroupReadStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取特定会话下所有频道的会话列表,只支持超级群

    Parameters

    • type: RCIMIWConversationType

      会话类型

    • targetId: string

      会话 ID

    • Optionalcallback: IRCIMIWGetConversationsForAllChannelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 修改超级群消息

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值

    • message: RCIMIWMessage

      要修改的 message

    • Optionalcallback: IRCIMIWModifyUltraGroupMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 撤回超级群消息

    Parameters

    • message: RCIMIWMessage

      需要撤回的消息

    • deleteRemote: boolean

      是否删除远端消息

    • Optionalcallback: IRCIMIWRecallUltraGroupMessageCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除超级群指定时间之前的消息

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用。

    • timestamp: number

      时间戳

    • policy: RCIMIWMessageOperationPolicy

      清除策略

    • Optionalcallback: IRCIMIWClearUltraGroupMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 发送超级群输入状态

    Parameters

    • targetId: string

      会话 ID

    • channelId: string

      频道 ID,仅支持超级群使用。

    • typingStatus: TEXT

      输入状态

    • Optionalcallback: IRCIMIWSendUltraGroupTypingStatusCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除超级群所有频道指定时间之前的消息

    Parameters

    • targetId: string

      会话 ID

    • timestamp: number

      时间戳

    • Optionalcallback: IRCIMIWClearUltraGroupMessagesForAllChannelCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 从服务获取批量消息

    Parameters

    • messages: RCIMIWMessage[]

      获取的消息集合

    • Optionalcallback: IRCIMIWGetBatchRemoteUltraGroupMessagesCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 更新超级群消息扩展信息

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值

    • expansion: Map<string, string>

      更新的消息扩展信息键值对,类型是 HashMap;Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,不支持汉字。Value 可以输入空格。

    • Optionalcallback: IRCIMIWUpdateUltraGroupMessageExpansionCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除超级群消息扩展信息中特定的键值对

    Parameters

    • messageUId: string

      消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值

    • keys: string[]

      消息扩展信息中待删除的 key 的列表,类型是 ArrayList

    • Optionalcallback: IRCIMIWRemoveUltraGroupMessageExpansionForKeysCallback

      事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式,预计将在 6.x 版本删除此其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 修改日志等级

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取本地时间与服务器时间的时间差。消息发送成功后,SDK 与服务器同步时间,消息所在数据库中存储的时间就是服务器时间。 System.currentTimeMillis() - getDeltaTime() 可以获取服务器当前时间。

    Returns Promise<number>

    本地时间与服务器时间的差值

  • 创建标签信息

    Parameters

    • tagId: string

      标签唯一标识,字符型,长度不超过 10 个字。

    • tagName: string

      长度不超过 15 个字,标签名称可以重复。

    • Optionalcallback: IRCIMIWCreateTagCallback

      事件回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 移除标签

    Parameters

    • tagId: string

      标签唯一标识,字符型,长度不超过 10 个字。

    • Optionalcallback: IRCIMIWRemoveTagCallback

      事件回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 更新标签信息

    Parameters

    • tagId: string

      标签唯一标识,字符型,长度不超过 10 个字。

    • newName: string

      长度不超过 15 个字,标签名称可以重复。

    • Optionalcallback: IRCIMIWUpdateTagNameByIdCallback

      事件回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取当前用户已创建的标签信息

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 将一个会话添加到指定标签

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 从标签中移除一个会话

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 为指定会话移除一个或多个标签

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 以会话中最后一条消息时间戳为界,分页获取本地指定标签下会话列表

    Parameters

    • tagId: string

      标签唯一标识,字符型,长度不超过 10 个字。

    • timestamp: number

      会话的时间戳。获取这个时间戳之前的会话列表。首次可传 0,后续可以使用返回的 RCConversation 对象的 operationTime 属性值,作为下一次查询的 startTime。

    • count: number

      获取的数量。当实际取回的会话数量小于 count 值时,表明已取完数据。

    • Optionalcallback: IRCIMIWGetConversationsCallback

      事件回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 获取携带指定标签的所有会话的未读消息数。

    Parameters

    • tagId: string

      标签唯一标识,字符型,长度不超过 10 个字。

    • contain: boolean

      是否包含免打扰会话。

    • Optionalcallback: IRCIMIWGetUnreadCountCallback

      事件回调。

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 在携带指定标签的所有会话中设置指定会话置顶。例如,在所有添加了「培训班」标签的会话中将与「Tom」的私聊会话置顶。

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 查询指定会话是否在携带同一标签的所有会话中置顶。获取成功后会返回是否已置顶。

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 清除携带指定标签的所有会话的未读消息数。

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 删除指定标签下的全部会话,同时解除这些会话和标签的绑定关系。删除成功后,会话不再携带指定的标签。这些会话收到新消息时,会产生新的会话。

    Parameters

    Returns Promise<number>

    当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

  • 收到消息的监听

    Parameters

    • Optionallistener: (
          message: RCIMIWMessage,
          left: number,
          offline: boolean,
          hasPackage: boolean,
      ) => void

    Returns void

  • 网络状态变化

    Parameters

    Returns void

  • 会话状态置顶多端同步监听

    Parameters

    • Optionallistener: (
          type: RCIMIWConversationType,
          targetId: string,
          channelId: string,
          top: boolean,
      ) => void

    Returns void

  • 会话状态免打扰多端同步监听

    Parameters

    Returns void

  • 撤回消息监听器

    Parameters

    Returns void

  • 单聊中收到消息回执的回调。

    Parameters

    • Optionallistener: (targetId: string, channelId: string, timestamp: number) => void

    Returns void

  • 消息扩展信息更改的回调

    Parameters

    • Optionallistener: (expansion: Map<string, string>, message: RCIMIWMessage) => void

    Returns void

  • 消息扩展信息删除的回调

    Parameters

    • Optionallistener: (message: RCIMIWMessage, keys: string[]) => void

    Returns void

  • 聊天室用户进入、退出聊天室监听

    Parameters

    Returns void

  • 会话输入状态发生变化。对于单聊而言,当对方正在输入时,监听会触发一次;当对方不处于输入状态时,该监听还会触发一次,但回调里输入用户列表为空。

    Parameters

    Returns void

  • 同步消息未读状态监听接口。多端登录,收到其它端清除某一会话未读数通知的时候

    Parameters

    Returns void

  • 聊天室 KV 同步完成的回调

    Parameters

    • Optionallistener: (roomId: string) => void

    Returns void

  • 聊天室 KV 发生变化的回调

    Parameters

    Returns void

  • 超级群消息 kv 被更新

    Parameters

    Returns void

  • 超级群消息被更改

    Parameters

    Returns void

  • 超级群消息被撤回

    Parameters

    Returns void

  • 超级群已读的监听

    Parameters

    • Optionallistener: (targetId: string, channelId: string, timestamp: number) => void

    Returns void

  • 用户输入状态变化的回调 当客户端收到用户输入状态的变化时,会回调此接口,通知发生变化的会话以及当前正在输入的RCUltraGroupTypingStatusInfo列表

    Parameters

    Returns void

  • 发送含有敏感词消息被拦截的回调

    Parameters

    Returns void

  • 聊天室状态发生变化的监听

    Parameters

    Returns void

  • 收到群聊已读回执请求的监听

    Parameters

    • Optionallistener: (targetId: string, messageUId: string) => void

    Returns void

  • 收到群聊已读回执响应的监听

    Parameters

    • Optionallistener: (
          targetId: string,
          messageUId: string,
          respondUserIds: Map<string, number>,
      ) => void

    Returns void

  • 超级群列表同步完成的回调

    Parameters

    • Optionallistener: () => void

    Returns void

  • 正在加入聊天室的回调

    Parameters

    • Optionallistener: (targetId: string) => void

    Returns void