Class ChatClient

Static ReadonlyVERSION

addConnectionListener

• addConnectionListener(listener): void

• 设置连接状态监听器。 该监听器用于监听 Chat app 与 Chat 服务器之间的连接。

  Parameters

  • listener: ConnectionListener

    要添加的连接状态监听器。

  Returns void

addLogListener

• addLogListener(listener): void

• 添加 SDK 日志监听器。

  同一个监听器对象重复添加时只保留一份。

  Parameters

  • listener: ChatLogListener

    要添加的日志监听器。

  Returns void

addMultiDevicesListener

• addMultiDevicesListener(listener): void

• 添加多设备监听器。

  Parameters

  • listener: MultiDevicesListener

    要添加的多设备监听器。

  Returns void

changeAppId

• changeAppId(appId): ChatError

• 更新 AppId。

  • AppId 用于控制对你的 app 的 Chat 服务的访问，只有在未登录状态才能修改 AppId。
  • 修改 AppId 是为了方便你切换到其他 AppId。
  • 你可以在 Console 上获取 AppId。
  • 也通过 ChatOptions#setAppId 设置 AppId，同样只有在未登录状态才能修改。

  Parameters

  • appId: string

    修改后的 AppId，应用的标识符，不可为空。

  Returns ChatError

  • 返回更新后的 AppId 结果。

changeAppkey

• changeAppkey(appKey): ChatError

• 更新 App Key。

  • App Key 用于控制对你的 app 的 Chat 服务的访问，只有在未登录状态才能修改 App Key。
  • 修改 App Key 是为了方便你切换到其他 App Key。
  • 你可以在 Console 上获取 App Key。
  • 也通过 ChatOptions#setAppKey 设置 App Key，同样只有在未登录状态才能修改。

  Parameters

  • appKey: string

    修改后的 App Key，应用的标识符，不可为空。

  Returns ChatError

  • 返回更新后的 App Key 结果。

chatManager

• chatManager(): ChatManager

• 获取聊天管理类。

  该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns ChatManager

  • 返回聊天管理类。

chatroomManager

• chatroomManager(): ChatroomManager

• 获取聊天室管理类。 该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns ChatroomManager

  • 返回聊天室管理类。

compressLogs

• compressLogs(): Promise<string>

• 压缩 SDK 日志。

  Returns Promise<string>

  • 返回日志压缩文件的本地路径。

contactManager

• contactManager(): ContactManager

• 获取联系人管理类。 * 该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns ContactManager

  • 返回联系人管理类。

getAccessToken

• getAccessToken(): string

• 从内存中获取身份认证 token。

  Returns string

  • 返回用户身份认证 token。

getContext

• getContext(): any

• 获取 Context。

  Returns any

getCurrentUser

• getCurrentUser(): string

• 获取当前登录用户的用户 ID。

  Returns string

  • 返回当前登录用户 ID 。

getOptions

• getOptions(): ChatOptions

• 获取 SDK 的配置选项。 return undefined - 返回 SDK 的配置项对象。

  Returns ChatOptions

groupManager

• groupManager(): GroupManager

• 获取群组管理类。 该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns GroupManager

  • 返回群组管理类。

init

• init(context, chatOptions): void

• 初始化 SDK。

  Parameters

  • context: Context

    上下文。
  • chatOptions: ChatOptions | ChatOptionsParam

    配置项，必填。详见 ChatOptions。

  Returns void

isConnected

• isConnected(): boolean

• 检查 SDK 是否连接到 Chat 服务器。

  Returns boolean

  • 返回是否连接到 Chat 服务器的结果。
  • true 表示已经连接到 Chat 服务器。
  • false 表示没有连接到 Chat 服务器。

isDatabaseOpened

• isDatabaseOpened(): boolean

• 检查当前是否已有可用的本地数据库上下文。

  该状态只表示本地数据库已成功打开，本地数据库相关接口可以使用；不表示已在线登录， 也不能代替 isLoggedIn 或连接状态回调。

  Returns boolean

  • 本地数据库是否已打开。

isLoggedIn

• isLoggedIn(): boolean

• 检查用户是否登录 Chat 服务。

  Returns boolean

  • 返回用户是否登录 Chat 服务。
  • true：是；
  • false：否。

isSdkInited

• isSdkInited(): boolean

• 检查 SDK 是否已初始化完毕。

  Returns boolean

  • 返回 SDK 初始化状态。
  • true：是；
  • false：否。

loginWithToken

• loginWithToken(userId, token): Promise<void>

• 通过 token 登录服务器。

  Parameters

  • userId: string

    用户 ID，必填。
  • token: string

    验证 token，必填。

  Returns Promise<void>

  • 登录返回的 Promise 结果。

logout

• logout(unbindToken?): Promise<void>

• 登出聊天服务器。

  Parameters

  • unbindToken: boolean = true

    登出时是否解绑 token。

    • （默认）true：是；
    • false：否

  Returns Promise<void>

  • 返回退出登录的 promise 结果。

notifySDKNetworkChanged

• notifySDKNetworkChanged(): void

• 通知 SDK 网络发生变化。

  Returns void

presenceManager

• presenceManager(): PresenceManager

• 获取用户在线状态管理类。

  该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns PresenceManager

  • 返回用户在线状态管理类。

pushManager

• pushManager(): PushManager

• 获取推送管理类。 该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns PushManager

  • 返回推送管理类。

removeConnectionListener

• removeConnectionListener(listener): void

• 移除 Chat 服务器连接监听。

  Parameters

  • listener: ConnectionListener

    要移除的 Chat 服务器连接监听。

  Returns void

removeLogListener

• removeLogListener(listener): void

• 移除 SDK 日志监听器。

  Parameters

  • listener: ChatLogListener

    要移除的日志监听器。

  Returns void

removeMultiDevicesListener

• removeMultiDevicesListener(listener): void

• 移除多设备监听器。

  Parameters

  • listener: MultiDevicesListener

    要移除的多设备监听器。

  Returns void

renewToken

• renewToken(newToken): Promise<void>

• 更新 token。

  当用户利用 token 登录的情况下在 ConnectionListener 类中收到 token 即将过期事件的回调通知时，可调用该方法更新 token，避免因 token 失效产生的未知问题。

  Parameters

  • newToken: string

    新 token。

  Returns Promise<void>

  • 返回更新 token 的 promise 结果。

uploadLog

• uploadLog(): Promise<void>

• 上传本地日志。

  Returns Promise<void>

  • 返回上传日志的 Promise 结果。

userInfoManager

• userInfoManager(): UserInfoManager

• 获取用户信息管理类。

  该方法需要在 ChatClient 初始化完成后调用，详见 init。

  Returns UserInfoManager

  • 返回用户信息管理类。

StaticgetInstance

• getInstance(): ChatClient

• Returns ChatClient