https://docs-im.easemob.com/ 2026-04-18T23:18:02+00:00 https://docs-im.easemob.com/ https://docs-im.easemob.com/lib/tpl/bootstrap3_ori/images/favicon.ico text/html 2018-12-12T07:16:46+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/10androidsdkimport?rev=1544599006&do=diff Android SDK 导入 ---------- 集成前准备 * 注册并创建应用 下载 SDK 到环信官网下载环信 SDK。 注：考虑到开发者需求不一样，在下载的 SDK 中，提供了两个不同的 jar 包： * 一个是 libs 下带实时语音功能和实时视频功能的 jar 包和 so 文件。 text/html 2018-12-12T07:18:50+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/20iosnickname?rev=1544599130&do=diff 设置当前登录用户的 iOS 推送昵称 ---------- 当 Android 手机向 iPhone 手机发消息的时候，如果 iPhone 手机不在线，则需要通过苹果的 APNS 做消息推送，这时候如果不设置昵称，就会使用默认的环信 ID 作为用户名显示在 iPhone 手机上影响用户体验，推荐使用这里提到的方法设置昵称。 text/html 2018-12-12T07:17:05+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/30androidsdkbasics?rev=1544599025&do=diff Android SDK 基础功能 ---------- SDK 中相关异步/同步处理方法介绍 * 同步方法：在调用 SDK 里面的方法时，如果方法对应的参数里面有 callback 回调，直接调用 * 异步方法：调用 SDK 的方法里面没有对应 callback 参数，则需要开发者来异步操作 text/html 2018-12-12T07:17:16+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/50singlechat?rev=1544599036&do=diff 消息 ---------- 发送消息 可以发送文本消息和表情、语音消息、图片消息、地理位置消息以及文件消息。 发送文本消息及表情 //获取到与聊天人的会话对象。参数username为聊天人的userid或者groupid，后文中的username皆是如此 EMConversation conversation = EMChatManager.getInstance().getConversation(username); //创建一条文本消息 EMMessage message = EMMessage.createSendMessage(EMMessage.Type.TXT); //如果是群聊，设置chattype,默认是单聊 message.setChatType(ChatType.GroupChat); //设置消息body TextMessageBody txtBody = new TextMessageBody(content); message.addBody(txtBody); //设置接收人 message.setReceipt(username); //把消息加… text/html 2018-12-12T07:17:28+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/60buddymgmt?rev=1544599048&do=diff 好友管理 ---------- 获取好友列表 如果使用环信的好友体系需要先设置 EMChatManager.getInstance().getChatOptions().setUseRoster(true)。 获取好友的 username list，开发者需要根据 username 去自己服务器获取好友的详情。 text/html 2018-12-12T07:17:39+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/70groupchat?rev=1544599059&do=diff 群组管理 ---------- 发送消息 发送文字、语音、图片、位置消息。收发消息及聊天记录相关等。 这部分与单聊是一样的，详情见单聊。 新建群组 创建私有群 私有群，不能被搜索到，只能通过群主加人进群，或者设置了 allowInvite 为 true，即允许群成员邀请，那么群成员也可以邀请群外面的人进入群聊，此种群群成员可以邀请，不能踢人，类似微信群。 text/html 2018-12-12T07:17:51+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/75chatroom?rev=1544599071&do=diff 聊天室 ---------- 环信聊天室模型支持最大成员数为5000，和群组不同，聊天室内成员离线后，服务器当监听到此成员不在线后不在会给此成员再发推送。 * 支持最大成员5000； * 环信的聊天室内仅有 owner 和游客； text/html 2018-12-12T07:18:04+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/90realtimeaudio?rev=1544599084&do=diff 实时通话 ---------- 实时通话分为视频通话和音频通话，与普通电话不同，它是基于网络的。 注：音视频通话功能最低支持android版本4.0+（14+） 实时通话的数据流量 实时语音和实时视频的数据流量如下： text/html 2018-12-12T07:19:03+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/115payloadmsg?rev=1544599143&do=diff GCM、华为推送 ---------- Google GCM集成 必备条件 * GCM 使用针对于国外用户； * GCM 要求设备安装有 Google Play 服务和 Google Play 商店。 设置环信 Android 推送证书 第 1 步：登录 Google 开发平台，Create a project…，创建你的应用名称，应用 ID（ID 系统会随机为你分配一个唯一的值，也可以手动填写）。 text/html 2018-12-12T07:20:24+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/120androidsdkjavadoc?rev=1544599224&do=diff Android SDK API Doc ---------- Android SDK API Doc ---------- 上一页：常见错误 下一页：Android SDK 更新日志 text/html 2018-12-12T07:19:57+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/135easeuiuseguide?rev=1544599197&do=diff EaseUI 使用指南 ---------- 简介 EaseUI 是一个 UI 库，封装了 IM 功能常用的控件、fragment 等等，旨在帮助开发者快速集成环信 SDK。 EaseUI 及 Demo 的 GitHub 下载地址为： * <https://github.com/easemob/easeui>； * <https://github.com/easemob/sdkdemoapp3.0_android>。 注意：因为这是一个 UI 库，后续很可能还会继续改动，新旧版本在 text/html 2018-12-12T07:19:45+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/140hxuidemo?rev=1544599185&do=diff 环信 UI Demo ---------- 概述 环信提供了一系列 Demo 以帮助开发者更好的学习了解环信 SDK。所有 Demo 均已在 GitHub 上开源供开发者下载使用。你可以 clone 这些项目来学习了解环信 SDK，也可以在这些 Demo 基础上快速创建你自己的真正项目。环信 SDK（Android 版）在 GitHub 的下载地址是： text/html 2018-12-12T07:20:12+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/150androidfaq?rev=1544599212&do=diff 常见错误 ---------- 前期 SDK 初始化工作 Q：环信的 AppKey 可以写到代码里面吗？ A：不可以，必须写在 AndroidManifest.xml 中，因为在 SDK 中取 AppKey 是指定到 AndroidManifest.xml 的。 Q：SDK 的初始化可以不写在 application 里面吗？ text/html 2022-03-01T07:31:16+00:00 https://docs-im.easemob.com/start/200androidcleintintegration/160androidreleasenote?rev=1646119876&do=diff Android SDK 更新日志 ---------- 版本：V2.3.4 R2 2017-2-10 修复R1版本使用华为推送报错的问题 版本：V2.3.4 2017-1-12 新功能/改进： * 增加修改群描述方法 EMGroupManager::changeGroupDescription()； * EMChat::setServerAddress() 方法支持设置 https 地址；