====== 环信 UI Demo ====== ---- ===== 概述 ===== 环信提供了一系列 Demo 以帮助开发者更好的学习了解环信 SDK。所有 Demo 均已在 GitHub 上开源供开发者下载使用。你可以 clone 这些项目来学习了解环信 SDK，也可以在这些 Demo 基础上快速创建你自己的真正项目。环信 SDK（Android 版）在 GitHub 的下载地址是： https://github.com/easemob/sdkdemoapp3.0_android ===== Bug 报告跟踪 ===== 请使用以下地址来报告跟踪 bug： https://github.com/easemob/sdkexamples-android/issues ===== 快速入门（五分钟运行环信 Demo） ===== ==== 下载环信 Demo（Android） ==== 环信 UI Demo，包含了一个接近微信的完整的聊天 APP 的所有功能，包括发文字、表情、图片、语音、文件、视频、位置、群聊、登录、注册、退出登录等。 环信 UI Demo 源代码已在 GitHub 上开源供开发者下载，以帮助开发者更好的学习了解环信 SDK。 [[http://www.easemob.com/download/im|下载环信 SDK 及 Demo]] 解压缩 easemob-sdk-2.1.5.zip 后会得到以下目录结构： {{:start:200androidcleintintegration:demo_dirs1.png?nolink|SDK目录}} ==== 运行环信 Demo（Android） ==== 在手机上安装 chatdemo-ui.apk（apk 位于 androidsdk/examples/ChatDemoUI 目录下），安装成功后，运行此 APP，注册账号（用户名不能有大写字母），并登录。 {{:start:200androidcleintintegration:register1.png?nolink|注册}} {{:start:200androidcleintintegration:login1.png?nolink|登录}} 登录之后，进入通讯录点击右上角的加号，添加好友成功后，就可以互发消息了。 {{:start:200androidcleintintegration:contact_add.jpg?nolink|查看通讯录}} {{:start:200androidcleintintegration:chat.png?nolink|发送消息}} ===== 从源代码级别深入了解环信 Demo（Android） ===== 在 Eclipse/IDEA 中导入环信 Demo project。 Eclipse IDE：打开菜单 “File - import”，选择 “Existing Android Code Into Workspace”，选择解压后的 “androidsdk/examples” 目录下的 ChatDemoUI 路径，点击 “Finish”。 {{:start:200androidcleintintegration:guide1.jpg?nolink|导入环信Demo project}} 深入理解环信 Demo 背后的代码。 ==== 初始化 ==== 见 HXSDKHelper。 public synchronized boolean onInit(Context context) { appContext = this; int pid = android.os.Process.myPid(); String processAppName = getAppName(pid); // 如果APP启用了远程的service，此application:onCreate会被调用2次 // 为了防止环信SDK被初始化2次，加此判断会保证SDK被初始化1次 // 默认的APP会在以包名为默认的process name下运行，如果查到的process name不是APP的process name就立即返回 if (processAppName == null ||!processAppName.equalsIgnoreCase("com.easemob.chatuidemo")) { Log.e(TAG, "enter the service process!"); //"com.easemob.chatuidemo"为Demo的包名，换到自己项目中要改成自己包名 // 则此application::onCreate 是被service 调用的，直接返回 return false; } //初始化环信SDK Log.d("DemoApplication", "Initialize EMChat SDK"); EMChat.getInstance().init(appContext); //获取到EMChatOptions对象 EMChatOptions options = EMChatManager.getInstance().getChatOptions(); //默认添加好友时，是不需要验证的，改成需要验证 options.setAcceptInvitationAlways(false); //设置收到消息是否有新消息通知，默认为true options.setNotificationEnable(false); //设置收到消息是否有声音提示，默认为true options.setNoticeBySound(false); //设置收到消息是否震动，默认为true options.setNoticedByVibrate(false); //设置语音消息播放是否设置为扬声器播放，默认为true options.setUseSpeaker(false); } private String getAppName(int pID) { String processName = null; ActivityManager am = (ActivityManager) this .getSystemService(ACTIVITY_SERVICE); List l = am.getRunningAppProcesses(); Iterator i = l.iterator(); PackageManager pm = this.getPackageManager(); while (i.hasNext()) { ActivityManager.RunningAppProcessInfo info = (ActivityManager.RunningAppProcessInfo) (i .next()); try { if (info.pid == pID) { CharSequence c = pm.getApplicationLabel(pm .getApplicationInfo(info.processName,PackageManager.GET_META_DATA)); processName = info.processName; return processName; } } catch (Exception e) { } } return processName; } ==== 注册 ==== 见 RegisterActivity，注意用户名会自动转为小写字母（强烈建议开发者通过后台调用 REST 接口去注册环信 ID，客户端注册方法不提倡使用）。 new Thread(new Runnable() { public void run() { try { // 调用SDK注册方法 EMChatManager.getInstance().createAccountOnServer(username, pwd); } catch (final Exception e) { } } }).start(); ==== 登录 ==== 见 LoginActivity（必须在客户端调登录方法）。 //调用SDK登录方法登录聊天服务器 EMChatManager.getInstance().login(username, password, new EMCallBack() { @Override public void onSuccess() { // TODO Auto-generated method stub } @Override public void onProgress(int progress, String status) { // TODO Auto-generated method stub } @Override public void onError(int code, String message) { // TODO Auto-generated method stub } }); ==== 注册 listener ==== 接收聊天消息、回执消息、透传消息、好友同意、好友请求等监听变化：见 MainActivity.java。 注册一个接收消息的 BroadcastReceiver。 msgReceiver = new NewMessageBroadcastReceiver(); IntentFilter intentFilter = new IntentFilter(EMChatManager.getInstance().getNewMessageBroadcastAction()); intentFilter.setPriority(3); registerReceiver(msgReceiver, intentFilter); 注册一个 ack 回执消息的 BroadcastReceiver。 IntentFilter ackMessageIntentFilter = new IntentFilter(EMChatManager.getInstance().getAckMessageBroadcastAction()); ackMessageIntentFilter.setPriority(3); registerReceiver(ackMessageReceiver, ackMessageIntentFilter); 注册一个透传消息的 BroadcastReceiver（透传消息不会存入 db，可以理解为一条不存 db 的，不显示在 UI 的普通消息，或者理解成就是发送的一条指令）。 IntentFilter cmdMessageIntentFilter = new IntentFilter(EMChatManager.getInstance().getCmdMessageBroadcastAction()); cmdMessageIntentFilter.setPriority(3); registerReceiver(cmdMessageReceiver, cmdMessageIntentFilter); 注册一个好友请求同意好友请求等的 BroadcastReceiver。 IntentFilter inviteIntentFilter = new IntentFilter(EMChatManager.getInstance().getContactInviteEventBroadcastAction()); registerReceiver(contactInviteReceiver, inviteIntentFilter); 监听联系人的变化等。 EMContactManager.getInstance().setContactListener(new MyContactListener()); 注册一个监听连接状态的 listener。 EMChatManager.getInstance().addConnectionListener(new MyConnectionListener()); ==== 发送聊天消息并显示 ==== //创建一个消息（本条信息是一条文本，可以通过EMMessage.Type选择其他类型） EMMessage msg = EMMessage.createSendMessage(EMMessage.Type.TXT); //设置消息的接收方 msg.setReceipt(username); //设置消息内容。本消息类型为文本消息。 TextMessageBody body = new TextMessageBody(tvMsg.getText().toString()); msg.addBody(body); try { //发送消息 EMChatManager.getInstance().sendMessage(msg,callback); } catch (Exception e) { e.printStackTrace(); } ==== 接收聊天消息并显示 ==== private class NewMessageBroadcastReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { //消息id String msgId = intent.getStringExtra("msgid"); ...... ...... ...... //注销广播，否则在ChatActivity中会收到这个广播 abortBroadcast(); } } 消息回执 BroadcastReceiver：见 MainActivity.java。 private BroadcastReceiver ackMessageReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { //消息id String msgId = intent.getStringExtra("msgid"); ...... ...... ...... abortBroadcast(); } }; 透传消息 BroadcastReceiver：见 MainActivity.java。 private BroadcastReceiver cmdMessageReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { //消息id String msgId = intent.getStringExtra("msgid"); ...... ...... ...... abortBroadcast(); } }; 联系人变化 listener：见 MainActivity.java。 private class MyContactListener implements EMContactListener{ @Override public void onContactAdded(List usernameList) { } @Override public void onContactDeleted(List usernameList) { } } 监听连接状态和账号多处登录被迫下线：见 MainActivity.java。 private class MyConnectionListener implements EMConnectionListener { @Override public void onConnected() { } @Override public void onDisconnected(final int error) { runOnUiThread(new Runnable() { @Override public void run() { if(error == EMError.USER_REMOVED){ // 显示帐号已经被移除 }else if (error == EMError.CONNECTION_CONFLICT) { // 显示帐号在其他设备登录 } else { //"连接不到聊天服务器" } } }); } } ==== 退出登录 ==== EMChatManager.getInstance().logout();//此方法为同步方法 或者 EMChatManager.getInstance().logout(new EMCallBack(){})//此方法为异步方法 //后文中，如遇到new EMCallBack()即为new EMCallBack(){} ---- 上一页：[[start:200androidcleintintegration:115payloadmsg|Google 推送、华为推送]] 下一页：[[start:200androidcleintintegration:135easeuiuseguide|EaseUI使用指南]]