概述(Android)

最近更新时间:2019-01-23 10:04:18

查看pdf

ImSDK 基本概念

会话:ImSDK 中会话(Conversation)分为两种,一种是 C2C 会话,表示单聊情况自己与对方建立的对话,读取消息和发送消息都是通过会话完成;另一种是群会话,表示群聊情况下,群内成员组成的会话,群会话内发送消息群成员都可接收到。如下图所示,一个会话表示与一个好友的对话。

消息:ImSDK 中消息(Message)表示要发送给对方的内容,消息包括若干属性,如是否自己已读,是否已经发送成功,发送人帐号,消息产生时间等;一条消息由若干 Elem 组合而成,每种 Elem 可以是文本、图片、表情等等,消息支持多种 Elem 组合发送。

群组 ID:群组 ID 唯一标识一个群,由后台生成,创建群组时返回。

ImSDK 对象简介

ImSDK 对象主要分为通讯管理器,会话、消息,群管理,具体的含义参见下表:

对象 介绍 功能
TIMManager 管理器类,负责 SDK 基本操作 初始化、登录、注销、创建会话等,可以通过扩展类 TIMManagerExt 使用更多管理器相关高级功能
TIMConversation 会话,负责会话相关操作 如发送消息,获取会话消息缓存,获取未读计数等,可以通过扩展类 TIMConversationExt 使用更多会话相关高级功能
TIMMessage 消息 包括文本、图片等不同类型消息。可以通过扩展类 TIMMessageExt 使用更多消息相关高级功能
TIMGroupManager 群组管理器 负责创建群组、加群、退群等,可以通过扩展类 TIMGroupManagerExt 使用更多群组相关高级功能

调用顺序介绍

ImSDK 调用 API 需要遵循以下顺序,其余辅助方法需要在登录成功后调用。

步骤
对应函数
说明
初始化
TIMSdkConfig
设置 SDK 基本配置,比如 sdkappid、日志等级等
TIMManager : init
初始化 SDK
TIMManager : setUserConfig
设置用户基本配置
TIMManager : addMessageListener
设置消息监听
登录
TIMManager : login
登录
消息收发
TIMManager : getConversation
获取会话
TIMConversation : sendMessage
发送消息
群组管理
TIMGroupManager
群组管理
注销
TIMManager : logout
注销