https://docs-im.easemob.com/ 2026-04-14T23:52:01+00:00 https://docs-im.easemob.com/ https://docs-im.easemob.com/lib/tpl/bootstrap3_ori/images/favicon.ico text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.1.5apichange?rev=1536141300&do=diff 3.1.5api修改 Android 3.1.5 api修改如下，-代表原来api，+代表修改后的api EMGroupChangeListener - void onInvitationAccpted(String groupId, String invitee, String reason); + void onInvitationAccepted(String groupId, String invitee, String reason); - void onGroupDestroy(String groupId, String groupName); + void onGroupDestroyed(String groupId, String groupName); text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.2.3apichange?rev=1536141300&do=diff 3.2.3api修改 -代表原来api，+代表修改后的api。 @Deprecated代表已过时的api，后面会带着替代的api EMChatRoomChangeListener.java - void onMemberKicked(String roomId, String roomName, String participant); + void onRemovedFromChatRoom(String roomId, String roomName, String participant); text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.3.0apichange?rev=1536141300&do=diff -代表原来api，+代表修改后的api。 @Deprecated代表已过时的api，后面会带着替代的api EMGroupManager + public EMCursorResult<String> fetchGroupMembers(String groupId, String cursor, int pageSize) throws HyphenateException + public void asyncFetchGroupMembers(final String groupId, final String cursor, final int pageSize, final EMValueCallBack<EMCursorResult<String>> callback)； + public EMGroup changeOwner(String groupId, String newOwner) throws HyphenateException + public void asyncChangeOwner(final String groupId, fin… text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.3.3apichange?rev=1536141300&do=diff 3.3.3接口变化列表 -代表原来api，+代表修改后的api。 @Deprecated代表已过时的api，后面会带着替代的api 新增加接口EMClientListener EMClientListener: + void onMigrate2x(boolean success); 新增加接口EMMultiDeviceListener text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.3.4apichange?rev=1536141300&do=diff 3.3.4接口变化列表 -代表原来api，+代表修改后的api。 @Deprecated代表已过时的api，后面会带着替代的api 新增加接口EMChatManager EMChatManager: + public void recallMessage(EMMessage message); + public void aysncRecallMessage(final EMMessage message, + final EMCallBack callback); + public EMCursorResult<EMMessage> fetchHistoryMessages(String conversationId, EMConversationType type, int pageSize, + String startMsgId); + public void asyncFetchHistoryMessage… text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/3.3.6apichange?rev=1536141300&do=diff 3.3.6接口变化列表 -代表原来api，+代表修改后的api。 @Deprecated代表已过时的api，后面会带着替代的api 新增加接口EMOptions EMOptions: + public void setAutoTransferMessageAttachments(boolean transfer); + public boolean getAutoTransferMessageAttachments(); + public void setAutoDownloadThumbnail(boolean autodownload); + public boolean getAutodownloadThumbnail(); text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/10androidsdkimport?rev=1536141300&do=diff Android SDK 介绍及导入 ---------- Android SDK 介绍 环信 SDK 为用户开发 IM 相关的应用提供的一套完善的开发框架。包括以下几个部分： [开发框架] * SDK_Core 为核心的消息同步协议实现，完成与服务器之间的信息交换。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/30androidsdkbasics?rev=1536141300&do=diff Android SDK 基础功能 ---------- SDK 中相关异步/同步处理方法介绍 * 同步方法：SDK 里大部分方法都为同步方法，即这个方法执行完毕，才会走后面的代码。 * 异步方法：带有 callback 以及 API 注释里明确写明异步方法的方法，即不需要等这个方法走完，后边的代码就已经在执行了，通过 callback 得到方法执行的结果。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/60buddymgmt?rev=1536141300&do=diff 好友管理 ---------- 获取好友列表 获取好友的 username list，开发者需要根据 username 去自己服务器获取好友的详情。 List<String> usernames = EMClient.getInstance().contactManager().getAllContactsFromServer(); 查找好友 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/70groupchat?rev=1536141300&do=diff 群组管理 许多群组操作前需要鉴别权限，包括当前用户是否在群里面，是否拥有管理员或者所有者权限。 建议用户登录成功后，调用EMClient.getInstance().groupManager().getJoinedGroupsFromServer(); 刷新本地群组列表，确保鉴别权限正常工作。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/73privatecloud?rev=1536141300&do=diff 私有云SDK集成配置 ---------- 静态配置ip（域名）地址 SDK 默认指向公有云地址，在部署私有云后，需要将地址重新指向到新的地址，以下是地址修改方法： EMOptions emOptions = new EMOptions();//实例化EMOptions对象 emOptions.setRestServer("10.10.10.10:00");//设置私有云rest地址（ip/域名：port） emOptions.setIMServer("10.10.10.10");//设置私有云IM地址 emOptions.setImPort(00);//设置私有云IM端口号 emOptions.enableDNSConfig(false);//默认是true，在私有云下，需要关闭（设置成false） EMClient.getInstance().init(context,emOptions);//最后初始化SDK… text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/75chatroom?rev=1536141300&do=diff 聊天室管理 ---------- 环信聊天室模型支持最大成员数为5000，和群组不同，聊天室内成员离线后，服务器当监听到此成员不在线后不再会给此成员再发推送。 * 支持最大成员5000； * 环信的聊天室内有所有者，管理员和游客三种身份； text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/80audiovideo?rev=1536141300&do=diff 实时通话 ---------- 实时通话分为视频通话和音频通话，与普通电话不同，它是基于网络的。 实时通话的数据流量 实时语音和实时视频的数据流量如下： * 实时语音：双向 170k bytes/minute text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/85multiuserconference?rev=1536141300&do=diff 多人音视频会议功能 ---------- 产品简介 为满足不同场景需求，3.5.0版本开始将实时音视频会议划分了不同的类型，不同类型对应了不同场景，使你能够轻松地将实时音视频功能集成到你的应用或者网站中。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/90multidevices?rev=1536141300&do=diff 多设备 ---------- 其他端登录的设备ID 当PC端和手机端登录同一个账号时，在手机端可以通过特定方法获取到PC端的设备ID，该设备ID相当于特殊的好友Username，可以直接使用于聊天，使用方法与好友类似。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/95multidevices?rev=1536141300&do=diff 私有云集成配置 ---------- 配置IP SDK 默认指向公有云地址，在部署私有云后，需要将地址重新指向到新的地址，以下是地址修改方法： EMOptions emOptions = new EMOptions();//实例化EMOptions对象 emOptions.setRestServer("10.10.10.10:00");//设置私有云rest地址（ip：port） emOptions.setIMServer("10.10.10.10");//设置私有云IM地址 emOptions.setImPort(00);//设置私有云IM端口号 emOptions.enableDNSConfig(false);//默认是true，在私有云下，需要关闭（设置成false） EMClient.getInstance().init(context,emOptions);//最后初始化SDK… text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/95privatecloud?rev=1536141300&do=diff 私有云SDK集成配置 ---------- 静态配置ip（域名）地址 SDK 默认指向公有云地址，在部署私有云后，需要将地址重新指向到新的地址，以下是地址修改方法： EMOptions emOptions = new EMOptions();//实例化EMOptions对象 emOptions.setRestServer("10.10.10.10:00");//设置私有云rest地址（ip/域名：port） emOptions.setIMServer("10.10.10.10");//设置私有云IM地址 emOptions.setImPort(00);//设置私有云IM端口号 emOptions.enableDNSConfig(false);//默认是true，在私有云下，需要关闭（设置成false） EMClient.getInstance().init(context,emOptions);//最后初始化SDK… text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/100iosnickname?rev=1536141300&do=diff 设置当前登录用户的推送昵称 ---------- 注意：如果集成了 GCM等第三方推送，昵称的设置也适用于此类推送消息。 当 Android 手机向 iPhone 手机发消息的时候，如果 iPhone 手机不在线，则需要通过苹果的 APNS 做消息推送，这时候如果不设置昵称，就会使用默认的环信 ID 作为用户名显示在 iPhone 手机上影响用户体验，推荐使用这里提到的方法设置昵称。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/110thirdpartypush?rev=1536141300&do=diff 第三方推送集成 ---------- 说明 当app在后台运行时环信IM SDK默认通过一个后台服务保持一条连接环信服务器的长连接,但Android为了解决系统待机性能差的问题,随着Android版本的升级逐渐禁止了app级别的后台服务的运行.所以在一些版本比较高的Android系统上会有接收不到消息的情况.为了提高消息的到达率,我们SDK增加了对第三方推送服务的支持,包括小米推送,华为推送,Google FCM推送. text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/115thirdpartypush?rev=1536141300&do=diff 第三方推送集成 ---------- 华为HMS推送集成 创建华为应用 首先就是去华为开发者后台创建应用，并开启 push 服务，并上传对应的证书指纹，具体可以看下华为官方介绍： 华为HMS消息推送服务集成 上传推送证书 注册完整后，需要在 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/120androidsdkjavadoc?rev=1536141300&do=diff Android SDK API Doc ---------- * 环信 Android SDK 2.X API Doc * 环信 Android SDK 3.X API Doc ---------- 上一页：EaseUI使用指南 下一页：SDK 2.x至3.0升级指南 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/125fcmupgrade?rev=1536141300&do=diff FCM推送升级 ---------- 说明 * Google官方推出了GCM的升级版通知工具FCM（Firebase Cloud Messaging），并强烈建议开发者使用FCM。 * 新注册项目已不能使用GCM推送服务，所以新项目只能使用FCM推送功能。 * Google官方称会继续维护GCM推送，所以SDK中仍然保留GCM推送功能，之前使用GCM推送的项目可以继续使用GCM推送。GCM相关配置详见 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/140upgradetov30?rev=1536141300&do=diff SDK 2.x 至 3.x 升级指南 ---------- API 大致变动介绍 3.0 中的核心类为 EMClient 类，通过 emclient 类可以获取到 chatmanager、groupmanager、contactmanager、chatroommanager 等 manager 对象，此外和这些 manager 不太相关的方法基本 EMClient 类里面，如登录、设置连接监听等方法。message 里的成员变量的获取都变成 getXXX 获取。 text/html 2018-09-05T09:55:00+00:00 https://docs-im.easemob.com/im/200androidclientintegration/160androidreleasenote?rev=1536141300&do=diff Android SDK 更新日志 ---------- 版本 V3.5.0 2018-08-13 新功能： * 为满足不同场景需求，3.5.0版本开始将实时音视频会议划分了不同的类型，不同类型对应了不同场景，使你能够轻松地将实时音视频功能集成到你的应用或者网站中。类型如下：