即时通讯

最近即时通讯比较火，就先写这个吧

即时通讯（IM-instant messager）

即时通讯又叫实时通讯，简单来说就是两个及以上的人使用网络进行文字、文件、语音和视频的交流。

首先，进行网络进行通信，肯定需要网络协议，即时通讯专用的协议就是xmpp。xmpp协议要传递的消息类型是xml格式的。
http协议的实现类是socket，xmpp协议的实现类叫smack。

其次，即时通讯肯定需要服务器端（Openfire）和客户端（spark）。
Openfire,spark和smack三者的关系如下：

即时通讯发送消息的方式有四种：
- 即时在线通讯：两个人都在线
- 即时代理通讯：两个人都在线，但由于网络或其他问题消息发送不到，先将消息发送到服务器，再又服务器转发给对方
- 离线通讯：对方不在线，由服务器暂存，对方在线时再发给对方
- 其他方式：对方不在线，通过短信或邮件等方式告知对方

---

下面基于环信的三方SDK，进行一个简要的开发。

1. 在官网中获取appkey

填入应用名、描述、包名等信息获取appkey

2. 服务器端

这里对服务器端不做介绍。。。

3. 客户端：

1. 下载并导入SDK
   SDK中会有一个Demo，直接运行就能达到即时通讯的功能了，但是要将代码融入
2. 配置信息
   在清单文件AndroidManifest.xml里加入以下权限，以及写上你注册的appkey

权限配置(实际开发中可能需要更多的权限，可参考demo)：

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"package="Your Package"android:versionCode="100"android:versionName="1.0.0">    <!-- Required -->    <uses-permission android:name="android.permission.VIBRATE" />    <uses-permission android:name="android.permission.INTERNET" />    <uses-permission android:name="android.permission.RECORD_AUDIO" />    <uses-permission android:name="android.permission.CAMERA" />    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>      <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />    <uses-permission android:name="android.permission.GET_TASKS" />    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />    <uses-permission android:name="android.permission.WAKE_LOCK" />    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />    <uses-permission android:name="android.permission.READ_PHONE_STATE" />    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />    <application        android:icon="@drawable/ic_launcher"        android:label="@string/app_name"        android:name="Your Application">        <!-- 设置环信应用的appkey -->        <meta-data android:name="EASEMOB_APPKEY"  android:value="Your AppKey" />        <!-- 声明sdk所需的service SDK核心功能-->        <service android:name="com.hyphenate.chat.EMChatService" android:exported="true"/>        <!-- 声明sdk所需的receiver -->        <receiver android:name="com.hyphenate.chat.EMMonitorReceiver">            <intent-filter>                <action android:name="android.intent.action.PACKAGE_REMOVED"/>                <data android:scheme="package"/>            </intent-filter>            <!-- 可选filter -->            <intent-filter>                <action android:name="android.intent.action.BOOT_COMPLETED"/>                <action android:name="android.intent.action.USER_PRESENT" />            </intent-filter>        </receiver>    </application></manifest>

1. app打包混淆

在proguard文件中加入以下keep

-keep class com.hyphenate.** {*;}-dontwarn  com.hyphenate.**

---

发送消息

配置完成就可以发送消息了

1. 发送文本消息

//创建一条文本消息,content为消息文字内容，toChatUsername为对方用户或者群聊的id，后文皆是如此EMMessage message = EMMessage.createTxtSendMessage(content, toChatUsername);//如果是群聊，设置chattype,默认是单聊message.setChatType(ChatType.GroupChat);//发送消息EMClient.getInstance().chatManager().sendMessage(message);

2. 发送语音消息

//filePath为语音文件路径，length为录音时间(秒)EMMessage message = EMMessage.createVoiceSendMessage(filePath, length, toChatUsername);//如果是群聊，设置chattype,默认是单聊message.setChatType(ChatType.GroupChat);EMClient.getInstance().chatManager().sendMessage(message);

3. 发送视频消息

//videoPath为视频本地路径，thumbPath为视频预览图路径，videoLength为视频时间长度EMMessage message = EMMessage.createVideoSendMessage(videoPath, thumbPath, videoLength, toChatUsername);//如果是群聊，设置chattype,默认是单聊message.setChatType(ChatType.GroupChat);EMClient.getInstance().chatManager().sendMessage(message);

4. 发送图片消息

//imagePath为图片本地路径，false为不发送原图(默认超过100k的图片会压缩后发给对方),需要发送原图传falseEMMessage.createImageSendMessage(imagePath, false, toChatUsername);//如果是群聊，设置chattype,默认是单聊message.setChatType(ChatType.GroupChat);EMClient.getInstance().chatManager().sendMessage(message);

接收消息

通过注册消息监听来接收消息

EMClient.getInstance().chatManager().addMessageListener(msgListener);EMMessageListener msgListener = new EMMessageListener() {    @Override    public void onMessageReceived(List<EMMessage> messages) {        //收到消息    }    @Override    public void onCmdMessageReceived(List<EMMessage> messages) {        //收到透传消息    }    @Override    public void onMessageReadAckReceived(List<EMMessage> messages) {        //收到已读回执    }    @Override    public void onMessageDeliveryAckReceived(List<EMMessage> message) {        //收到已送达回执    }    @Override    public void onMessageChanged(EMMessage message, Object change) {        //消息状态变动    }};

记得在不需要的时候移除listener，如在activity的onDestroy()时
EMClient.getInstance().chatManager().removeMessageListener(msgListener);

环信文档地址：http://docs.easemob.com/doku.php?id=im:start