Contact | Easemob SDK API Reference

Contact contains the APIs for contact-related operations.

Functions

acceptContactInvite

acceptContactInvite(this: any, to: string): void

接受好友申请。
```
connection.acceptContactInvite('user1')
```
Parameters
- this: any
- to: string
Returns void

addContact

addContact(this: any, to: string, message?: string): void

添加好友。
```
connection.addContact('user1', 'I am Bob')
```
Parameters
- this: any
- to: string
- Optional message: string
Returns void

addReaction

addReaction(this: any, params: { messageId: string; reaction: string }): Promise<void>

添加消息 Reaction。
```
connection.addReaction({messageId: 'messageId', reaction: 'reaction'})
```
Parameters
- this: any
- params: { messageId: string; reaction: string }
  - messageId: string
    
    消息 ID。
  - reaction: string
    
    在消息上添加的 Reaction，最大长度为 128 字符。
Returns Promise<void>

addUsersToBlocklist

addUsersToBlocklist(this: any, options: { name: string | string[] }): void

添加联系人至黑名单。
```
connection.addUsersToBlocklist({name: 'user1'})
```
Parameters
- this: any
- options: { name: string | string[] }
  - name: string | string[]
    
    用户 ID。可设置特定用户 ID 添加单个用户，也可输入用户 ID 数组批量添加用户，如 ["user1","user2"]。
Returns void

declineContactInvite

declineContactInvite(this: any, to: string): void

拒绝好友申请。
```
connection.declineContactInvite('user1')
```
Parameters
- this: any
- to: string
Returns void

deleteContact

deleteContact(this: any, to: string): void

删除指定好友。
```
connection.deleteContact('user1')
```
Parameters
- this: any
- to: string
Returns void

deleteConversation

deleteConversation(this: any, params: { channel: string; chatType: "singleChat" | "groupChat"; deleteRoam: boolean; error?: any; success?: any }): Promise<AsyncResult<DeleteSessionResult>>

删除会话。
```
connection.deleteConversation({
 channel: 'targetId',
 chatType: 'singleChat',
 deleteRoam: true
})
```
Parameters
- this: any
- params: { channel: string; chatType: "singleChat" | "groupChat"; deleteRoam: boolean; error?: any; success?: any }
  - channel: string
    
    会话 ID：对方的用户 ID 或群组 ID。
  - chatType: "singleChat" | "groupChat"
    会话类型：
    
    singleChat：单聊；
    
    groupChat：群聊。
  - deleteRoam: boolean
    删除会话时是否同时删除服务端漫游消息。
    
    true：是；
    
    false：否。
  - error?:function
    - error(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: AsyncResult<DeleteSessionResult>): void
    - Parameters
      - res: AsyncResult<DeleteSessionResult>
      Returns void
Returns Promise<AsyncResult<DeleteSessionResult>>

deleteReaction

deleteReaction(this: any, params: { messageId: string; reaction: string }): Promise<void>

删除消息的 Reaction。
```
connection.deleteReaction({messageId: 'messageId', reaction: 'reaction'})
```
Parameters
- this: any
- params: { messageId: string; reaction: string }
  - messageId: string
    
    消息 ID。
  - reaction: string
    
    要删除的 Reaction。
Returns Promise<void>

fetchUserInfoById

fetchUserInfoById(this: any, userId: string | string[], properties?: ConfigurableKey | ConfigurableKey[]): Promise<AsyncResult<UpdateOwnUserInfoParams>>

查询用户属性。
```
connection.fetchUserInfoById('user1') | fetchUserInfoById(['user1', 'user2'])
```
Parameters
- this: any
- userId: string | string[]
- Optional properties: ConfigurableKey | ConfigurableKey[]
Returns Promise<AsyncResult<UpdateOwnUserInfoParams>>

getBlocklist

getBlocklist(this: any, params?: { error?: any; success?: any }): Promise<AsyncResult<UserId[]>>

获取黑名单列表。
```
connection.getBlocklist()
```
Parameters
- this: any
- Optional params: { error?: any; success?: any }
  - error?:function
    - error(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: AsyncResult<string[]>): void
    - Parameters
      - res: AsyncResult<string[]>
      Returns void
Returns Promise<AsyncResult<UserId[]>>

getChatToken

getChatToken(this: any, agoraToken: string): Promise<any>

Parameters
- this: any
- agoraToken: string
Returns Promise<any>

getContacts

getContacts(this: any, params?: { error?: any; success?: any }): Promise<AsyncResult<UserId[]>>

获取联系人列表。
```
connection.getContacts()
```
Parameters
- this: any
- Optional params: { error?: any; success?: any }
  - error?:function
    - error(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: RosterData[]): void
    - Parameters
      - res: RosterData[]
      Returns void
Returns Promise<AsyncResult<UserId[]>>

getConversationlist

getConversationlist(this: any, params?: { error?: any; success?: any }): Promise<AsyncResult<conversationList[]>>

获取会话列表以及会话下的最新一条消息。
```
connection.getConversationlist()
```
Parameters
- this: any
- Optional params: { error?: any; success?: any }
  - error?:function
    - error(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: AsyncResult<conversationList[]>): void
    - Parameters
      - res: AsyncResult<conversationList[]>
      Returns void
Returns Promise<AsyncResult<conversationList[]>>

getHistoryMessages

getHistoryMessages(this: any, options: { chatType?: "singleChat" | "groupChat" | "chatRoom"; cursor?: null | string | number; pageSize?: number; searchDirection?: string; targetId: string; fail?: any; success?: any }): Promise<HistoryMessages>

获取对话历史消息。
```
connection.getHistoryMessages({targetId:'user1',chatType:'groupChat', pageSize: 20})
```
Parameters
- this: any
- options: { chatType?: "singleChat" | "groupChat" | "chatRoom"; cursor?: null | string | number; pageSize?: number; searchDirection?: string; targetId: string; fail?: any; success?: any }
  - Optional chatType?: "singleChat" | "groupChat" | "chatRoom"
    会话类型：
    
    singleChat：单聊；
    
    groupChat：群组聊天；
    
    chatRoom：聊天室聊天。
    
    （默认）单聊。
  - Optional cursor?: null | string | number
    
    起始消息 ID，默认值为 -1，即从最新消息开始。
  - Optional pageSize?: number
    
    每次获取的消息条数。默认值为 20，最大值是50。
  - Optional searchDirection?: string
    是否选择正向拉取历史消息（从最老向最新拉取）。
    
    up：向上搜索；
    
    down：向下搜索；
    
    （默认）up。
  - targetId: string
    
    对方的用户 ID 或者群组 ID。
  - fail?:function
    - fail(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: MessagesType[]): void
    - Parameters
      - res: MessagesType[]
      Returns void
Returns Promise<HistoryMessages>

getReactionDetail

getReactionDetail(this: any, params: { cursor?: string; messageId: string; pageSize?: number; reaction: string }): Promise<AsyncResult<GetReactionDetailResult>>

获取 Reaction 详情。
```
getReactionDetail({messageId: 'messageId', reaction: 'reaction', cursor: '', pageSize: 20})
```
Parameters
- this: any
- params: { cursor?: string; messageId: string; pageSize?: number; reaction: string }
  - Optional cursor?: string
    
    游标。如果数据还有下一页，该方法的返回值会包含此字段，传递此字段可获取下一页的数据，为 null 时获取第一页数据。
  - messageId: string
    
    消息 ID。
  - Optional pageSize?: number
    
    每页返回的数量。默认为 20，最大为 100。
  - reaction: string
    
    要获取的 Reaction。
Returns Promise<AsyncResult<GetReactionDetailResult>>

getReactionlist

getReactionlist(this: any, params: { chatType: "singleChat" | "groupChat"; groupId?: string; messageId: string | string[] }): Promise<AsyncResult<GetReactionListResult[]>>

获取消息的 Reaction 列表。
```
connection.getReactionlist({chatType: 'chatType', messageId: 'messageId'})
```
Parameters
- this: any
- params: { chatType: "singleChat" | "groupChat"; groupId?: string; messageId: string | string[] }
  - chatType: "singleChat" | "groupChat"
    会话类型：
    
    singleChat：单聊；
    
    groupChat：群组聊天；
  - Optional groupId?: string
    
    群组 ID。
  - messageId: string | string[]
    
    消息 ID。
Returns Promise<AsyncResult<GetReactionListResult[]>>

recallMessage

recallMessage(this: any, option: { chatType?: "singleChat" | "groupChat" | "chatRoom"; isChatThread?: boolean; mid: string; to: string; type?: "chat" | "groupchat" | "chatroom"; fail?: any; success?: any }): Promise<ContactType.SendMsgResult>

撤回消息。
```
connection.recallMessage({mid: 'messageId', to: 'user1', type: 'singleChat'})
```
Parameters
- this: any
- option: { chatType?: "singleChat" | "groupChat" | "chatRoom"; isChatThread?: boolean; mid: string; to: string; type?: "chat" | "groupchat" | "chatroom"; fail?: any; success?: any }
  - Optional chatType?: "singleChat" | "groupChat" | "chatRoom"
    会话类型：
    
    singleChat：单聊；
    
    groupChat：群组聊天；
    
    chatRoom：聊天室聊天。
  - Optional isChatThread?: boolean
    
    是否是子区内的消息。
  - mid: string
    
    需要撤回的消息 ID。
  - to: string
    
    消息的接收方。
  - Optional type?: "chat" | "groupchat" | "chatroom"
    会话类型（SDK deprecated）:
    
    chat：单聊；
    
    groupchat：群组聊天；
    
    chatroom：聊天室聊天。
  - fail?:function
    - fail(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: ContactType.SendMsgResult): void
    - Parameters
      - res: ContactType.SendMsgResult
      Returns void
Returns Promise<ContactType.SendMsgResult>

removeHistoryMessages

removeHistoryMessages(this: any, options: { beforeTimeStamp?: number; chatType: "singleChat" | "groupChat"; messageIds?: string[]; targetId: string }): Promise<void>

单向删除漫游消息。
```
connection.removeHistoryMessages({targetId: 'userId', chatType: 'singleChat', beforeTimeStamp: Date.now()})

connection.removeHistoryMessages({targetId: 'userId', chatType: 'singleChat', messageIds: ['messageId']})
```
Parameters
- this: any
- options: { beforeTimeStamp?: number; chatType: "singleChat" | "groupChat"; messageIds?: string[]; targetId: string }
  - Optional beforeTimeStamp?: number
    
    要删除的起始时间戳。该时间戳之前的消息会被删除
  - chatType: "singleChat" | "groupChat"
    会话类型：
    
    singleChat：单聊；
    
    groupChat：群聊。
  - Optional messageIds?: string[]
    
    删除的消息 ID 列表，不能超过 20 个 ID。
  - targetId: string
    
    对方的用户 ID 或群组 ID。
Returns Promise<void>

removeUserFromBlocklist

removeUserFromBlocklist(this: any, options: { name: string | string[] }): void

将联系人从黑名单中移除。
```
connection.removeUserFromBlocklist({name: 'user1'})
```
Parameters
- this: any
- options: { name: string | string[] }
  - name: string | string[]
    
    用户 ID。可设置特定用户 ID 移除单个用户，也可输入用户 ID 数组批量移除用户，如 ["user1","user2"]。
Returns void

reportMessage

reportMessage(this: any, params: { messageId: string; reportReason: string; reportType: string }): Promise<void>

举报消息。
```
reportMessage()
```
Parameters
- this: any
- params: { messageId: string; reportReason: string; reportType: string }
  - messageId: string
    
    要举报消息的 ID。
  - reportReason: string
    
    举报原因。
  - reportType: string
    
    举报类型。
Returns Promise<void>

updateCurrentUserNick

updateCurrentUserNick(this: any, nick: string): Promise<AsyncResult<BaseUserInfo[]>>

修改收到推送消息时显示的昵称。该昵称在用户注册时设置。不属于用户属性。
```
connection.updateCurrentUserNick('Tom')
```
Parameters
- this: any
- nick: string
Returns Promise<AsyncResult<BaseUserInfo[]>>

updateUserInfo

updateUserInfo(this: any, params: UpdateOwnUserInfoParams | ConfigurableKey, value?: any): Promise<AsyncResult<UpdateOwnUserInfoParams>>

修改用户属性。

```typescript connection.updateUserInfo({nickname: 'Tom', avatarurl: 'avatarurl', mail: 'abc@gmail,com', ext: JSON.stringify({hobby: 'football'})})
connection.updateUserInfo('nickname', 'Tom')
Parameters
- this: any
- params: UpdateOwnUserInfoParams | ConfigurableKey
- Optional value: any
Returns Promise<AsyncResult<UpdateOwnUserInfoParams>>

uploadPushToken

uploadPushToken(this: any, params: { deviceId: string; deviceToken: string; notifierName: string; error?: any; success?: any }): Promise<AsyncResult<UploadTokenResult>>

将 token 上传到服务器。该方法的使用场景是 SDK 用在原生客户端且准备在客户端集成第三方推送功能。
```
connection.uploadPushToken({deviceId: 'deviceId', deviceToken: 'deviceToken', notifierName: 'notifierName'})
```
Parameters
- this: any
- params: { deviceId: string; deviceToken: string; notifierName: string; error?: any; success?: any }
  - deviceId: string
    
    设备 ID，用于标识设备。用户可自定义设备 ID。
  - deviceToken: string
    
    推送 token，用于标识相同的设备。用户可自定义该推送 token。
  - notifierName: string
    
    推送服务的 App ID，对于 Firebase Cloud Messaging (FCM) 是 senderId, 对于 VIVO 推送服务是 “appId+#+AppKey”。
  - error?:function
    - error(error: Common.ErrorEvent): void
    - Parameters
      - error: Common.ErrorEvent
      Returns void
  - success?:function
    - success(res: AsyncResult<UploadTokenResult>): void
    - Parameters
      - res: AsyncResult<UploadTokenResult>
      Returns void
Returns Promise<AsyncResult<UploadTokenResult>>

Index

Functions

Functions

acceptContactInvite

Parameters

this: any

to: string

Returns void

addContact

Parameters

this: any

to: string

Optional message: string

Returns void

addReaction

Parameters

this: any

params: { messageId: string; reaction: string }

messageId: string

reaction: string

Returns Promise<void>

addUsersToBlocklist

Parameters

this: any

options: { name: string | string[] }

name: string | string[]

Returns void

declineContactInvite

Parameters

this: any

to: string

Returns void

deleteContact

Parameters

this: any

to: string

Returns void

deleteConversation

Parameters

this: any

params: { channel: string; chatType: "singleChat" | "groupChat"; deleteRoam: boolean; error?: any; success?: any }

channel: string

chatType: "singleChat" | "groupChat"

deleteRoam: boolean

error?:function

Parameters

error: Common.ErrorEvent

Returns void

success?:function

Parameters

res: AsyncResult<DeleteSessionResult>

Returns void

Returns Promise<AsyncResult<DeleteSessionResult>>

deleteReaction

Parameters

this: any

params: { messageId: string; reaction: string }

messageId: string

reaction: string

Returns Promise<void>

fetchUserInfoById

Parameters

this: any

userId: string | string[]

Optional properties: ConfigurableKey | ConfigurableKey[]

Returns Promise<AsyncResult<UpdateOwnUserInfoParams>>

getBlocklist

Parameters

this: any

Optional params: { error?: any; success?: any }

error?:function

Parameters

error: Common.ErrorEvent

Returns void

success?:function

Parameters

res: AsyncResult<string[]>

Returns void

Returns Promise<AsyncResult<UserId[]>>

getChatToken