5分钟集成即时通讯功能——环信Android版

下载环信demo (Android)

什么是环信demo

环信demo展示了怎样使用环信SDK快速创建一个完整的类微信聊天APP。展示的功能包括：环信SDK初始化，登录，登出，注册消息接收listener, 发送消息。

环信demo源代码已在github上开源供开发者下载，以帮助开发者更好的学习了解环信SDK。

下载环信sdk及demo

1. 到环信官网下载

2. 解压缩easemob-sdk-2.0.0.zip后会得到以下目录结构：

运行环信demo (Android)

Non-UI demo，此demo非常简单，登陆进去后进一个很简单的聊天页面

在手机上安装chatdemo-nonui.apk(apk位于androidsdk/examples/ChatDemoNonUI根目录下),安装成功后，运行chatdemo-nonui:点击生成账号按钮，系统将会为你自动创建一个临时账号

点击登陆按钮，进入应用中，点击“发送文本消息”，会发送消息给测试机器人（其账号为”bot”）。该测试机器人接收到消息后会把接收的消息原封不动的自动发送回来

从源代码级别深入了解环信demo (Android)

在Eclipse/IDEA中创建环信demo project

Eclipse IDE： 打开菜单“ File - New - Project“，选择”Android Project from Existing Code”， 选择解压后的”androidsdk/examples”目录下的ChatDemoNonUI路径,点击“Finish”。

深入理解环信demo背后的代码

初始化：见DemoApplication.java

public class DemoApplication extends Application {

    public static Context appContext;
    @Override
    public void onCreate() { 
       super.onCreate();
       appContext = this;
 
       //初始化环信SDK
       Log.d("DemoApplication", "Initialize EMChat SDK");
       EMChat.getInstance().init(appContext);
    }
}

注册：见LoginActivity.java

// 注册临时账号  缺省密码： 123456
register.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View v) {
      account.setText(getAccount());
      pwd.setText("123456");
      CreateAccountTask task = new CreateAccountTask();
      task.execute(account.getText().toString(), "123456", "chatdemo");
    }
});

private class CreateAccountTask extends AsyncTask<String, Void, String> {
    protected String doInBackground(String... args) {
      String userid = args[0];
      String pwd = args[1];
      String channel = args[2];
      try {
        //channel即为APPKEY
        EMChatManager.getInstance().createAccountOnServer(userid, pwd, channel);
      } catch (Exception e) {
        e.printStackTrace();
      }
      
      return userid;
    }
}

登陆：见LoginActivity.java

@Override
protected void onResume() {
    super.onResume();
    //登陆到聊天服务器,此处使用注册的临时账号作为登陆账号
    EMChatManager.getInstance().login(username, password, new EMCallBack() {

        @Override
        public void onError(int arg0, final String errorMsg) {
            runOnUiThread(new Runnable() {
                public void run() {
                    Toast.makeText(MainActivity.this, "登录聊天服务器失败：" + errorMsg, Toast.LENGTH_SHORT).show();
                }
            });
        }

        @Override
        public void onProgress(int arg0, String arg1) {
        }

        @Override
        public void onSuccess() {
            runOnUiThread(new Runnable() {
                public void run() {
                    Toast.makeText(MainActivity.this, "登录聊天服务器成功", Toast.LENGTH_SHORT).show();
                }
            });
            
        }
    });
}

注册listener,以接收聊天消息：见MainActivity.java

@Override
protected void onCreate(Bundle savedInstanceState) {

    //注册message receiver， 接收聊天消息
    msgReceiver = new NewMessageBroadcastReceiver();
    IntentFilter intentFilter = new IntentFilter(EMChatManager.getInstance().getNewMessageBroadcastAction());
    registerReceiver(msgReceiver, intentFilter);
}

发送消息：见MainActivity.java

//本demo是发送消息给测试机器人（其账号为"bot"）。该测试机器人接收到消息后会把接收的消息原封不动的自动发送回来
public void onSendTxtMsg(View view) {
    try {
        //创建一个消息
        EMMessage msg = EMMessage.createSendMessage(EMMessage.Type.TXT);
        //设置消息的接收方
        msg.setReceipt("bot");
        //设置消息内容。本消息类型为文本消息。
        TextMessageBody body = new TextMessageBody(tvMsg.getText().toString());
        msg.addBody(body);
    
        //发送消息
        EMChatManager.getInstance().sendMessage(msg);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

接收聊天消息并显示：见MainActivity.java

private class NewMessageBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        //消息id
        String msgId = intent.getStringExtra("msgid");
        
        //从SDK 根据消息ID 可以获得消息对象
        EMMessage message = EMChatManager.getInstance().getMessage(msgId);

        Log.d("main","new message id:" + msgId + " from:" + message.getFrom() + " type:" + message.getType() + " body:" + message.getBody());
        switch (message.getType()) {
          case TXT:
            TextMessageBody txtBody = (TextMessageBody) message.getBody();
            tvReceivedMsg.append("text message from:" + message.getFrom() + " text:" + txtBody.getMessage() + " \n\r");
            break;
          case IMAGE:
            ImageMessageBody imgBody = (ImageMessageBody) message.getBody();
            tvReceivedMsg.append("img message from:" + message.getFrom() + " thumbnail:" + imgBody.getThumbnailUrl() + " remoteurl:"
                + imgBody.getRemoteUrl() + " \n\r");
            break;
          case VOICE:
            VoiceMessageBody voiceBody = (VoiceMessageBody) message.getBody();
            tvReceivedMsg.append("voice message from:" + message.getFrom() + " length:" + voiceBody.getLength() + " remoteurl:"
                + voiceBody.getRemoteUrl() + " \n\r");
            break;
          case LOCATION:
            LocationMessageBody locationBody = (LocationMessageBody) message.getBody();
            tvReceivedMsg.append("location message from:" + message.getFrom() + " address:" + locationBody.getAddress() + " \n\r");
            break;
        }
}

退出登陆：见MainActivity.java

@Override
protected void onPause() {
    super.onPause();
    
    //登出聊天服务器
    EMChatManager.getInstance().logout();
}

环信demo源代码git地址

环信提供了一系列demo以帮助开发者更好的学习了解环信SDK。所有demo均已在github上开源供开发者下载使用。你可以clone这些项目来学习了解环信SDK，也可以在这些demo基础上快速创建你自己的真正项目。环信SDK（Android版）在github的下载地址是：

https://github.com/easemob/sdkexamples-android

Bug报告跟踪

请使用以下地址来报告跟踪bug：

https://github.com/easemob/sdkexamples-android/issues