Options
All
  • Public
  • Public/Protected
  • All
Menu

Class IMClient

Hierarchy

  • IMClient

Index

Constructors

Methods

Constructors

constructor

  • new IMClient(_context: APIContext, _options: IIMClientOptions): IMClient

  • Parameters

    • _context: APIContext
    • _options: IIMClientOptions

    Returns IMClient

Methods

RTCPing

  • RTCPing(room: RTCRoomOption, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<boolean, void>

    Returns void

addTagForConversations

  • addTagForConversations(tagId: string, conversations: IConversationOption[], callback: ICallback<void, void>): void

  • 添加会话到指定标签

    Parameters

    • tagId: string

      标签 ID

    • conversations: IConversationOption[]

      要添加的会话列表

    • callback: ICallback<void, void>

    Returns void

addToBlacklist

  • addToBlacklist(userId: string, callback: ICallback<void, void>): void

  • 加入黑名单

    Parameters

    • userId: string

      用户 ID

    • callback: ICallback<void, void>

    Returns void

callExtra

  • callExtra(method: string, callback: ICallback<unknown, unknown>, ...args: any[]): void

  • 调用非标准接口 - 所谓非标准接口，是为某些特定需求或产品临时添加的，暂未采纳为标准接口的方法。

    Parameters

    • method: string

      接口定义名称

    • callback: ICallback<unknown, unknown>

      回调函数

    • Rest ...args: any[]

      参数列表

    Returns void

clearCache

  • clearCache(): void

  • 清除内存或本地缓存数据

    Returns void

clearConversations

  • clearConversations(callback: ICallback<boolean, void>, conversationTypes: ConversationType[]): void

  • 删除指定类型会话，该方法已弃用

    description

    仅可在协议栈连接下调用

    Parameters

    Returns void

clearMessages

  • clearMessages(conversationType: ConversationType, targetId: string, callback: ICallback<boolean, void>): void

  • 清空会话下历史消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • callback: ICallback<boolean, void>

    Returns void

clearRemoteHistoryMessages

  • clearRemoteHistoryMessages(param: IDelteByTime, callback: ICallback<void, void>): void

  • 通过时间戳删除消息

    Parameters

    • param: IDelteByTime
    • callback: ICallback<void, void>

    Returns void

clearTextMessageDraft

  • clearTextMessageDraft(conversationType: ConversationType, targetId: string): boolean

  • 删除草稿

    Parameters

    Returns boolean

clearUnreadCount

  • clearUnreadCount(conversationType: ConversationType, targetId: string, callback: ICallback<boolean, void>): void

  • 清除指定会话未读数

    Parameters

    • conversationType: ConversationType
    • targetId: string
    • callback: ICallback<boolean, void>

    Returns void

clearUnreadCountByTimestamp

  • clearUnreadCountByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, callback: ICallback<boolean, void>): void

  • 清除时间戳前的未读数

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • timestamp: number

      目标 ID

    • callback: ICallback<boolean, void>

    Returns void

createTag

  • createTag(tag: ITagParam, callback: ICallback<void, void>): void

  • 创建标签

    Parameters

    • tag: ITagParam

      标签信息

    • callback: ICallback<void, void>

    Returns void

deleteChannels

  • deleteChannels(channelIds: string[]): void

  • 批量删除 channel proxy 实例

    Parameters

    • channelIds: string[]

      会话标识 ID

    Returns void

deleteLocalMessages

  • deleteLocalMessages(_: ConversationType, __: string, messageIds: number[], callback: ICallback<boolean, void>): void

  • 删除本地消息

    Parameters

    • _: ConversationType

      会话类型，参数无效

    • __: string

      目标 ID，参数无效

    • messageIds: number[]

      消息 ID 数组

    • callback: ICallback<boolean, void>

    Returns void

deleteLocalMessagesByTimestamp

  • deleteLocalMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, callback: ICallback<boolean, void>): void

  • 从本地消息数据库中删除某一会话指定时间之前的消息数据

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • timestamp: number

      指定删除该时间戳之前的消息

    • cleanSpace: boolean

      指定删除该时间戳之前的消息。是否清理数据条目所使用的磁盘空间。清理磁盘空间会阻塞进程且耗时较长，不推荐使用。 数据在被抹除的情况下，未清理的磁盘空间会在后续存储操作中复用，且对数据查询无影响

    • callback: ICallback<boolean, void>

    Returns void

deleteRemoteMessages

  • deleteRemoteMessages(conversationType: ConversationType, targetId: string, messages: IDeleteMessge[], callback: ICallback<void, void>): void

  • 通过 messageUId 删除消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      会话 id

    • messages: IDeleteMessge[]

      要删除的消息 []

    • callback: ICallback<void, void>

    Returns void

disconnect

  • disconnect(): Promise<void>

  • 断开当前连接

    description

    相较于原 SDK 2.0 版本的 disconnect，此方法会返回一个 Promise 对象

    Returns Promise<void>

    Promise

forceRemoveChatroomEntry

  • forceRemoveChatroomEntry(chatRoomId: string, chatroomEntry: IRemoveChatRoomEntryOption, callback: ICallback<void, void>): void

  • 强制删除任意聊天室属性

    description

    该方法仅限于删除自己设置的聊天室属性

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • chatroomEntry: IRemoveChatRoomEntryOption

      要移除的属性信息

    • callback: ICallback<void, void>

    Returns void

forceSetChatroomEntry

  • forceSetChatroomEntry(chatRoomId: string, chatroomEntry: IChatroomEntry, callback: ICallback<void, void>): void

  • 在指定聊天室中强制增加 / 修改任意聊天室属性

    description

    仅聊天室中不存在此属性或属性设置者为己方时可设置成功

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • chatroomEntry: IChatroomEntry

      属性信息

    • callback: ICallback<void, void>

    Returns void

getAllChatroomEntries

  • getAllChatroomEntries(chatRoomId: string, callback: ICallback<{}, void>): void

  • 获取聊天室内的所有属性

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • callback: ICallback<{}, void>

    Returns void

getAppInfo

  • getAppInfo(): { appKey: string }

  • 获取 App 信息，RTC Lib 使用

    Returns { appKey: string }

    • appKey: string

getBlacklist

  • getBlacklist(callback: ICallback<string[], void>): void

  • 获取黑名单列表

    Parameters

    • callback: ICallback<string[], void>

    Returns void

getBlacklistStatus

  • getBlacklistStatus(userId: string, callback: ICallback<string, void>): void

  • 获取指定人员在黑名单中的状态

    Parameters

    • userId: string

      用户 ID

    • callback: ICallback<string, void>

    Returns void

getChannel

  • 获取 channel proxy 实例

    Parameters

    • channelId: string

      会话标识 ID

    Returns null | ChannelClient

getChatRoomHistoryMessages

  • getChatRoomHistoryMessages(chatRoomId: string, count: number, order: 0 | 1, callback: ICallback<IReceivedMessageV2[], boolean>, timestamp?: number): void

  • 拉取聊天室内的历史消息

    Parameters

    • chatRoomId: string
    • count: number

      拉取消息条数, 有效值范围 1 - 20

    • order: 0 | 1

      获取顺序，默认值为 0。

      • 0：降序，用于获取早于指定时间戳发送的消息
      • 1：升序，用于获取晚于指定时间戳发送的消息
    • callback: ICallback<IReceivedMessageV2[], boolean>
    • timestamp: number = 0

      v3.0 版本中的新增参数，用于指定拉取消息用到的时间戳。默认值为0，表示按当前时间拉取

    Returns void

getChatRoomInfo

  • getChatRoomInfo(chatRoomId: string, count: number, order: 1 | 2, callback: ICallback<IV2ChatRoomInfo, void>): void

  • 获取聊天室信息

    Parameters

    • chatRoomId: string

      聊天室 id

    • count: number

      获取人数, 范围 0 - 20

      1. 传入 0 获取到的聊天室信息将或仅包含成员总数，不包含具体的成员列表
      2. 传入其他大于 0 的值返回聊天室信息，结果仅包含包含不多于 20 人的成员信息和当前成员总数。最大值为 20
    • order: 1 | 2

      排序方式，1 为正序，2 为倒序

    • callback: ICallback<IV2ChatRoomInfo, void>

    Returns void

getChatroomEntry

  • getChatroomEntry(chatRoomId: string, key: string, callback: ICallback<string, void>): void

  • 获取聊天室中的指定属性

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • key: string

      属性键名

    • callback: ICallback<string, void>

    Returns void

getConversation

  • 获取指定会话

    description

    相较于 2.0 中从本地缓存获取会话，当前方法从服务器拉取

    Parameters

    Returns void

getConversationList

  • getConversationList(callback: ICallback<IConversation[], void>, conversationTypes: null | Number[], count?: number): void

  • 获取会话列表，相对于 2.0 的接口，该接口结果中不再展开会话中最后一条消息的数据

    Parameters

    • callback: ICallback<IConversation[], void>

      结果回调

    • conversationTypes: null | Number[]

      会话类型，为 null 时，返回全部会话

    • Optional count: number

      获取数量，默认 300

    Returns void

getConversationListByTag

  • getConversationListByTag(tagId: string, count: number, startTime: number, callback: ICallback<IV2ConversationContainTag[], void>): void

  • 分页获取标签下会话列表

    Parameters

    • tagId: string

      标签id

    • count: number

      获取数量

    • startTime: number
    • callback: ICallback<IV2ConversationContainTag[], void>

    Returns void

getConversationNotificationStatus

  • getConversationNotificationStatus(conversationType: ConversationType, targetId: string, callback: ICallback<NotificationStatus, void>): void

  • 获取会话免打扰状态

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • callback: ICallback<NotificationStatus, void>

    Returns void

getConversationUnreadCount

  • getConversationUnreadCount(conversationType: ConversationType, callback: ICallback<number, void>): void

  • 该方法已弃用按会话类型获取消息未读数

    deprecated

    Parameters

    Returns void

getCurrentConnectionStatus

  • 获取当前 IM 连接状态

    Returns ConnectionStatus

getCurrentUserId

  • getCurrentUserId(): string

  • 获取当前用户 ID

    Returns string

getFileToken

  • getFileToken(fileType: FileType, callback: ICallback<IUploadAuth & { bos: string; qiniu: string }, void>, fileName?: string, httpMethod?: "PUT" | "POST", queryString?: string): void

  • 获取存储服务鉴权信息

    description

    httpMethod 与 queryString 为 STC S3 分段上传时的专属参数，STC 分段上传包含三个过程：

    1. 开始分段前调用，此时 httpMethod 值应为 POST， queryString 值为 uploads,filename为空
    2. 上传请求前调用，此时 httpMethod 值应为 PUT，queryString 值为 partNumber={partamNumer}&uploadId={uploadId}，filename为第一个步骤生成的filename
    3. 上传结束前调用，此时 httpMethod 值应为 POST，queryString 值为 uploadId={uploadId}，filename为第一个步骤生成的filename

    Parameters

    • fileType: FileType

      文件类型

    • callback: ICallback<IUploadAuth & { bos: string; qiniu: string }, void>
    • Optional fileName: string

      文件名称

    • Optional httpMethod: "PUT" | "POST"

      STC 分段上传时的必填参数，有效值为 PUT | POST

    • Optional queryString: string

      STC 分段上传时的查询字符串

    Returns void

getFileUrl

  • getFileUrl(fileType: FileType, fileName: string, saveName: string, callback: ICallback<IGetFileUrl, void>, uploadRes?: { downloadUrl: string; isBosRes: boolean }, serverType?: UploadMethod): void

  • 获取文件地址

    Parameters

    • fileType: FileType

      上传类型

    • fileName: string
    • saveName: string

      下载存储文件名

    • callback: ICallback<IGetFileUrl, void>

      结果回调函数

    • Optional uploadRes: { downloadUrl: string; isBosRes: boolean }

      上传插件返回的数据

      • downloadUrl: string
      • isBosRes: boolean
    • Optional serverType: UploadMethod

      存储服务标识

    Returns void

getFirstUnreadMessage

  • getFirstUnreadMessage(conversationType: ConversationType, targetId: string, callback: ICallback<null | IReceivedMessageV2, void>): void

  • 获取第一个未读消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • callback: ICallback<null | IReceivedMessageV2, void>

    Returns void

getHistoryMessages

  • getHistoryMessages(conversationType: ConversationType, targetId: string, timestamp: number, count: number, callback: ICallback<IReceivedMessageV2[], boolean>, objectName?: string, order?: 0 | 1): void

  • 从服务端拉取指定会话的历史消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      会话 ID

    • timestamp: number

      获取时间戳, 0 为从当前时间拉取

    • count: number

      拉取条数，获取条数, 范围 1 - 20

    • callback: ICallback<IReceivedMessageV2[], boolean>
    • Optional objectName: string
    • Optional order: 0 | 1

      获取顺序，默认为 0。0 为升序，获取消息发送时间比 timestamp 更早的消息；1 为降序。

    Returns void

getMessage

  • getMessage(messageId: number, callback: ICallback<IReceivedMessageV2, void>): void

  • 获取消息

    Parameters

    • messageId: number

      本地消息 ID 或 messageUId

    • callback: ICallback<IReceivedMessageV2, void>

    Returns void

getMessageReader

  • getMessageReader(messageUId: string, targetId: string, callback: ICallback<IMessageReaderResponse, void>): void

  • 获取群已读列表

    Parameters

    Returns void

getNavi

  • getNavi(): {} | INaviInfo

  • 获取导航新 RTC Lib 使用

    Returns {} | INaviInfo

getRTCData

  • getRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType, callback: ICallback<KVString, void>): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • apiType: RTCApiType
    • callback: ICallback<KVString, void>

    Returns void

getRTCOutData

  • getRTCOutData(roomId: string, userIds: string[], callback: ICallback<void, void>): void

  • Parameters

    • roomId: string
    • userIds: string[]
    • callback: ICallback<void, void>

    Returns void

getRTCRoomData

  • getRTCRoomData(roomId: string, keys: string[], isInner: boolean, callback: ICallback<KVString, void>): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • callback: ICallback<KVString, void>

    Returns void

getRTCRoomInfo

  • getRTCRoomInfo(room: RTCRoomOption, callback: ICallback<IRTCRoomInfo, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<IRTCRoomInfo, void>

    Returns void

getRTCToken

  • getRTCToken(room: RTCRoomOption, callback: ICallback<IRtcTokenData, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<IRtcTokenData, void>

    Returns void

getRTCUserData

  • getRTCUserData(roomId: string, keys: string[], isInner: boolean, callback: ICallback<KVString, void>): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • callback: ICallback<KVString, void>

    Returns void

getRTCUserInfoList

  • getRTCUserInfoList(room: RTCRoomOption, callback: ICallback<{}, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<{}, void>

    Returns void

getRTCUserList

  • getRTCUserList(room: RTCRoomOption, callback: ICallback<IRTCUsers, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<IRTCUsers, void>

    Returns void

getRemoteHistoryMessages

  • getRemoteHistoryMessages(conversationType: ConversationType, targetId: string, timestamp: number, count: number, callback: ICallback<IReceivedMessageV2[], boolean>, options?: { order?: 0 | 1 }): void

  • 获取远端历史消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      会话 ID

    • timestamp: number

      获取时间戳, 0 为从当前时间拉取

    • count: number

      拉取条数，获取条数, 范围 1 - 20

    • callback: ICallback<IReceivedMessageV2[], boolean>
    • options: { order?: 0 | 1 } = {}
      • Optional order?: 0 | 1

        获取顺序, 默认为 0

    Returns void

getSDKInfo

  • getSDKInfo(): { version: string }

  • 获取 SDK 信息 RTC Lib 使用

    Returns { version: string }

    • version: string

getServerTime

  • getServerTime(): number

  • 获取服务器时间

    Returns number

getTagList

  • getTagList(callback: ICallback<ITagInfo[], void>): void

  • 获取标签列表

    Parameters

    • callback: ICallback<ITagInfo[], void>

    Returns void

getTagsForConversation

  • getTagsForConversation(conversation: IConversationOption, callback: ICallback<IConversationTag[], void>): void

  • 获取会话下的标签

    Parameters

    • conversation: IConversationOption

      会话信息

    • callback: ICallback<IConversationTag[], void>

    Returns void

getTextMessageDraft

  • getTextMessageDraft(conversationType: ConversationType, targetId: string): undefined | string

  • 获取草稿信息

    description

    未登录或无草稿数据时将返回 undefined

    Parameters

    Returns undefined | string

getTotalUnreadCount

  • getTotalUnreadCount(callback: ICallback<number, void>, conversationTypes?: ConversationType[], includeMuted?: boolean): void

  • 获取所有会话的消息未读数

    description
    1. 清除浏览器缓存会导致会话未读数不准确
    2. 会话消息未读数存储在 WebStorage 中, 若浏览器不支持或禁用 WebStorage，未读消息数将不会保存，浏览器页面刷新未读消息数将不会存在

    Parameters

    • callback: ICallback<number, void>
    • Optional conversationTypes: ConversationType[]

      要获取未读数的会话类型，若为空，则默认获取单聊、群聊及系统消息未读数（web 暂未实现）

    • Optional includeMuted: boolean

      是否包含免打扰会话（web 暂未实现）

    Returns void

getUnreadCount

  • getUnreadCount(conversationType: ConversationType, targetId: string, callback: ICallback<number, void>): void

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

    todo

    Parameters

    • conversationType: ConversationType
    • targetId: string
    • callback: ICallback<number, void>

    Returns void

getUnreadCountByTag

  • getUnreadCountByTag(tagId: string, containMuted: boolean, callback: ICallback<number, void>): void

  • 根据标签获取未读消息数

    Parameters

    • tagId: string

      标签id

    • containMuted: boolean

      是否包含免打扰

    • callback: ICallback<number, void>

    Returns void

getUnreadMentionedMessages

  • getUnreadMentionedMessages(conversationType: ConversationType, targetId: string): null | IReceivedMessageV2[]

  • 获取会话下所有未读的 @ 消息

    Parameters

    Returns null | IReceivedMessageV2[]

getUserStatus

  • getUserStatus(userId: string, callback: ICallback<{ status?: number }, void>): void

  • 获取用户在线状态

    Parameters

    • userId: string

      用户 ID

    • callback: ICallback<{ status?: number }, void>

    Returns void

hasRemoteUnreadMessages

  • hasRemoteUnreadMessages(token: string, callback: ICallback<Boolean, void>): void

  • 是否有远端未读消息 （ C++ ）

    description

    Parameters

    • token: string
    • callback: ICallback<Boolean, void>

    Returns void

insertMessage

  • insertMessage(conversationType: ConversationType, targetId: string, content: IReceivedMessageV2, callback: ICallback<IReceivedMessageV2, void>, options?: IInsertOptions): void

  • 向本地插入一条消息，不发送到服务器

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • content: IReceivedMessageV2

      消息体

    • callback: ICallback<IReceivedMessageV2, void>
    • options: IInsertOptions = {}

    Returns void

install

  • install<T, O>(plugin: IPluginGenerator<T, O>, options: O): null | T

  • 装载插件，并返回相应的插件实例

    Type parameters

    • T

    • O

    Parameters

    • plugin: IPluginGenerator<T, O>
    • options: O

    Returns null | T

joinChatRoom

  • joinChatRoom(chatRoomId: string, count: number, callback: ICallback<void, void>): void

  • 加入聊天室

    Parameters

    • chatRoomId: string

      聊天室 id

    • count: number

      拉取聊天室消息数量

    • callback: ICallback<void, void>

    Returns void

joinRTCRoom

  • joinRTCRoom(room: RTCRoomOption, callback: ICallback<IJoinRTCRoomData, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<IJoinRTCRoomData, void>

    Returns void

logout

  • logout(): Promise<void>

  • 该方法等价于 disconnect

    Returns Promise<void>

quitChatRoom

  • quitChatRoom(chatRoomId: string, callback: ICallback<void, void>): void

  • 退出聊天室

    Parameters

    • chatRoomId: string

      聊天室 id

    • callback: ICallback<void, void>

    Returns void

quitRTCRoom

  • quitRTCRoom(room: RTCRoomOption, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • callback: ICallback<boolean, void>

    Returns void

removeChatRoomEntries

  • removeChatRoomEntries(chatRoomId: string, options: { entries: string[] }, callback: ICallback<void, void>): void

  • 批量删除聊天室属性

    description

    仅限于删除自己设置的聊天室属性

    Parameters

    • chatRoomId: string
    • options: { entries: string[] }

      entries属性名称集合, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符

      • entries: string[]
    • callback: ICallback<void, void>

    Returns void

removeChatroomEntry

  • removeChatroomEntry(chatRoomId: string, chatroomEntry: IRemoveChatRoomEntryOption, callback: ICallback<void, void>): void

  • 删除聊天室属性

    description

    该方法仅限于删除自己设置的聊天室属性

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • chatroomEntry: IRemoveChatRoomEntryOption

      要移除的属性信息

    • callback: ICallback<void, void>

    Returns void

removeConversation

  • removeConversation(conversationType: ConversationType, targetId: string, callback: ICallback<void, void>): void

  • 删除指定会话

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      会话 target_id

    • callback: ICallback<void, void>

      删除回调

    Returns void

removeFromBlacklist

  • removeFromBlacklist(userId: string, callback: ICallback<void, void>): void

  • 将指定用户移除黑名单

    Parameters

    • userId: string

      用户 ID

    • callback: ICallback<void, void>

    Returns void

removeMessageExpansionForKey

  • removeMessageExpansionForKey(keys: string[], message: IReceivedMessageV2, callback: ICallback<void, void>): void

  • 删除消息扩展属性

    Parameters

    • keys: string[]

      消息扩展信息中待删除的 key 的列表

    • message: IReceivedMessageV2

      要删除消息扩展的原始消息体

    • callback: ICallback<void, void>

    Returns void

removeRTCData

  • removeRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType, callback: ICallback<boolean, void>, message?: { content: string; name: string }): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • apiType: RTCApiType
    • callback: ICallback<boolean, void>
    • Optional message: { content: string; name: string }
      • content: string
      • name: string

    Returns void

removeRTCRoomData

  • removeRTCRoomData(roomId: string, keys: string[], isInner: boolean, callback: ICallback<boolean, void>, message?: any): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • callback: ICallback<boolean, void>
    • Optional message: any

    Returns void

removeRTCRoomInfo

  • removeRTCRoomInfo(room: RTCRoomOption, info: any, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • info: any
    • callback: ICallback<boolean, void>

    Returns void

removeRTCUserData

  • removeRTCUserData(roomId: string, keys: string[], isInner: boolean, callback: ICallback<boolean, void>, message?: { content: string; name: string }): void

  • Parameters

    • roomId: string
    • keys: string[]
    • isInner: boolean
    • callback: ICallback<boolean, void>
    • Optional message: { content: string; name: string }
      • content: string
      • name: string

    Returns void

removeRTCUserInfo

  • removeRTCUserInfo(room: RTCRoomOption, info: { keys: string[] }, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • info: { keys: string[] }
      • keys: string[]
    • callback: ICallback<boolean, void>

    Returns void

removeTag

  • removeTag(tagId: string, callback: ICallback<void, void>): void

  • 删除标签

    Parameters

    • tagId: string

      标签 ID

    • callback: ICallback<void, void>

    Returns void

removeTagForConversations

  • removeTagForConversations(tagId: string, conversations: IConversationOption[], callback: ICallback<void, void>): void

  • 删除指定标签中会话

    Parameters

    • tagId: string

      标签 ID

    • conversations: IConversationOption[]

      要删除的会话列表

    • callback: ICallback<void, void>

    Returns void

removeTagsForConversation

  • removeTagsForConversation(conversation: IConversationOption, tagIds: string[], callback: ICallback<void, void>): void

  • 删除指定会话中标签

    Parameters

    • conversation: IConversationOption

      会话

    • tagIds: string[]

      要删除的标签列表

    • callback: ICallback<void, void>

    Returns void

saveTextMessageDraft

  • saveTextMessageDraft(conversationType: ConversationType, targetId: string, draftText: string): boolean

  • 保存草稿

    description

    草稿存储在内存中，如刷新或者关闭页面会导致草稿丢失。 草稿功能并未在 v3 SDK 版本红实现，由 Bridge 模块实现

    Parameters

    Returns boolean

searchConversationByContent

  • searchConversationByContent(keyword: string, callback: ICallback<IConversation[], void>, conversationTypes?: ConversationType[], customMessageTypes?: string[]): void

  • 按内容搜索会话

    Parameters

    • keyword: string

      关键字

    • callback: ICallback<IConversation[], void>
    • Optional conversationTypes: ConversationType[]

      会话类型数组

    • Optional customMessageTypes: string[]

      自定义消息类型,若关键字属于自定义消息类型，需传入

    Returns void

searchMessageByContent

  • searchMessageByContent(conversationType: ConversationType, targetId: string, keyword: string, timestamp: number, count: number, total: number, callback: ICallback<IReceivedMessageV2[], number>): void

  • 按内容搜索会话内的消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      目标 ID

    • keyword: string

      搜索内容

    • timestamp: number

      搜索时间, 搜索该时间之前的消息

    • count: number

      获取的数量

    • total: number
    • callback: ICallback<IReceivedMessageV2[], number>

    Returns void

sendMessage

  • sendMessage(conversationType: ConversationType, targetId: string, msg: BaseMessage<any>, callback: ISendCallback<IReceivedMessageV2, void>, isMentioned?: boolean, pushContent?: string, pushData?: string, methodType?: number, options?: ISendOptionsV2): void

  • 发送消息

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      接收方 id，当会话类型为单聊时，该值为单聊对象的 userId，为群聊时，该值应为群组 groupId

    • msg: BaseMessage<any>

      消息体

    • callback: ISendCallback<IReceivedMessageV2, void>

      回调函数

    • Optional isMentioned: boolean

      是否为 @ 消息

    • Optional pushContent: string

      移动端在接收到消息推送时用于显示的推送信息

    • Optional pushData: string

      Push 通知时附加信息

    • Optional methodType: number

      该参数已废弃 1 : 多客服(客服后台使用); 2 : 消息撤回

    • Optional options: ISendOptionsV2

      其他设置项

    Returns void

sendReadReceiptMessage

  • sendReadReceiptMessage(messageUIds: string[], targetId: string, callback: ICallback<void, void>): void

  • 发送群已读回执

    Parameters

    • messageUIds: string[]
    • targetId: string
    • callback: ICallback<void, void>

    Returns void

sendRecallMessage

  • sendRecallMessage(message: IReceivedMessageV2, callback: ICallback<IReceivedMessageV2, void>, options?: ISendOptionsV2): void

  • 消息撤回

    Parameters

    • message: IReceivedMessageV2
    • callback: ICallback<IReceivedMessageV2, void>
    • Optional options: ISendOptionsV2

    Returns void

sendReceiptResponse

  • sendReceiptResponse(conversationType: ConversationType, targetId: string, callback: ICallback<null | IReceivedMessageV2, void>): void

  • 发送已读回执

    description

    Parameters

    • conversationType: ConversationType
    • targetId: string
    • callback: ICallback<null | IReceivedMessageV2, void>

    Returns void

sendTypingStatusMessage

  • sendTypingStatusMessage(conversationType: ConversationType, targetId: string, typingContentType: string, callback: ICallback<IReceivedMessageV2, void>): void

  • 发送正在输入状态消息

    description

    正在输入状态消息，不存储、不计数、不推送

    Parameters

    • conversationType: ConversationType

      会话类型

    • targetId: string

      会话 id

    • typingContentType: string

      正在输入的消息 ObjectName，如 RC:TxtMsg

    • callback: ICallback<IReceivedMessageV2, void>

    Returns void

setChatRoomEntries

  • setChatRoomEntries(chatRoomId: string, options: IChatroomEntries, callback: ICallback<void, void>): void

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

    Parameters

    • chatRoomId: string
    • options: IChatroomEntries

      ISetChatroomEntryOption数组

    • callback: ICallback<void, void>

    Returns void

setChatroomEntry

  • setChatroomEntry(chatRoomId: string, chatroomEntry: IChatroomEntry, callback: ICallback<void, void>): void

  • 在指定聊天室中设置自定义属性

    description

    仅聊天室中不存在此属性或属性设置者为己方时可设置成功

    Parameters

    • chatRoomId: string

      聊天室房间 id

    • chatroomEntry: IChatroomEntry

      属性信息

    • callback: ICallback<void, void>

    Returns void

setConversationStatus

  • setConversationStatus(conversationType: ConversationType, targetId: string, status: IConversationStatus, callback: ICallback<void, void>): void

  • 设置会话状态：是否置顶、是否免打扰

    Parameters

    • conversationType: ConversationType
    • targetId: string
    • status: IConversationStatus
    • callback: ICallback<void, void>

    Returns void

setConversationStatusInTag

  • setConversationStatusInTag(tagId: string, conversation: IConversationOption, status: { isTop: boolean }, callback: ICallback<void, void>): void

  • 设置标签中会话置顶

    Parameters

    • tagId: string

      标签id

    • conversation: IConversationOption

      会话

    • status: { isTop: boolean }

      状态

      • isTop: boolean
    • callback: ICallback<void, void>

    Returns void

setDeviceInfo

  • setDeviceInfo(option: { id: string }): void
  • deprecated

    Parameters

    • option: { id: string }
      • id: string

    Returns void

setMessageContent

  • setMessageContent(messageId: number, content: any, objectName: string): void

  • 设置消息内容

    Parameters

    • messageId: number

      本地消息 ID

    • content: any

      消息内容

    • objectName: string

      消息类型

    Returns void

setMessageReceivedStatus

  • setMessageReceivedStatus(messageId: number, receivedStatus: number, callback: ICallback<boolean, void>): void

  • 设置消息接收状态

    Parameters

    • messageId: number
    • receivedStatus: number
    • callback: ICallback<boolean, void>

    Returns void

setMessageSearchField

  • setMessageSearchField(messageId: number, content: any, searchFiles: string): void

  • 设置消息搜索字段

    Parameters

    • messageId: number

      本地消息 ID

    • content: any

      消息内容

    • searchFiles: string

      搜索字段

    Returns void

setMessageSentStatus

  • setMessageSentStatus(messageId: number, sentStatus: number, callback: ICallback<boolean, void>): void

  • 设置消息发送状态

    Parameters

    • messageId: number
    • sentStatus: number
    • callback: ICallback<boolean, void>

    Returns void

setRTCData

  • setRTCData(roomId: string, key: string, value: string, isInner: boolean, apiType: RTCApiType, callback: ICallback<boolean, void>, message?: { content: string; name: string }): void

  • Parameters

    • roomId: string
    • key: string
    • value: string
    • isInner: boolean
    • apiType: RTCApiType
    • callback: ICallback<boolean, void>
    • Optional message: { content: string; name: string }
      • content: string
      • name: string

    Returns void

setRTCOutData

  • setRTCOutData(roomId: string, data: any, type: number, callback: ICallback<boolean, void>, message?: any): void

  • Parameters

    • roomId: string
    • data: any
    • type: number
    • callback: ICallback<boolean, void>
    • Optional message: any

    Returns void

setRTCRoomData

  • setRTCRoomData(roomId: string, key: string, value: string, isInner: boolean, callback: ICallback<boolean, void>, message?: { content: string; name: string }): void

  • Parameters

    • roomId: string
    • key: string
    • value: string
    • isInner: boolean
    • callback: ICallback<boolean, void>
    • Optional message: { content: string; name: string }
      • content: string
      • name: string

    Returns void

setRTCRoomInfo

  • setRTCRoomInfo(room: RTCRoomOption, info: any, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • info: any
    • callback: ICallback<boolean, void>

    Returns void

setRTCState

  • setRTCState(room: RTCRoomOption, content: { report: string }, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • content: { report: string }
      • report: string
    • callback: ICallback<boolean, void>

    Returns void

setRTCUserData

  • setRTCUserData(roomId: string, key: string, value: string, isInner: boolean, callback: ICallback<boolean, void>, message?: { content: string; name: string }): void

  • Parameters

    • roomId: string
    • key: string
    • value: string
    • isInner: boolean
    • callback: ICallback<boolean, void>
    • Optional message: { content: string; name: string }
      • content: string
      • name: string

    Returns void

setRTCUserInfo

  • setRTCUserInfo(room: RTCRoomOption, info: { key: string; value: string }, callback: ICallback<boolean, void>): void

  • Parameters

    • room: RTCRoomOption
    • info: { key: string; value: string }
      • key: string
      • value: string
    • callback: ICallback<boolean, void>

    Returns void

setRTCUserTotalRes

  • setRTCUserTotalRes(roomId: string, message: { content: string; name: string }, valueInfo: string, objectName: string, callback: ICallback<boolean, void>): void

  • Parameters

    • roomId: string
    • message: { content: string; name: string }
      • content: string
      • name: string
    • valueInfo: string
    • objectName: string
    • callback: ICallback<boolean, void>

    Returns void

setUserStatus

  • setUserStatus(status: number, callback: ICallback<Boolean, void>): void

  • 设置用户在线状态

    Parameters

    • status: number

      在线 10、离开 11、忙碌 12

    • callback: ICallback<Boolean, void>

    Returns void

setUserStatusListener

  • setUserStatusListener(config: { userIds: string[] }, listener: Function): void

  • 设置用户在线状态监听器

    Parameters

    • config: { userIds: string[] }
      • userIds: string[]
    • listener: Function

    Returns void

updateMessageExpansion

  • updateMessageExpansion(expansionDic: {}, message: IReceivedMessageV2, callback: ICallback<void, void>): void

  • 更新消息扩展

    Parameters

    • expansionDic: {}

      要更新的消息扩展信息键值对

      • [key: string]: string
    • message: IReceivedMessageV2

      要更新的原始消息体

    • callback: ICallback<void, void>

    Returns void

updateTag

  • updateTag(tag: ITagParam, callback: ICallback<void, void>): void

  • 编辑标签

    Parameters

    • tag: ITagParam

      标签信息

    • callback: ICallback<void, void>

    Returns void

Generated using TypeDoc