上云无忧 > 文档中心 > 环信IM即时通讯使用教程(Android) - Demo(EaseIM App)介绍
IM即时通讯
环信IM即时通讯使用教程(Android) - Demo(EaseIM App)介绍

文档简介:
环信即时通讯 IM Android 端提供示例应用可供体验。 下载 Demo (opens new window)。 输入你的手机号,获取验证码,然后输入。 选择同意《环信服务条款》与《环信隐私协议》,然后点击 登录 登录 Demo。 代码下载: 您可以通过以下两种方式获取到源代码: 下载代码压缩包:IM SDK 及 Demo 下载(opens new window) 下载源代码:github源码地址 (opens new window)欢迎大家提交 PR 改进和修复 EaseIM 和 EaseIMKit 中的问题。
*此产品及展示信息均由环信官方提供。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

环信即时通讯 IM Android 端提供示例应用可供体验。

  1. 下载 Demo (opens new window)

  2. 输入你的手机号,获取验证码,然后输入。

  3. 选择同意《环信服务条款》与《环信隐私协议》,然后点击 登录 登录 Demo。

代码下载

您可以通过以下两种方式获取到源代码:

  • 下载代码压缩包:IM SDK 及 Demo 下载(opens new window)
  • 下载源代码:github源码地址 (opens new window)欢迎大家提交 PR 改进和修复 EaseIM 和 EaseIMKit 中的问题。

导入 EaseIM

从 IM SDK 及 Demo 下载 (opens new window)下载 Android SDK 压缩包,然后解压。解压后在 examples 文件夹下,即为 EaseIM 的工程目录。

导入到 Android Studio

打开 Android Studio,点击 File→Open,打开 EaseIm3.0 根目录即可。

注意

环信(EaseIM)中使用了百度地图,在开发你自己的应用时,请在 AndroidManifest.xml 中把相应的 key 改成你自己申请的。

导入到 Eclipse

点击 File→Import→点击 Android 下的子目录→Next→选择输入 EaseIm3.0 的根路径→Finish。

用到的第三方库

  • androidx.appcompat:appcompat:appcompat 库(对应以前的 appcompat-v7 库)必须添加;
  • com.google.android.material:material:material 库(对应以前的 design 库),如果用到 TabLayout,CardView 等 material degign 控件时需要添加;
  • androidx.constraintlayout:constraintlayout:constraintlayout 布局,如果没有用到可以不用添加;
  • androidx.lifecycle:lifecycle-extensions:ViewModel 和 LiveData 库,如果没有用到可以不用添加;
  • com.android.support:multidex:工程总方法数超过 64k 时,需要用这个库做分包处理,可以删除;
  • play-services-base和firebase-messaging:谷歌推送所需要的库,如果不用该推送可以不用添加;
  • com.scwang.smartrefresh:SmartRefreshLayout:下拉刷新及上拉加载更多库,可以不用添加;
  • androidx.swiperefreshlayout:swiperefreshlayout:下拉刷新库,可以不用添加;
  • androidx.room:android 数据库,可以不用添加;
  • com.huawei.hms:push:华为推送所需要的库,如果不用该推送可以不用添加;
  • com.meizu.flyme.internet:push-internal:魅族推送所需要的库,如果不用该推送可以不用添加;
  • vivo_push_v2.3.1.jar: vivo 推送所需要的库,如果不用该推送可以不用添加;
  • oppo_push_v2.1.0jar: oppo 推送所需要的库,如果不用该推送可以不用添加;
  • mi_push_v3.6.12.jar: 小米推送所需要的库,如果不用该推送可以不用添加;
  • bolts-android-1.2.0.jar、Parse-1.9.4.jar:Demo 中的用户信息存储在 Parse,这两个库是 Parse 所需要的库,开发者如果没用 Parse 存储,不要复制到自己项目中。

主要模块介绍

  • 聊天模块 – 主要展示了如何依赖 EaseIMKit 实现聊天列表,如何扩展消息类型及如何增加扩展菜单等的逻辑。
  • 会话列表模块 – 主要展示了如何依赖 EaseIMKit 实现会话列表的逻辑及实现系统消息的具体逻辑。
  • 联系人模块 – 主要展示了如何依赖 EaseIMKit 实现联系人列表的逻辑。
  • 聊天设置模块 – 主要展示了 IM SDK 提供的对于群聊及聊天室的对成员及群组属性的操作。
  • 设置模块 – 主要展示了 IM SDK 对于新消息的设置及消息免打扰,群组等通用设置。
  • 开发者模块 – 主要展示了 IM SDK 提供的一些常规的开发者可以设置的功能。

主要类介绍

  • DemoHelper:环信(EaseIM)全局帮助类,主要功能为初始化 IM SDK,初始化 EaseIMKit 相关及注册对话类型等;
  • ConversationListFragment:继承自 EaseIMKit 中的 EaseConversationListFragment,展示了扩展条目长按事件,在列表前端添加布局及条目点击事件实现等;
  • ChatActivity及ChatFragment:ChatFragment 继承自 EaseIMKit 中的 EaseChatFragment,展示了扩展条目长按事件,预置条目长按菜单及对重写部分长按事件功能,展示了如何重置及添加更多扩展功能,并展示了实现了头像点击事件及正在输入等事件的相应;
  • ContactListFragment:继承自 EaseIMKit 中的 EaseContactListFragment,展示了添加头布局,添加条目长按功能及实现条目点击事件等;
  • GroupDetailActivity:实现了如下功能:添加群成员,修改群公告及群介绍,上传共享文件,进行群组管理,设置消息免打扰及解散或者退出群组等。

部分 UI 展示

相似文档
  • 本文介绍如何快速集成环信即时通讯 IM Android SDK 实现单聊。 注意: 最近遇到因 app 隐私问题下架的开发者需注意: 请在点击获取隐私权限以后启动环信 SDK 初始化。 EMChatService 和 EMJobService 为早期 SDK 内在应用退到后台后,对应用进行保活的程序,可以不进行注册。
  • 介绍 Android 集成相关内容。 前提条件: 开始前,请注册有效的环信即时通讯 IM 开发者账号并取得 App key,见 环信即时通讯云管理后台 (opens new window)。 集成环境: 详见 开发环境要求。
  • 静态配置 IP(域名)地址: SDK 默认指向公有云地址,在部署私有云后,需要将地址重新指向到新的地址,以下是地址修改方法: 注意: 如果需要配置 HTTPS 只需在 REST 地址前加一个前缀。
  • 版本 V4.0.1 Dev 2023-3-16(开发版): 新增特性: [IM SDK] 新增 群成员自定义属性功能并增加自定义属性更新事件实现群成员设置和获取在群组中的昵称和头像等属性。 [IM SDK] 新增 EMMessage#deliverOnlineOnly 和 EMMessage#isDeliverOnlineOnly 方法实现发消息只投递给在线用户。若开启了该功能,用户离线时消息不投递。
  • 功能描述: 环信即时通讯 IM 支持多种消息类型,开发者可以方便地对本地会话、消息进行管理,可以从服务端获取历史会话和消息,提供送达回执和已读回执能力。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部