环信即时通讯 IM Android Demo
大约 5 分钟
Andorid 集成文档
环信即时通讯 IM Android Demo
环信即时通讯 IM Android Demo 提供用户登录、单聊、群组、子区、消息(文字、表情、语音、视频、图片、文件等)发送及管理、会话管理、好友管理、用户属性、用户在线状态(Presence)以及实时音视频通话等功能。
体验 Demo
- 下载 Demo。
- 输入你的手机号,获取验证码,然后输入。
- 选择同意《环信服务条款》与《环信隐私协议》,然后点击 登录 登录 Demo。
下面为部分 UI 界面的展示:
单聊页面

群聊页面

会话列表

通讯录

快速跑通 Demo
开发环境要求
- Android Studio Flamingo | 2022.2.1 及以上
- Gradle 8.0 及以上
- targetVersion 26 及以上
- Android SDK API 21 及以上
- JDK 17 及以上
跑通步骤
- 创建应用。
- 获取应用的 App Key。
- 创建用户。
- 下载即时通讯 IM Demo 项目源码。
- 下载完毕,打开 Android Studio,点击 File > Open,打开已下载到本地的 Demo (
easemob-demo-android
) 工程根目录即可。 - 将你的应用的 App Key 填入 Demo 工程根目录下的
local.properties
文件,格式为APPKEY = 你申请的appkey
。 - 编译运行项目。
- 使用注册的用户 ID 和密码登录。
App Server
为方便开发者快速体验即时通讯 IM 功能,跑通本工程 Demo 源码默认使用开发者注册的用户 ID 和密码直接登录,不需要依赖部署服务端 App Server。但是在此模式下,手机验证码、用户头像和 EaseCallKit 实时音视频等相关功能不可用,你可以通过部署 App Server 完整体验这些功能。
App Server 为 Demo 提供以下功能:
- 通过手机号获取验证码。
- 通过手机号和验证码返回环信用户 ID 和环信用户 Token。
- 上传头像并返回地址。
- 根据用户的信息生成 EaseCallKit 登录所需的 Token。
- 获取音视频通话时环信用户 ID 和 Agora UID 的映射关系。
你通过以下步骤部署 App Server:
- 部署 App Server。详见 服务端源码。
- 在 Demo 工程根目录下
local.properties
文件中,填写 App Server 的域名或 IP 地址,格式为APP_SERVER_DOMAIN = 服务器域名或ip地址
。 - 在 Demo 工程根目录下
local.properties
文件中,填入LOGIN_WITH_APPSERVER = true
,即通知 Demo 工程需要启用 App Server,体验完整功能。
服务端中的 App Key 要跟客户端的 App Key 保持一致。
Demo 项目结构
Demo 架构
└── com
└── hyphenate
└── chatdemo
├── DemoApplication.kt //程序入口
├── DemoHelper.kt //app 帮助类
├── MainActivity.kt //主页面
├── base //包含一些基类
│ ├── ActivityState.kt
│ ├── BaseDialogFragment.kt //一些弹窗基类
│ ├── BaseInitActivity.kt //activity 基类
│ ├── ErrorCode.kt //一些常用的错误码
│ └── UserActivityLifecycleCallbacks.kt
├── bean //一些序列化 bean 类
├── callkit
│ ├── CallKitActivityLifecycleCallback.kt //callkit 中 activity 的生命周期监听回调类
│ ├── CallKitManager.kt //callkit 管理类
│ ├── CallUserInfo.kt
│ ├── ConferenceInviteActivity.kt
│ ├── ConferenceInviteAdapter.kt
│ ├── ConferenceInviteFragment.kt
│ ├── ConferenceMemberSelectViewHolder.kt
│ ├── MultipleVideoActivity.kt //多人音视频页面
│ ├── VideoCallActivity.kt //单人音视频页面
│ ├── extensions //callkit 一些扩展函数类
│ ├── viewholder //单聊、群聊 call 消息提醒类型适配器,包含一些事件处理
│ └── views //单聊、群聊 call 消息提醒类型布局
├── common //app 的一些的公共类
│
├── controller
│ └── PresenceController.kt //presence 相关的管理类
├── interfaces //包含一些接口标准类
├── repository // app 的数据仓库
├── ui
│ ├── chat
│ │ ├── ChatActivity.kt //单群聊聊天页面 activity
│ │ ├── ChatFragment.kt //单群聊聊天页面 fragment
│ │ └── CustomMessagesAdapter.kt //自定义消息适配器
│ ├── contact
│ │ ├── ChatContactCheckActivity.kt //检查是否是联系人页面
│ │ ├── ChatContactDetailActivity.kt //联系人详情页面
│ │ ├── ChatContactListFragment.kt //联系人列表页面
│ │ ├── ChatContactRemarkActivity.kt //联系人(好友)备注页面
│ │ └── ChatNewRequestActivity.kt //联系人页面新请求 item
│ ├── conversation
│ │ └── ConversationListFragment.kt //会话列表页面
│ ├── group
│ │ ├── ChatCreateGroupActivity.kt //创建群组页面
│ │ └── ChatGroupDetailActivity.kt //群组详情页面
│ ├── login
│ │ ├── LoginActivity.kt //登录页面 activity
│ │ ├── LoginFragment.kt //登录页面 fragment
│ │ ├── ServerSetFragment.kt
│ │ └── SplashActivity.kt //启动页
│ └── me //我的界面里相关按钮对应的页面
│ ├── AboutActivity.kt
│ ├── AboutMeFragment.kt //关于我页面
│ ├── CurrencyActivity.kt //通用设置页面,设置暗黑模式、语言、样式等
│ ├── EditUserNicknameActivity.kt // 修改用户昵称页面
│ ├── FeaturesActivity.kt
│ ├── LanguageSettingActivity.kt
│ ├── NotifyActivity.kt
│ ├── StyleSettingActivity.kt
│ ├── UserInformationActivity.kt
│ ├── WebViewActivity.kt
│ └── controller
├── uikit
│ └── UIKitManager.kt //UIKit 管理类
├── utils //工具类
└── viewmodel //包含一些 ViewModel 类
主要模块介绍
模块 | 描述 |
---|---|
聊天模块 | 展示如何依赖 EaseIMKit 实现聊天列表,如何扩展消息类型及如何增加扩展菜单等的逻辑。 |
会话列表模块 | 展示如何依赖 EaseIMKit 实现会话列表的逻辑及实现系统消息的具体逻辑。 |
联系人模块 | 展示如何依赖 EaseIMKit 实现联系人列表的逻辑。 |
聊天设置模块 | 展示 IM SDK 提供的对于群聊成员及群组属性的操作。 |
设置模块 | 展示 IM SDK 对于新消息的设置及消息免打扰,群组等通用设置。 |
开发者模块 | 展示 IM SDK 提供的一些常规的开发者可以设置的功能。 |
主要类介绍
模块 | 描述 |
---|---|
DemoHelper | 环信(EaseIM)全局帮助类,主要功能为初始化 IM SDK,初始化 EaseIMKit 相关及注册对话类型等。 |
ConversationListFragment | 继承自 EaseIMKit 中的 ChatUIKitConversationListFragment ,展示扩展条目长按事件,在列表前端添加布局及条目点击事件实现等 |
ChatActivity及ChatFragment | ChatFragment 继承自 EaseIMKit 中的 UIKitChatFragment ,展示了扩展条目长按事件,预置条目长按菜单及对重写部分长按事件功能,展示了如何重置及添加更多扩展功能,并展示了实现了头像点击事件及正在输入等事件的相应。 |
ChatContactListFragment | 继承自 EaseIMKit 中的 ChatUIKitContactsListFragment ,展示了添加头布局,添加条目长按功能及实现条目点击事件等 |
ChatGroupDetailActivity | 实现了如下功能:添加群成员,修改群公告及群介绍,上传共享文件,进行群组管理,设置消息免打扰及解散或者退出群组等。 |