添加收藏
collectionType 与 collectionData 由业务自定义(云信只做存储):例如用 1 表示「消息」,
collectionData 传序列化后的消息内容。
收藏内容
收藏项
清理本地消息
注意:该接口按时间清理全部会话的本地消息(不影响服务端漫游消息),请谨慎调用。
可选data: ClearLocalMessagesData清理参数
无返回值
查询会话列表(分页)
需要会话列表使用本地会话(initSdk 的 localConversation 默认即为 true)。
可选data: GetConversationListData分页参数
会话列表
查询用户资料
默认读本地缓存(快),需要最新资料时传 fromCloud: true。
查询参数
用户资料列表
批量导入本地消息(只在本地展示,不发送到服务端)
目标会话与消息列表
导入结果
初始化
重复调用会复用已创建的实例;调用前需已确认隐私政策,否则返回 PRIVACY_NOT_AGREED。
初始化参数
初始化结果(含 App Key 与内置 SDK 版本号)
插入本地消息(扩展版:可指定发送者/时间、是否更新会话最后一条)
消息参数
插入结果
登录
登录成功后即可打开消息页与聊天页,登录态、连接状态、新消息等变化通过事件回传。 Token 由业务服务端签发,过期或被踢下线后需要重新登录。
登录参数
无返回值
移除监听器
云端消息搜索(按时间、会话、发送者、消息类型过滤)
与 searchMessages 的区别:本接口直接查服务端漫游消息,参数更丰富;searchMessages 优先查本地。
搜索参数
命中的消息
搜索消息(关键字匹配文本消息)
默认在本地会话数据中搜索;本地搜索不可用时回退到云端搜索。
搜索参数
命中的消息
打开联系人选择页,返回用户选中的联系人
用户在页面上直接返回(未选中)时返回错误码 USER_CANCELED。
可选data: SelectContactsData选择联系人参数
选中的联系人列表
打开会话选择页,返回用户选中的会话
用户在页面上直接返回(未选中)时返回错误码 USER_CANCELED。
可选data: SelectConversationsData选择会话参数
选中的会话列表
打开群成员选择页,返回选中的账号 ID
用户在页面上直接返回(未选中)时返回错误码 USER_CANCELED。
选择参数
选中的账号 ID
发送音频消息
filePath 支持 fs://、file:// 开头的本地音频或应用内的绝对路径;url 仅支持 http(s)://,发送后删除临时文件。
消息参数
发送结果
发送自定义消息(附件内容由业务自定义,一般传 JSON 字符串)
消息参数
发送结果
发送文件消息
filePath 支持 fs://、file:// 开头的本地文件或应用内的绝对路径(文件不存在时返回错误);
url 仅支持 http://、https:// 开头的网络文件,插件会先下载,发送完成后删除临时文件。
消息参数
发送结果
发送图片消息
filePath 支持 fs://、file:// 开头的本地图片或应用内的绝对路径(文件不存在时返回错误);
url 仅支持 http://、https:// 开头的网络图片,插件会先下载,发送完成后删除临时文件。
消息参数
发送结果
发送文本消息
会话由 conversationId、单聊 accountId 或群 teamId 指定(三选一,conversationId 优先)。
消息参数
发送结果
在话题中发送文本消息(不传 topicId 时由 SDK 创建或复用话题)
消息参数
发送结果
设置监听器,接收 eventName 事件名称,data 事件数据
注意: 此接口为覆盖操作,仅保留最后一个监听器,最后的 listener 才能收到事件通知。
设置会话列表页的标题名称与 logo(不设置时不显示 logo,标题默认「会话」)
可选data: NavigationInfoData标题配置
生效后的配置
订阅指定用户的在线状态(订阅后会收到 userStatus 事件)
订阅参数
订阅失败的账号
网易云信 IM
接入云信官方 IM 界面套件,提供会话列表、通讯录、单聊、群聊、会话设置等完整界面, 以及登录态、新消息、未读数、好友申请、入群申请等事件与厂商离线推送配置。
事件通过
setListener接收,eventName 固定为event,data 为{ action, data }:loginStatus登录状态变更,data 为{ status },status 取值 logout、logining、logined、waitingconnectStatus连接状态变更,data 为{ status },status 取值 disconnected、connecting、connected、waitingloginFailed登录鉴权失败,data 为{ code, message }kickedOffline被踢下线,data 为{ reason, description },reason 取值 clientExclusive、server、client、clientQuietlymessageReceived收到新消息,data 为{ messages },messages 为PushMessage数组unreadCount会话未读数变更,data 为{ messages }friendApplication收到好友申请,data 为{ accountId, postscript, time }teamInvitation收到入群申请,data 为{ teamId, operatorAccountId, postscript, time }示例